XUI 一个简洁而优雅的Android原生UI框架，解放你的双手！

迷南。 2022-03-26 08:19 671阅读 0赞

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZXhpYW5nanlz_size_16_color_FFFFFF_t_70]

# XUI #

[XUI项目地址][XUI]

一个简洁而又优雅的Android原生UI框架，解放你的双手！还不赶紧点击[使用说明文档][Link 1]，体验一下吧！

> 涵盖绝大部分的UI组件：TextView、Button、EditText、ImageView、Spinner、Picker、Dialog、PopupWindow、ProgressBar、LoadingView、StateLayout、FlowLayout、Switch、Actionbar、TabBar、Banner、GuideView、BadgeView、MarqueeView、WebView、SearchView等一系列的组件和丰富多彩的样式主题。

在使用前，请一定要仔细阅读[使用说明文档][Link 1],重要的事情说三遍！！！

## 视频介绍 ##

XUI使用指南

视频链接: [https://www.bilibili.com/video/BV1w7411c7Hy/][https_www.bilibili.com_video_BV1w7411c7Hy]

--------------------

## 特征 ##

*  简洁优雅，尽可能少得引用资源文件的数量，项目库整体大小不足1M(打包后大约644k）
 *  组件丰富，提供了绝大多数我们在开发者常用的功能组件。
 *  使用简单，为方便快速开发，提高开发效率，对api进行了优化，提供一键式接入。
 *  样式统一，框架提供了一系列统一的样式，使UI整体看上去美观和谐。
 *  兼容性高，框架还提供了3种不同尺寸设备的样式（4.5英寸、7英寸和10英寸），并且最低兼容到Android 17, 让UI兼容性更强。
 *  扩展性强，各组件提供了丰富的属性和样式API，可以通过设置不同的样式属性，构建不同风格的UI。

--------------------

## 如何使用 ##

> 在决定使用XUI前，你必须明确的一点是，此框架给出的是一整套UI的整体解决方案，如果你只是想使用其中的几个控件，那大可不必引入如此庞大的一个UI库，Github上会有更好的组件库。如果你是想拥有一套可以定制的、统一的UI整体解决方案的话，那么你就继续往下看吧！

### 添加Gradle依赖 ###

1.先在项目根目录的 build.gradle 的 repositories 添加:

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

2.然后在dependencies添加:

dependencies {
      ...
      //androidx项目
      implementation 'com.github.xuexiangjys:XUI:1.1.5'
    
      implementation 'androidx.appcompat:appcompat:1.1.0'
      implementation 'androidx.recyclerview:recyclerview:1.1.0'
      implementation 'com.google.android.material:material:1.1.0'
      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'
    }

### 初始化XUI设置 ###

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

XUI.init(this); //初始化UI框架
    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

当然也可以在Activity刚开始时调用如下代码动态设置主题

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

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

（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));
    }

## 混淆配置 ##

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

--------------------

## 演示 ##

### 演示程序截图 ###

![在这里插入图片描述][20190116142606690.png] ![在这里插入图片描述][20190116142641122.png] ![在这里插入图片描述][20190116142713201.png] ![在这里插入图片描述][20190116142816600.png] ![在这里插入图片描述][20190116142827869.png] ![在这里插入图片描述][2019011614283898.png] ![在这里插入图片描述][20190116142846941.png] ![在这里插入图片描述][20190116142854297.png] ![在这里插入图片描述][20190116142901928.png] ![在这里插入图片描述][20190116142910561.png] ![在这里插入图片描述][20190116142919551.png] ![在这里插入图片描述][20190116142928113.png] ![在这里插入图片描述][20190116142936464.png] ![在这里插入图片描述][20190116142943863.png] ![在这里插入图片描述][20190116142951126.png] ![在这里插入图片描述][20190116142958814.png]

### Demo下载 ###

> 演示程序大概18M（主要是demo中集成了一个小视频拍摄的库比较大，大约13M左右，而XUI库目前只有644k大小），项目比较大，推荐使用蒲公英下载。

![在这里插入图片描述][20190116143015642.png]

#### 蒲公英下载 ####

![在这里插入图片描述][20190116143042780.png]

#### Github下载 ####

![在这里插入图片描述][20190116143054779.png]

## 特别感谢 ##

*  [QMUI\_Android][QMUI_Android]
 *  [AgentWeb][]
 *  [Android-Iconics][]
 *  [Android-PickerView][]
 *  [CityPicker][]
 *  [ELinkageScroll][]
 *  [FlycoBanner\_Master][FlycoBanner_Master]
 *  [Linkage-RecyclerView][]
 *  [MaterialEditText][]
 *  [MaterialSpinner][]
 *  [MaterialProgressBar][]
 *  [MPAndroidChart][]
 *  [PictureSelector][]
 *  [SmartRefreshLayout][]
 *  [SlideBack][]
 *  [SwipeRecyclerView][]

## 联系方式 ##

[点击一键加入QQ交流群][QQ]  
![在这里插入图片描述][20191009155635454.jpg]

## 微信公众号 ##

> 更多资讯内容，欢迎微信搜索公众号:【我的Android开源之旅】

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZXhpYW5nanlz_size_16_color_FFFFFF_t_70_pic_center]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZXhpYW5nanlz_size_16_color_FFFFFF_t_70]: /images/20220326/2abc1f8f985c4e3987714addc0d17db4.png
[XUI]: https://github.com/xuexiangjys/XUI
[Link 1]: https://github.com/xuexiangjys/XUI/wiki
[https_www.bilibili.com_video_BV1w7411c7Hy]: https://www.bilibili.com/video/BV1w7411c7Hy/
[20190116142606690.png]: https://img-blog.csdnimg.cn/20190116142606690.png
[20190116142641122.png]: https://img-blog.csdnimg.cn/20190116142641122.png
[20190116142713201.png]: https://img-blog.csdnimg.cn/20190116142713201.png
[20190116142816600.png]: https://img-blog.csdnimg.cn/20190116142816600.png
[20190116142827869.png]: https://img-blog.csdnimg.cn/20190116142827869.png
[2019011614283898.png]: https://img-blog.csdnimg.cn/2019011614283898.png
[20190116142846941.png]: https://img-blog.csdnimg.cn/20190116142846941.png
[20190116142854297.png]: https://img-blog.csdnimg.cn/20190116142854297.png
[20190116142901928.png]: https://img-blog.csdnimg.cn/20190116142901928.png
[20190116142910561.png]: https://img-blog.csdnimg.cn/20190116142910561.png
[20190116142919551.png]: https://img-blog.csdnimg.cn/20190116142919551.png
[20190116142928113.png]: https://img-blog.csdnimg.cn/20190116142928113.png
[20190116142936464.png]: https://img-blog.csdnimg.cn/20190116142936464.png
[20190116142943863.png]: https://img-blog.csdnimg.cn/20190116142943863.png
[20190116142951126.png]: https://img-blog.csdnimg.cn/20190116142951126.png
[20190116142958814.png]: /images/20220326/779f675fe6a548f29ce76911ffb7fe48.png
[20190116143015642.png]: /images/20220326/30d82e337b0440c39b6768e599806d1f.png
[20190116143042780.png]: /images/20220326/bb71c5f8a3b3423b819db976a1a17b90.png
[20190116143054779.png]: /images/20220326/2391d87eefe74aceb27d3921a082e441.png
[QMUI_Android]: https://github.com/Tencent/QMUI_Android
[AgentWeb]: https://github.com/Justson/AgentWeb
[Android-Iconics]: https://github.com/mikepenz/Android-Iconics
[Android-PickerView]: https://github.com/Bigkoo/Android-PickerView
[CityPicker]: https://github.com/xuexiangjys/CityPicker
[ELinkageScroll]: https://github.com/MFC-TEC/ELinkageScroll
[FlycoBanner_Master]: https://github.com/H07000223/FlycoBanner_Master
[Linkage-RecyclerView]: https://github.com/KunMinX/Linkage-RecyclerView
[MaterialEditText]: https://github.com/rengwuxian/MaterialEditText
[MaterialSpinner]: https://github.com/jaredrummler/MaterialSpinner
[MaterialProgressBar]: https://github.com/DreaminginCodeZH/MaterialProgressBar
[MPAndroidChart]: https://github.com/PhilJay/MPAndroidChart
[PictureSelector]: https://github.com/LuckSiege/PictureSelector
[SmartRefreshLayout]: https://github.com/scwang90/SmartRefreshLayout
[SlideBack]: https://github.com/ParfoisMeng/SlideBack
[SwipeRecyclerView]: https://github.com/yanzhenjie/SwipeRecyclerView
[QQ]: http://shang.qq.com/wpa/qunwpa?idkey=a2ab505862c81f1528416b585832022e835ce0abe28eefa4b0d53f8094a5691d
[20191009155635454.jpg]: /images/20220326/f53817070bf04872a7e2fa88f6174ae3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZXhpYW5nanlz_size_16_color_FFFFFF_t_70_pic_center]: /images/20220326/09eb7e8cf9254eca90e573dfd064aea4.png