QMUI_Android库 和 arch 库官方使用文档

一，QMUI库

简介

QMUI Android 的设计目的是用于辅助快速搭建一个具备基本设计还原效果的 Android 项目，同时利用自身提供的丰富控件及兼容处理，让开发者能专注于业务需求而无需耗费精力在基础代码的设计上。不管是新项目的创建，或是已有项目的维护，均可使开发效率和项目质量得到大幅度提升。

 

主要功能

1，全局 UI 配置

只需要修改一份配置表就可以调整 App 的全局样式，包括组件颜色、导航栏、对话框、列表等。一处修改，全局生效。

2，丰富的 UI 控件

提供丰富常用的 UI 控件，例如 BottomSheet、Tab、圆角 ImageView、下拉刷新等，使用方便灵活，并且支持自定义控件的样式。

3，高效的工具方法

提供高效的工具方法，包括设备信息、屏幕信息、键盘管理、状态栏管理等，可以解决各种常见场景并大幅度提升开发效率。

 

开始使用

1，引入qmui库

最新的库在 jcenter 仓库上，请确保项目中已经配置 jcenter 仓库源，然后直接引用：

implementation 'com.qmuiteam:qmui:2.0.0-alpha10'

 

2. 配置主题

把项目的 theme 的 parent 指向 QMUI.Compat，至此，QMUI 才可以正常工作。

<style name="AppTheme" parent="QMUI.Compat.NoActionBar">

<item name="colorPrimary">@color/colorPrimary</item>

<item name="colorPrimaryDark">@color/colorPrimaryDark</item>

<item name="colorAccent">@color/colorAccent</item>

</style>

 

3，修改QMUI默认属性

如果不想使用QMUI默认的属性，可以通过在项目中的 theme 中用

<item name="(name)">(value)</item> 的形式来覆盖 QMUI 组件的默认属性。具体可指定的属性名，参考@style/QMUI 中的属性。（即<style name="QMUI" parent="AppConfigTheme">下的属性）；如果找不到，可以在任何xml布局文件中的控件下输入style="@style/QMUI"，然后点击@style/QMUI进入即可；

 

4，功能列表

官方文档：https://qmuiteam.com/android/documents/

控件具体使用详情，以QMUIDialog为例：https://github.com/Tencent/QMUI_Android/wiki/QMUIDialog

二，Arch库 简介

arch 库提供的 QMUIFragment、QMUIFragmentActivity、QMUIActivity 来作为基础类构建自己的界面了。

 

1， 引入库

最新的库在 JCenter 仓库上，请确保项目中已配置了 JCenter 仓库源，然后直接引用：

def qmui_arch_version = '2.0.0-alpha10'

implementation "com.qmuiteam:arch:$qmui_arch_version"

kapt "com.qmuiteam:arch-compiler:$qmui_arch_version" // use annotationProcessor if java

2， 在 Application 里初始化

override fun onCreate() {

super.onCreate()

QMUISwipeBackActivityManager.init(this)

}

然后就可以使用 arch 库提供的 QMUIFragment、QMUIFragmentActivity、QMUIActivity 来作为基础类构建自己的界面了。

3，官方文档

腾讯QMUI官方文档：https://qmuiteam.com/android/

腾讯QMUI官方GitHub：https://github.com/Tencent/QMUI_Android