BaseUIFrame
採用QMUI作為基礎樣式搭建的基礎UI框架
使用步驟
BaseUIFrame已經更新到jitpack上,使用AndroidStudio匯入即可.
Step 1 在專案根目錄 build.gradle 中新增
allprojects {
repositories {
....
maven { url "https://jitpack.io" }
}
}
複製程式碼
Step 2 在App專案引用 build.gradle 中新增
dependencies {
compile 'com.github.24kpk:BaseUIFrame:1.0.3'
}
複製程式碼
Step 3 樣式引用
Application的Theme繼承BaseUIFrameAppTheme
<resources>
<!-- Base application theme. -->
<style name="AppTheme" parent="BaseUIFrameAppTheme">
<!-- Customize your theme here. -->
......
</style>
</resources>
複製程式碼
Step 4 初始化
public class YourApplication extends Application {
@Override public void onCreate() {
super.onCreate();
/**
* 預設配置
* 內部呼叫了: initDir() initLog(false) initExceptionHandler()三個方法
*/
BasicConfig.getInstance(this).init();
or
/**
* 自定義配置
* initDir() 初始化SDCard快取目錄
* initLog() 初始化日誌列印
* initExceptionHandler() 初始化異常資訊收集
*/
BasicConfig.getInstance(this)
.initDir() // or initDir(rootDirName)
.initExceptionHandler()
.initLog(true);
//其它初始化日誌方法:
/**
* @param tag 日誌標示
*/
initLog(tag)
/**
* @param tag 日誌標示
* @param isDebug true:列印全部日誌,false:不列印日誌
*/
initLog(tag, isDebug)
/**
* @param tag 日誌標示,可以為空
* @param methodCount 顯示方法行數,預設為:2
* @param isHideThreadInfo 是否顯示執行緒資訊,預設顯示
* @param adapter 自定義log輸出
* @param isDebug true:列印全部日誌,false:不列印日誌
*/
initLog(tag, methodCount, isHideThreadInfo, adapter, isDebug)
}
}
複製程式碼
附 QMUI元件功能列表
功能特性
全域性 UI 配置:只需要修改一份配置表就可以調整 App 的全域性樣式,包括元件顏色、導航欄、對話方塊、列表等。一處修改,全域性生效。
豐富的 UI 控制元件:提供豐富常用的 UI 控制元件,例如 BottomSheet、Tab、圓角 ImageView、下拉重新整理等,使用方便靈活,並且支援自定義控制元件的樣式。
高效的工具方法:提供高效的工具方法,包括裝置資訊、螢幕資訊、鍵盤管理、狀態列管理等,可以解決各種常見場景並大幅度提升開發效率。
如本專案配置的全域性樣式:
<!-- Base application theme. -->
<style name="BaseUIFrameAppTheme" parent="QMUI.Compat">
<!--預設關閉ActionBar、Title-->
<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>
<!-- 配置Android提供的theme -->
<item name="android:textAppearanceListItemSmall">@style/QDTextAppearanceListItemSmall</item>
<item name="android:textAppearanceListItem">@style/QDtextAppearanceListItem</item>
<item name="android:listPreferredItemHeight">?attr/qmui_list_item_height_higher</item>
<item name="android:listPreferredItemHeightSmall">?attr/qmui_list_item_height</item>
<!-- 配置qmui提供的theme -->
<item name="qmui_config_color_blue">@color/app_color_blue</item>
<item name="qmui_topbar_title_color">@color/qmui_config_color_white</item>
<item name="qmui_topbar_subtitle_color">@color/qmui_config_color_white</item>
<item name="qmui_topbar_text_btn_color_state_list">@drawable/s_topbar_btn_color</item>
<item name="qmui_topbar_height">48dp</item>
<item name="qmui_topbar_image_btn_height">48dp</item>
<item name="qmui_round_btn_bg_color">@drawable/s_btn_blue_bg</item>
<item name="qmui_round_btn_border_color">@drawable/s_btn_blue_border</item>
<item name="qmui_round_btn_text_color">@drawable/s_btn_blue_text</item>
<item name="qmui_content_spacing_horizontal">20dp</item>
<item name="qmui_content_padding_horizontal">@dimen/qmui_content_spacing_horizontal</item>
<item name="QMUITopBarStyle">@style/QDTopBar</item>
<!-- 配置app自己的theme -->
<item name="app_primary_color">?attr/qmui_config_color_blue</item>
<item name="app_content_bg_color">@color/qmui_config_color_white</item>
</style>
<style name="QDtextAppearanceListItem">
<item name="android:textColor">?attr/qmui_config_color_black</item>
<item name="android:textSize">18sp</item>
<item name="android:background">?attr/qmui_s_list_item_bg_with_border_bottom_inset_left
</item>
</style>
<style name="QDTextAppearanceListItemSmall">
<item name="android:textColor">?attr/qmui_config_color_gray_4</item>
<item name="android:textSize">16sp</item>
<item name="android:background">?attr/qmui_s_list_item_bg_with_border_bottom_inset_left
</item>
</style>
<style name="QDCommonTitle">
<item name="android:layout_width">match_parent</item>
<item name="android:layout_height">wrap_content</item>
<item name="android:layout_marginBottom">6dp</item>
<item name="android:textColor">?attr/qmui_config_color_gray_1</item>
<item name="android:textSize">16sp</item>
</style>
<style name="QDCommonDescription">
<item name="android:layout_width">match_parent</item>
<item name="android:layout_height">wrap_content</item>
<item name="android:layout_marginBottom">20dp</item>
<item name="android:gravity">center</item>
<item name="android:textColor">@color/app_color_description</item>
<item name="android:textSize">15sp</item>
</style>
<style name="QDTopBar" parent="QMUI.TopBar">
<item name="qmui_topbar_bg_color">?attr/app_primary_color</item>
</style>
<style name="QDRadiusButton" parent="@style/Button">
<item name="android:layout_height">40dp</item>
<item name="android:layout_width">wrap_content</item>
<item name="android:paddingLeft">?attr/qmui_content_spacing_horizontal</item>
<item name="android:paddingRight">?attr/qmui_content_spacing_horizontal</item>
<item name="android:background">@drawable/s_radius_button_bg</item>
<item name="android:textColor">@drawable/s_app_color_blue_2</item>
<item name="android:textSize">14sp</item>
<item name="android:gravity">center</item>
</style>
<style name="button_wrapper_style">
<item name="android:layout_width">match_parent</item>
<item name="android:layout_height">wrap_content</item>
<item name="android:paddingTop">24dp</item>
<item name="android:paddingBottom">24dp</item>
<item name="android:background">@drawable/qmui_divider_bottom_bitmap</item>
</style>
複製程式碼
注:部分元件未理解到位 詳見