VipBase

VipBase是一个Android端基类融合库，目前抽取了Activity,Fragment，PagerAdapter等相关的父类，也提供了和父类相关的，沉浸式状态栏，统一的标题栏，事件消息分发总线等功能，无第三方依赖，都是Android原生的代码封装，请放心使用。

有了这个基类库，可以大大缩短的您的业务开发时间，可以统一所有的页面代码书写方式，让架构模式简单化，让业务代码清晰化，和目前主流的MVVM架构模式，完美契合，您只关心业务开发，其他的交给VipBase。

VipBase有哪些功能

MVVM架构模式开发，Activity和Fragment简单继承即可实现。
ViewModel基类抽取，状态封装，LiveData简单使用。
可选择性使用Repository。
DataBiding使用，告别findViewById。
Xml和ViewModel绑定。
标题栏全局初始化，动态更改属性，比如高度，颜色，文字和图标等。
支持透明状态栏，沉浸式简单实现，状态栏颜色动态配置。
支持BaseFragmentPagerAdapter使用，结合ViewPage简单实现Tab指示器效果。
支持消息总线，事件的分发和事件的接收轻松实现。

MVVM架构图

VipBase快速使用

1、在你的根项目下的build.gradle文件下，引入maven。

allprojects {
    repositories {
        maven { url "https://gitee.com/AbnerAndroid/almighty/raw/master" }
    }
}

2、在你需要使用的Module中build.gradle文件下，引入依赖。当前版本号：1.0.4

dependencies {
    implementation 'com.vip:base:1.0.4'
}

VipBase功能使用

大家可以看源码中的app模块，里面有每个功能使用的详细介绍,或者直接点击下面对应的查看。

Application中初始化

每个项目的不同，页面和顶部状态栏也是不一样的，在基础库中父类库中给出了一个全局初始化的方法，大家可以根据自己项目的实际主题进行全局初始化，初始化尽量提前，可在Application里onCreate方法里进行。

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        BaseConfig.apply {
            actionBarBg = R.color.base_color_272F3E
            titleColor = R.color.base_color_ffffff
            statusBarColor = R.color.base_color_272F3E
            statusBarDarkMode = false
        }
    }
}

初始化相关属性介绍（根据实际需要，选择性使用）

参数	类型	说明
statusBarColor	int	状态栏背景颜色
statusBarDarkMode	boolean	状态栏文字颜色
actionBarHeight	int	ActionBar（标题栏）的高度
actionBarBg	int	ActionBar（标题栏）的背景颜色
titleColor	int	ActionBar （标题栏）中间title的颜色
titleSize	float	ActionBar（标题栏）中间title的大小
leftIcon	int	ActionBar（标题栏）左侧的图标，一般是返回图片
leftIconWidth	int	ActionBar（标题栏）左边图片的宽度
leftIconHeight	int	ActionBar（标题栏）左边图片的高度
leftIconMarginLeft	int	ActionBar（标题栏）左边图片距离左边的距离
rightIconMarginRight	int	ActionBar（标题栏）右边图片距离右边的距离

除以上的属性之外，BaseConfig还提供了几个方法

全局上下文设置

设置

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        BaseConfig.apply {
            //…… 其他属性
            setBaseContext(this@App)//设置全局上下文
        }
    }
}

使用

哪里有用到全局上下文的地方，就可以如下进行调用。

BaseConfig.getBaseContext()

全局基类生命周期监听

为什么要进行基类BaseActivity的生命周期监听，主要因为是，本库是要打包给到他人使用，在一些场景下需要在基类里进行初始化一些东西，比如埋点，Activity的栈管理，比如三方的一些SDK等需求，基于此，特意提供了这个方法，可以选择性使用。

如果你是直接使用的源码，那么在遇到上述的问题，直接在基类中写即可，就没必要在用这个方法了。

设置

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        BaseConfig.apply {
            //…… 其他属性
            addActivityListener(ActivityListener())//全局监听基类Activity的生命周期
        }
    }
}

使用

需要创建一个类，实现接口BaseActivityListener即可

/**
 *AUTHOR:AbnerMing
 *DATE:2023/7/15
 *INTRODUCE:基类BaseActivity生命周期监听,可以在这里处理一些业务
 */
class ActivityListener : BaseActivityListener {

    override fun onCreate(savedInstanceState: Bundle?, context: Context) {

    }

    override fun onStart() {
    }

    override fun onRestart() {
    }

    override fun onResume() {
    }

    override fun onPause() {
    }

    override fun onStop() {
    }

    override fun onDestroy() {
    }
}

单个功能详细介绍

相关功能	概述	点击查看使用方式
BaseActivity	逻辑比较简单的Activity可以继承此类	查看
BaseVMActivity	使用ViewModel的Activity可以继承此类	查看
BaseFragment	逻辑比较简单的Fragment可以继承此类	查看
BaseVMFragment	使用ViewModel的Fragment可以继承此类	查看
BaseViewModel	ViewModel继承此类	查看
FragmentPagerAdapter	PagerAdapter父类结合TabLayout和ViewPager使用	查看
StatusBar	状态栏工具类，可以实现沉浸式，透明等	查看
ActionBarView	自定义的标题栏	查看
LiveDataBus	事件消息总线	查看

VipBase相关功能Demo效果图

欢迎关注作者

微信搜索【App开发干货铺】，或扫描下面二维码关注，查阅更多技术文章！

赞赏作者

看在作者这么努力的份上，赞赏随意，给个鼓励好不好~

License

Copyright (C) AbnerMing, VipBase Open Source Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

AbnerMing888/VipBase