XUI

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

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

在提 issue 前，请先阅读【提问的智慧】，并严格按照 issue 模板进行填写，节约大家的时间。

关于我

---

特征

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

---

如何使用

添加 Gradle 依赖

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

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

2. 然后在 dependencies 添加:

dependencies {
  ...
  //1.0.5 版本后只支持 androidx
  implementation 'com.github.xuexiangjys:XUI:1.0.5'

  implementation 'androidx.appcompat:appcompat:1.0.2'
  implementation 'androidx.recyclerview:recyclerview:1.0.0'
  implementation 'com.google.android.material:material:1.1.0-alpha07'
  implementation 'com.github.bumptech.glide:glide:4.8.0'
}

【注意】如果你的项目目前还未使用 androidx，那你只能使用 1.0.5 之前的版本了。

dependencies {
  ...
  implementation 'com.github.xuexiangjys:XUI:1.0.4'

  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. 调整应用的基础主题

必须设置应用的基础主题，否则组件将无法正常使用！

基础主题类型：

• 大平板 (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 刚开始时调用如下代码动态设置主题

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

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

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

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

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

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

---

演示（请 star 支持）

演示程序截图

Demo 下载

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

蒲公英下载

Github 下载

特别感谢

• QMUI_Android
• AgentWeb
• CityPicker
• SmartRefreshLayout
• PhotoPicker
• Android-PickerView
• MaterialEditText
• MaterialSpinner
• FlycoBanner_Master
• MaterialProgressBar

如果觉得项目还不错，可以考虑打赏一波

联系方式