Skip to content

24kpk/BaseUIFrame

Repository files navigation

BaseUIFrame

@EDITOR BY 冷寒

采用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)
    }
}

功能特性

全局 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>

注:部分组件未理解到位 详见

About

基于QMUI封装的Android UI 基础框架

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages