0 运行GitHub上的XUI的源代码

下载GitHub上的XUI源码并解压缩到当前文件夹后，用Android Studio打开该项目，开始了一系列的运作，后来报错，不用管它，关闭AS，重新打开，大部分都是因为网络问题导致有些包没有下好，重复两次就好了。

不过出现了下面的报警信息时：

[TAG] Failed to resolve variable '${junit.version}' [TAG] Failed to resolve variable '${animal.sniffer.version}' 

解决办法如下：

1. 首先：File—-> Invalidate Caches/ Restart —->点击Invalidate Caches/ Restart 重启Android Studio
2. 然后：Build—->Clean Project
3. 最后：安装到手机上

解决后，安装到手机上，体验一下这个功能丰富的Demo。

下面开始从这个Demo中获取需要的内容。

1 新建项目与添加依赖

1.1 新建项目（空项目）

New project ——> Empty Activity ——> 起名XUITest，编程语言java ——> finish。

1.2 添加Gradle依赖

1.2.1 根目录的 build.gradle 的 repositories

将左侧从默认的Android目录改为Project目录，在项目根目录的build.gradle的repositories中添加:

allprojects {      repositories { ...         maven { url "https://jitpack.io" } } } 

修改完成后，根目录的build.gradle的repositories完整内容如下：

// Top-level build file where you can add configuration options common to all sub-projects/modules.  buildscript {     repositories { google() jcenter() }     dependencies {         classpath 'com.android.tools.build:gradle:3.5.2' // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files } }  allprojects {     repositories { google() jcenter()         maven { url "https://jitpack.io" } //只添加了这么一句 } }  task clean(type: Delete) {     delete rootProject.buildDir } 

1.2.2 app中的 build.gradle 的 dependencies

打开app中的build.gradle在dependencies添加:

