BaseApp框架

一个封装了状态加载、屏幕适配和日志查看的Android MVC&MVP开发框架。👉项目地址👈

集成

• 在项目根目录下的build.gradle文件中加入：

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

• 在项目app模块下的build.gradle文件中加入：

android {
    viewBinding {
        enabled = true
    }
}

dependencies {
    implementation 'com.github.EIong:BaseApp:2.0.0'
}

使用

• 在应用Application中设置框架：
  • 屏幕适配使用副单位pt进行开发，dp和sp不会进行屏幕适配，可参考Android屏幕适配终结者。
  • 自定义状态加载适配器可参考BaseLoadingAdapter。

LogUtils.getConfig()
    // 设置日志保存天数
    .setSaveDays(3)
    // 设置输出日志文件
    .isLog2FileSwitch = true

BaseManager
    // 设置是否开启屏幕适配（默认关闭）
    .setOpenAdaptScreen(true)
    // 设置屏幕适配方向（默认宽度）
    .setAdaptScreenDirection(BaseManager.Direction.WIDTH)
    // 设置屏幕适配参数（默认1080）
    .setAdaptScreenValue(1080)
    // 设置状态加载适配器（默认BaseLoadingAdapter）
    .setLoadingAdapter(BaseLoadingAdapter())
    // 设置日志加密（密码长度为16）
    .setLogEncryption("1111111111111111")

• MVC Activity继承BaseActivity，传入相应ViewBinding：

class MvcActivity : BaseActivity<ActivityMvcBinding>()

• MVC Fragment继承BaseFragment，传入相应ViewBinding：

class MvcFragment : BaseFragment<FragmentMvcBinding>()

• MVP 编写Contract契约类：

interface MvpContract {
    interface MvpPresenter : BaseContract.BasePresenter
    interface MvpView : BaseContract.BaseView
}

• MVP Presenter继承BasePresenter，传入相应View，实现契约类中Presenter接口：

class MvpPresenter : BasePresenter<MvpContract.MvpView>(), MvpContract.MvpPresenter

• MVP Activity继承BaseActivity，传入相应ViewBinding和Presenter，实现契约类中View接口：

class MvpActivity : BaseActivity<ActivityMvpBinding, MvpPresenter>(), MvpContract.MvpView

• MVP Fragment继承BaseFragment，传入相应ViewBinding和Presenter，实现契约类中View接口：

class MvpFragment : BaseFragment<FragmentMvpBinding, MvpPresenter>(), MvpContract.MvpView

在Activity和Fragment中通过vb拿到ViewBinding对象，p拿到Presenter对象，在Presenter中通过v拿到View对象。

• 覆写此方法进行初始化操作：

override fun initialize(savedInstanceState: Bundle?)

• 请求权限：
  • permissionsTip：请求权限提示
  • cancel：取消按钮文本
  • confirm：确定按钮文本
  • onCancel：点击取消回调
  • onGrantedAll：获取所有权限回调

requestPermissions(
  permissionsTip,
  cancel,
  confirm,
  onCancel,
  onGrantedAll,
  permission1,
  permission2,
  ...
)

• 覆写此方法自定义消息弹窗：
  • message：消息内容
  • cancel：取消按钮文本
  • confirm：确定按钮文本
  • onCancel：点击取消回调
  • onConfirm：点击确定回调

override fun showBaseDialog(
  activity: Activity,
  message: String,
  cancel: String,
  confirm: String,
  onCancel: () -> Unit,
  onConfirm: () -> Unit
)

• 显示加载中：

showLoading()

• 显示加载成功：

showSuccess()

• 显示加载失败：
  • retry：重试操作

showFailed(retry)

• 显示无数据：
  • retry：重试操作

showEmpty(retry)

• 指定View上显示加载中：
  • view：指定View

showLoadingOverView(view)

• 指定View上显示加载成功：
  • view：指定View

showSuccessOverView(view)

• 指定View上显示加载失败：
  • view：指定View
  • retry：重试操作

showFailedOverView(view, retry)

• 指定View上显示无数据：
  • view：指定View
  • retry：重试操作

showEmptyOverView(view, retry)

• 添加点击事件：

addClick(view1, view2, ...)

• 覆写此方法实现点击事件：

override fun onClick(v: View)

• 显示View：

showViews(view1, view2, ...)

• 隐藏View（INVISIBLE）：

hideViews(view1, view2, ...)

• 隐藏View（GONE）：

goneViews(view1, view2, ...)

• 查看日志：
  • password：密码，长度为16

BaseManager.goToLog(activity, password)

说明

框架中引入了Gloading（超轻量级，深度解耦Android App中全局加载中、加载失败及无数据视图），主要用于状态加载显示，引入了AndroidUtilCode（一个强大易用的安卓工具类库，它合理地封装了安卓开发中常用的函数，具有完善的Demo和单元测试，利用其封装好的APIs可以大大提高开发效率），主要用于屏幕适配和权限请求等，如需使用以上框架，无需重复引入，Respect~。