XUI是一個簡潔而又優(yōu)雅的Android原生UI框架，解放你的雙手!

XUI包含了涵蓋絕大部分的UI組件：TextView、Button、EditText、ImageView、Spinner、Picker、Dialog、PopupWindow、ProgressBar、LoadingView、StateLayout、FlowLayout、Switch、Actionbar、TabBar、Banner、GuideView、BadgeView、MarqueeView、WebView、SearchView等一系列的組件和豐富多彩的樣式主題。

特征

1、簡潔優(yōu)雅，盡可能少得引用資源文件的數量，項目庫整體大小不足1M(打包后大約644k)。

2、組件豐富，提供了絕大多數我們在開發(fā)者常用的功能組件。

3、使用簡單，為方便快速開發(fā)，提高開發(fā)效率，對api進行了優(yōu)化，提供一鍵式接入。

4、樣式統(tǒng)一，框架提供了一系列統(tǒng)一的樣式，使UI整體看上去美觀和諧。

5、兼容性高，框架還提供了3種不同尺寸設備的樣式(4.5英寸、7英寸和10英寸)，并且最低兼容到Android 17, 讓UI兼容性更強。

6、擴展性強，各組件提供了豐富的屬性和樣式API，可以通過設置不同的樣式屬性，構建不同風格的UI。

如何使用

在決定使用XUI前，你必須明確的一點是，此框架給出的是一整套UI的整體解決方案，如果你只是想使用其中的幾個控件，那大可不必引入如此龐大的一個UI庫，Github上會有更好的組件庫。如果你是想擁有一套可以定制的、統(tǒng)一的UI整體解決方案的話，那么你就繼續(xù)往下看吧!

添加Gradle依賴

1.先在項目根目錄的 build.gradle 的 repositories 添加:

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

2.然后在應用項目(一般是app)的 build.gradle 的 dependencies 添加:

dependencies {
...
//androidx項目
implementation 'com.github.xuexiangjys:XUI:1.2.0'

implementation 'androidx.appcompat:appcompat:1.3.1'
implementation 'androidx.recyclerview:recyclerview:1.2.1'
implementation 'com.google.android.material:material:1.4.0'
implementation 'com.github.bumptech.glide:glide:4.12.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'
}

初始化XUI設置

1.調整應用的基礎主題(必須)

必須設置應用的基礎主題，否則組件將無法正常使用!必須保證所有用到XUI組件的窗口的主題都為XUITheme的子類，這非常重要!!!

基礎主題類型：

大平板(10英寸, 240dpi, 1920*1200)：XUITheme.Tablet.Big

小平板(7英寸, 320dpi, 1920*1200)：XUITheme.Tablet.Small

手機(4.5英寸, 320dpi, 720*1280)：XUITheme.Phone

<style name="AppTheme" parent="XUITheme.Phone">
<!-- 自定義自己的主題樣式 -->?
<item name="colorPrimary">@color/colorPrimary</item>
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="colorAccent">@color/colorAccent</item>
</style>

當然也可以在Activity剛開始時調用如下代碼動態(tài)設置主題

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

2.調整字體庫(對字體無要求的可省略)

(1)設置你需要修改的字體庫路徑(assets下)

//設置默認字體為華文行楷，這里寫你的字體庫
XUI.getInstance().initFontStyle("fonts/hwxk.ttf");

(2)在項目的基礎Activity中加入如下代碼注入字體.

注意：1.1.4版本之后使用如下設置注入

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

注意：1.1.3版本及之前的版本使用如下設置注入

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