dependencies { ... //androidx项目   implementation 'com.github.xuexiangjys:XUI:1.1.3'    implementation 'androidx.appcompat:appcompat:1.1.0'   implementation 'androidx.recyclerview:recyclerview:1.1.0'   implementation 'com.google.android.material:material:1.1.0-beta01'   implementation 'com.github.bumptech.glide:glide:4.11.0' } 

【注意】如果你的项目目前还未使用androidx，请使用如下配置：

dependencies { ... //support项目   implementation 'com.github.xuexiangjys:XUI:1.0.9-support'    implementation 'com.android.support:appcompat-v7:28.0.0'   implementation 'com.android.support:recyclerview-v7:28.0.0'   implementation 'com.android.support:design:28.0.0'   implementation 'com.github.bumptech.glide:glide:4.8.0' } 

判断是否使用了androidx的方法如下：
如果原来的dependencies中带着类似androidx.的东西，就说明用的是androidx

androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0' 

搞定后，app中的 build.gradle完整的版本：

apply plugin: 'com.android.application'  android {     compileSdkVersion 29     buildToolsVersion "29.0.3"     defaultConfig {         applicationId "com.example.xuitest"         minSdkVersion 17         targetSdkVersion 29         versionCode 1         versionName "1.0"         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" }     buildTypes {         release {             minifyEnabled false             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } }  dependencies {     implementation fileTree(dir: 'libs', include: ['*.jar'])     implementation 'androidx.appcompat:appcompat:1.1.0'     implementation 'androidx.constraintlayout:constraintlayout:1.1.3'     testImplementation 'junit:junit:4.12'     androidTestImplementation 'androidx.test.ext:junit:1.1.1'     androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0' //androidx项目     implementation 'com.github.xuexiangjys:XUI:1.1.3' //implementation 'androidx.appcompat:appcompat:1.1.0'   与上面重复了     implementation 'androidx.recyclerview:recyclerview:1.1.0'     implementation 'com.google.android.material:material:1.1.0-beta01'     implementation 'com.github.bumptech.glide:glide:4.11.0' } 

1.2.3 报错与解决

报错信息：
ERROR: Manifest merger failed : uses-sdk:minSdkVersion 15 cannot be smaller than version 17 declared in library
解决：
将当前项目的所支持的最小SDK版本改为17即可。具体做法为：打开app中的build.gradle，将里面的minSdkVersion 15改成minSdkVersion 17。

2 初始化XUI设置

2.1 在Application最顶部初始化设置（必须）

左侧目录切换回Android目录，在app下的新建一个java类，如下图所示：

建好后，MyApp.java内容如下：

package com.example.xuitest; import android.app.Application; public class MyApp extends Application { } 

定义一个onCreate方法，进行如下初始化：

XUI.init(this); //初始化UI框架 XUI.debug(true); //开启UI框架调试日志 

完成后，整个MyApp.java内容如下：

package com.example.xuitest; import android.app.Application; import com.xuexiang.xui.XUI; public class MyApp extends Application { @Override public void onCreate() { super.onCreate();         XUI.init(this); //初始化UI框架         XUI.debug(true); //开启UI框架调试日志 } } 

然后，需要去manifest文件夹下的AndroidManifestx.xml中添加配置：

android:name=".MyApp" 

完成后，整个AndroidManifestx.xml配置文件：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.xuitest"> <application         android:name=".MyApp"         android:allowBackup="true"         android:icon="@mipmap/ic_launcher"         android:label="@string/app_name"         android:roundIcon="@mipmap/ic_launcher_round"         android:supportsRtl="true"         android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest> 

2.2 调整应用的基础主题（必须）

必须设置应用的基础主题，否则组件将无法正常使用！必须保证所有用到XUI组件的窗口的主题都为XUITheme的子类，这非常重要！！！

基础主题类型：

大平板(10英寸, 240dpi, 1920*1200）：XUITheme.Tablet.Big  小平板(7英寸, 320dpi, 1920*1200）：XUITheme.Tablet.Small  手机（4.5英寸, 320dpi, 720*1280）：XUITheme.Phone 

从这个AndroidManifestx.xml的下述位置找到styles.xml，并将主题替换成想要的主题：


替换完成后，将里面的那些零碎删除，完成后整个styles.xml内容为：

<resources> <!-- Base application theme. --> <style name="AppTheme" parent="XUITheme.Phone"> </style> </resources> 

当然也可以在Activity刚开始时调用如下代码动态设置主题（此处暂时不管）：

@Override protected void onCreate(Bundle savedInstanceState) {     XUI.initTheme(this); super.onCreate(savedInstanceState); ... } 

2.3 调整字体库（对字体无要求的可省略）

（步骤1）设置你需要修改的字体库路径（assets下）

//设置默认字体为华文行楷，这里写你的字体库 XUI.getInstance().initFontStyle("fonts/hwxk.ttf"); 

（步骤2）在项目的基础Activity中加入如下代码注入字体

@Override protected void attachBaseContext(Context newBase) { //注入字体 super.attachBaseContext(CalligraphyContextWrapper.wrap(newBase)); } 

2.4 混淆配置

-keep class com.xuexiang.xui.widget.edittext.materialedittext.** { *; } 

3 写个按钮实现一些弹窗功能

最终功能如下，一个按钮，按了弹出提示弹窗：

为了实现上述简单功能，所有需要修改的内容，以及修改后的结果如下。

（1）activity_main.xml中内容：

<?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="https://schemas.android.com/apk/res/android"     xmlns:app="https://schemas.android.com/apk/res-auto"     xmlns:tools="https://schemas.android.com/tools"     android:layout_width="match_parent"     android:layout_height="match_parent"     tools:context=".MainActivity"> <Button         android:id="@+id/btn_test"         style="@style/Button.Blue"         android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:text="弹窗"         app:layout_constraintBottom_toBottomOf="parent"         app:layout_constraintLeft_toLeftOf="parent"         app:layout_constraintRight_toRightOf="parent"         app:layout_constraintTop_toTopOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout> 

（2）MainActivity.java中内容：

package com.example.xuitest; import androidx.appcompat.app.AppCompatActivity; import android.os.Bundle; import android.view.View; import com.xuexiang.xui.widget.dialog.materialdialog.MaterialDialog; public class MainActivity extends AppCompatActivity implements View.OnClickListener{ @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); findViewById(R.id.btn_test).setOnClickListener(this); } @Override public void onClick(View v) { new MaterialDialog.Builder(this) .iconRes(R.drawable.icon_tip) .title(R.string.tip_infos) .content(R.string.content_simple_confirm_dialog) .positiveText(R.string.lab_submit) .show(); } } 

（3）需要拷贝icon_tip.png图片到drawable文件夹：

（4）需要在app/res/values/string.xml添加内容，完成后，完整的文件如下：

<resources> <string name="app_name">XUITest</string> <!--MaterialDialog--> <string name="tip_bluetooth_permission">是否允许打开蓝牙？</string> <string name="lab_yes">是</string> <string name="lab_no">否</string> <string name="tip_infos">提示</string> <string name="content_simple_confirm_dialog">请注意，这是一个简单的提示性对话框！</string> <string name="lab_submit">确定</string> <string name="tip_warning">警告</string> <string name="content_warning">当前为开发环境，是否切换到真实环境？</string> <string name="lab_change">切换</string> <string name="lab_continue">继续</string> <string name="hint_please_input_password">请输入密码</string> <string name="tip_options">选项</string> <string name="tip_router_setting">路线设置</string> <string name="lab_choice">选择</string> <string name="tip_update">版本更新</string> <string name="content_downloading">正在下载中，请稍后...</string> <string name="tip_download_finished">下载完毕!</string> <string name="lab_cancel">取消</string> <string name="content_wait_for_receive_data">数据接收中，请稍后...</string> <string name="lab_edit">编辑</string> <string name="lab_add">添加</string> <string name="lab_delete">删除</string> <string name="lab_update">更新</string> <string name="tip_please_select_transfer_type">选择一种切换方式</string> <string name="tip_signature">签名</string> <string name="lab_clear">清除</string> <string name="tip_loading_message">正在加载数据...</string> <string name="tip_start">开始</string> <string name="tip_stop">停止</string> </resources> 

参考大佬的链接都在这了：
GitHub：XUI源码
Bilibili：XUI基础入门
Bilibili：在项目中使用XUI
Bilibili：使用模板工程