在决定使用XUI前,你必须明确的一点是,此框架给出的是一整套UI的整体解决方案,如果你只是想使用其中的几个控件,那大可不必引入如此庞大的一个UI库,Github上会有更好的组件库。如果你是想拥有一套可以定制的、统一的UI整体解决方案的话,那么你就继续往下看吧!
添加Gradle依赖
1.先在项目根目录的 build.gradle 的 repositories 添加:
1. allprojects {
2. repositories {
3. ...
4. maven { url "https://jitpack.io" }
5. }
6. }
2.然后在dependencies添加:
1. dependencies {
2. ...
3. //androidx项目
4. implementation 'com.github.xuexiangjys:XUI:1.0.9'
6. implementation 'androidx.appcompat:appcompat:1.1.0'
7. implementation 'androidx.recyclerview:recyclerview:1.0.0'
8. implementation 'com.google.android.material:material:1.1.0-alpha10'
9. implementation 'com.github.bumptech.glide:glide:4.8.0'
10. }
【注意】如果你的项目目前还未使用androidx,请使用如下配置:
1. dependencies {
2. ...
3. //support项目
4. implementation 'com.github.xuexiangjys:XUI:1.0.9-support'
6. implementation 'com.android.support:appcompat-v7:28.0.0'
7. implementation 'com.android.support:recyclerview-v7:28.0.0'
8. implementation 'com.android.support:design:28.0.0'
9. implementation 'com.github.bumptech.glide:glide:4.8.0'
10. }
初始化XUI设置
1.在Application最顶部初始化设置(必须)
1. XUI.init(this); //初始化UI框架
2. XUI.debug(true); //开启UI框架调试日志
2.调整应用的基础主题(必须)
必须设置应用的基础主题,否则组件将无法正常使用!必须保证所有用到XUI组件的窗口的主题都为XUITheme的子类,这非常重要!!!
基础主题类型:
- 大平板(10英寸, 240dpi, 1920*1200):XUITheme.Tablet.Big
- 小平板(7英寸, 320dpi, 1920*1200):XUITheme.Tablet.Small
- 手机(4.5英寸, 320dpi, 720*1280):XUITheme.Phone
1. <style name="AppTheme" parent="XUITheme.Phone">
2. <!-- 自定义自己的主题样式 -->
3. <item name="colorPrimary">@color/colorPrimary</item>
4. <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
5. <item name="colorAccent">@color/colorAccent</item>
6. </style>
当然也可以在Activity刚开始时调用如下代码动态设置主题
1. @Override
2. protected void onCreate(Bundle savedInstanceState) {
3. XUI.initTheme(this);
4. super.onCreate(savedInstanceState);
5. ...
6. }
3.调整字体库(对字体无要求的可省略)
(1)设置你需要修改的字体库路径(assets下)
1. //设置默认字体为华文行楷,这里写你的字体库
2. XUI.getInstance().initFontStyle("fonts/hwxk.ttf");
(2)在项目的基础Activity中加入如下代码注入字体.
1. @Override
2. protected void attachBaseContext(Context newBase) {
3. //注入字体
4. super.attachBaseContext(CalligraphyContextWrapper.wrap(newBase));
5. }
混淆配置
由于没有使用任何反射,无需代码混淆

