# TinMvvm

**Repository Path**: GitGold/TinMvvm

## Basic Information

- **Project Name**: TinMvvm
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-29
- **Last Updated**: 2025-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TinMvvm #

## Surprise[![](https://jitpack.io/v/932707629/TinMvvm.svg)](https://jitpack.io/#932707629/TinMvvm)

```
//添加jitpack地址到项目根目录的build.gradle
allprojects {
    repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}
  //添加依赖到mudule目录的build.gradle
  dependencies {
    implementation 'com.github.932707629:TinMvvm:version'
  }
```

### 说在前面 ###
虽然已经在项目中添加了比较详细的代码注释，但是肯定还有很多需要注意的地方没有解释清楚，希望大家在使用的过程中如果发现了什么问题，及时提issue，大家共同解决.

### 我们的优势 ###
TinMvvm是以谷歌DataBinding+LiveData+ViewModel框架为基础，整合Rxjava2、ViewBinding、okhttp-RxHttp、Liveeventbus等流行模块，加上各种原生控件，
让事件与数据源完美绑定的一款容易上瘾的实用性MVVM快速开发框架。从此告别findViewById()，告别set()、get()； 支持单Activity多Fragment，当然，您也可以继续使用多Activity模式。

[更多Jetpack组件即将来袭！](https://developer.android.google.cn/jetpack "更多Jetpack组件即将来袭")

### 功能列表 ###

- 解决屏幕适配问题，适配全面屏/刘海屏(AndroidAutoSize是代替AndroidAutoLayout的屏幕适配框架，原理是基于今日头条的适配方案)
- 代码解耦，提供ActivityLifecycleCallbacksImpl、FragmentLifecycleCallbacksImpl给baseActivity/baseFragment减压
- 使用堆栈对Activity进行统一管理，AppManager封装了各种常用方法
- Activity标题栏统一设置，支持标题栏和状态栏统一设置背景color/shape/drawable
- 支持fragment设置状态栏沉浸式，多fragment无缝切换
- 提供fragmentUtils工具类，解决fragment重叠的bug，fragment任务栈统一管理
- 提供懒加载onLazyInitView()/fragment可见性onInvisible()/onVisible()方法回调
- BaseRecyclerViewAdapter3.0加持，使用ViewBinding，很nice！！！
- 使用RxHttp网络框架链式调用，与Rxjava3相结合，线程智能控制（开发者可选retrofit替换 个人比较喜欢rxhttp独特的设计）
- 解决Toast禁用通知权限不能弹出的bug，不分主次线程，可自定义Toast样式
- 全局使用Kotlin，可与Java无缝转换
- 支持新手指引，编程中使用不规范的地方，会引导你正确使用
- 使用插件一键生成Activity/Fragment
- 依赖RxPermission，权限申请更简单
- 使用LiveEventBus，自动销毁，事件传递更加清晰
- 异常捕获机制，将捕获到的异常信息反馈给开发者（Rxjava3异常以及运行时异常）
- 已废弃kotlin-android-extensions插件，完全支持databinding和viewbinding混合使用
- 新增BaseService，扩展了对Service的支持，使用Rxjava以及协程会更方便一些
- MMKV优化键值对存储，是原生SharedPreferences写入速度的数十倍(DataStore目前还不稳定,且性能不如MMKV,以后可能会考虑换用DataStore)

### 开发准备 ###

必须的项目配置，框架初始化都已添加，所以直接复制本项目更改包名，即可进行开发使用

### 开发指南 ###

使用的第三方框架:

[Jetpack组件库](https://developer.android.google.cn/jetpack "Jetpack组件库")

[RxJava3](https://github.com/ReactiveX/RxJava "RxJava3")

[ImmersionBar](https://github.com/gyf-dev/ImmersionBar "ImmersionBar")

[AndroidAutoSize](https://github.com/JessYanCoding/AndroidAutoSize)

[okhttp](https://github.com/square/okhttp "okhttp")

[ToastUtils](https://github.com/getActivity/ToastUtils "ToastUtils")

[BaseRecyclerViewAdapterHelper](https://github.com/CymChad/BaseRecyclerViewAdapterHelper "BaseRecyclerViewAdapterHelper")

[ALog](https://github.com/Blankj/ALog "ALog")

[RxPermissions](https://github.com/tbruyelle/RxPermissions "RxPermissions")

[MMKV](https://github.com/Tencent/MMKV "MMKV")

### 使用插件一键生成Activity/Fragment ###

Android Studio4.0以上不支持自定义模板,可以使用[一键生成TinMvvm组件](https://github.com/932707629/tin-mvvm-template)

Android Studio4.0以下使用TinMvvmTemplate这个文件里放着TinMvv的一键生成工具

可将TinMvvmTemplate放到AS安装目录\plugins\android\lib\templates\activities里

放进去之后重启AS，然后在需要建Activity/Fragment的地方，右键--New--Activity--TinMvvm全家桶，可选Activity/Fragment，然后取个名字，点击Finish，欧克，打完收功!

### 注意: ###

- ActivityLifeCycleCallBackIml可以监听到整个项目所有Activity的生命周期(包括第三方)，所以可以用它执行一些初始化与销毁业务，实现了对BaseActivity的解耦，FragmentLifecycleCallbacksImpl同理

- 如果要在fragment里设置状态栏沉浸，可以让该fragment实现SimpleImmersionOwner接口，或者实现ImmersionOwner接口，具体实现可以参考ImmersionBar的demo使用

- 三方库的初始化是在AppLifecycleImpl里进行的，建议能在子线程初始化的在子线程初始化.

- 本框架默认使用kotlin构建，如果您使用的是java，请自行依赖butterknife等第三方组件.

- 实际使用中发现[AndroidAutoSize](https://www.jianshu.com/p/55e0fca23b4f "骚年你的屏幕适配方式该升级了")对于第三方view的支持不是很友好，
比如穿山甲的广告View，会直接导致View比例显示异常，虽然可以用副单位去解决，但是要把整个页面都换成副单位，个人感觉不太友好，
所以有这种项目需要的童鞋要谨慎使用哦，可以考虑换用[最小宽度限定符](https://www.jianshu.com/p/2aded8bb6ede "骚年你的屏幕适配方式该升级了")

- 复制整个项目修改包名去做自己项目的时候可能会出现代码不更新的情况，每次都需要build之后代码才更新，这时候可以把项目的如下文件全部删除然后重启Android Studio
  
` 1.所有的build文件夹；
  2.gradlew和gradlew.bat文件；
  3.local.properties文件;
  4..gradle文件夹;
  5..idea文件夹`


### 新版功能:


### 我的主页 ###

 - 简书:[敲代码的鱼](https://www.jianshu.com/u/db6ff36dac08 "敲代码的鱼")
 - 掘金:[敲代码的鱼](https://juejin.cn/user/1865248698012616 "敲代码的鱼")
 - CSDN:[敲代码的鱼哇](https://blog.csdn.net/qq_35195386?spm=1001.2101.3001.5343 "敲代码的鱼哇")

### 参考文档

- [Jetpack 易错分享：还在使用 Fragment 作为 LifecycleOwner？](https://mp.weixin.qq.com/s/_2YSV_JsjDJ7CuHJngMbqQ)
- [RxHttp结合协程使用详解](https://juejin.cn/post/6844904100090347528#heading-2)


### 历史升级记录

### 1.4.2
- 调整生命周期赋值方式
- 优化内存泄露问题


### 1.4.1
- 升级项目依赖库
- 调整sharedViewModel共享ViewModel默认为false,可在GlobalConfiguration全局配置

### 1.4.0

- 取消协程在BaseViewModel里的置空问题，使用getScope()方法解决viewModelScope和lifecycle?.lifecycleScope可能被取消的问题
- 取消依赖ImmersionBar组件，由开发者自由选择

#### 1.3.7

- 解决Fragment复用会造成ViewModel的lifecycle为空的情况
- 优化Rxjava异常回调处理，统一回调到ResponseErrorListener

#### 1.3.6

- 解决直接在DataBindingActivity.initView()调用mViewModel.getLifeCycleOwner()出现为空的情况,此时lifecycle还没有被赋值
- 通过配置Activity/Fragment的sharedViewModel()可以决定该页面的ViewModel是否可被其他页面复用，默认可复用