上一篇介绍了 Android Jetpack 组件 LiveData,LiveData
是在Lifecycle
的帮助下,实现了生命周期管理的一致性,将数据变更的通知控制在生命周期活跃状态 STARTED、RESUMED(注意这是Lifecycle 中的 State)时进行通知,该通知成为数据的唯一可信来源,也就是视图获取数据的唯一入口。LiveData 经常和 ViewModel 一起配合使用。
下面我们来介绍下一个 Android Jetpack 的下一个组件 ViewModel,先来看官方的定义:ViewModel 类旨在以注重生命周期的方式存储和管理界面相关的数据。ViewModel
类让数据可在发生屏幕旋转等配置更改后继续留存。
在我看来,ViewModel
类让数据可在屏幕发生等配置更改后继续留存,比如在界面因配置改变重新创建后 ViewModel 依旧持有原先的数据,这个功能当然很重要,但还有一个同样重要的功能是在 Fragment
之间共享数据,最后由于其管理方式(单向依赖,只有 Activity/Fragment
持有 ViewModel
),也避免了内存泄漏的发生。同时 ViewModel
配合 kotlin 协程,将加载器替换为 ViewModel
,这些也是 ViewModel
能发挥重要作用的地方。
// LiveData & ViewModel 因为这两者通常都一起使用
implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.2.0"
implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.2.0"
Android Jetpack 架构组件为界面控制器提供了 ViewModel 辅助程序类,该类负责为界面准备数据。在配置更改期间会自动保留 ViewModel 对象,以便他们存储的数据立即可供下一个 Activity/Fragment 实例使用。下面来看个例子:
ViewModel 代码如下:
class AccountViewModel: ViewModel() {
private val _userAgeLiveData: MutableLiveData = MutableLiveData()
val userAgeLiveData: LiveData
get() = _userAgeLiveData
fun loadUserName(userId: String){
val accountRepository = AccountRepository()
Log.i("ViewModel=====", "loadUserName: ")
viewModelScope.launch {
//suspend 方法,2s 后获取用户信息
val result = accountRepository.requestUserInfo(userId)
// 赋值
_userAgeLiveData.value = result
}
}
override fun onCleared() {
super.onCleared()
Log.i("ViewModel=====", "onCleared: ")
}
}
Activity 代码如下:
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
txtUserName = findViewById(R.id.txtUserName)
Log.i(TAG, "onCreate: ")
val accountViewModel = ViewModelProvider(this).get(AccountViewModel::class.java)
findViewById(R.id.btnGetUserInfo).setOnClickListener {
accountViewModel.loadUserName("jackie")
}
accountViewModel.userAgeLiveData.observe(this, Observer {
//通知UI,UI 进行操作
Log.i(TAG, "onCreate: ========observe change=========")
txtUserName.text = it
})
}
点击按钮后获取用户信息,执行了 ViewModel 中的方法loadUserName
jetpackdemo I/ViewModel=====: loadUserName:
jetpackdemo I/AccountActivity=====: onCreate: ========observe change=========
配置变化后(屏幕旋转后),日志打印如下:
jetpackdemo I/AccountActivity=====: onPause:
jetpackdemo I/AccountActivity=====: onDestroy:
jetpackdemo I/AccountActivity=====: onCreate:
jetpackdemo I/AccountActivity=====: onStart:
jetpackdemo I/AccountActivity=====: onCreate: ========observe change=========
可以看到 Activity 重新创建了,我们并没有点击按钮执行loadUserName
方法,但是却回调了Observer 的 onChange 方法;而且 ViewModel 的 onClear方法并没有执行,说明 ViewModel 并没有销毁重建。
注意
ViewModel 的创建方式使用的是
val accountViewModel = ViewModelProvider(this).get(AccountViewModel::class.java)
而不是
val accountViewModel = AccountFactory().create(AccountViewModel::class.java)
class AccountFactory: ViewModelProvider.Factory {
override fun create(modelClass: Class): T {
if (modelClass.isAssignableFrom(AccountViewModel::class.java)){
return AccountViewModel() as T
}
throw IllegalArgumentException("Unknown ViewModel class")
}
}
Activity 中的两个或更多 Fragment 互相通信是一种很常见的需求。假设你有一个 Fragment,在该 Fragment 中,用户从列表中选择一项,还有另一个 Fragment,用于显示选定项的内容。这种情况不太容易处理,因为这两个 Fragment 都需要定义某种接口描述,并且所有者 Activity 必须将两者绑定在一起。此外,这两个 Fragment 都必须处理另一个 Fragment 尚未创建或不可见的情况。
可以使用 ViewModel
对象解决这个常见的难点。这两个 Fragment 可以使用其 Activity 范围共享 ViewModel
来处理此类通信,代码如下:
class SharedViewModel : ViewModel() {
val selected = MutableLiveData- ()
fun select(item: Item) {
selected.value = item
}
}
class MasterFragment : Fragment() {
private lateinit var itemSelector: Selector
// Use the 'by activityViewModels()' Kotlin property delegate
// from the fragment-ktx artifact
private val model: SharedViewModel by activityViewModels()
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
itemSelector.setOnClickListener { item ->
// Update the UI
}
}
}
class DetailFragment : Fragment() {
// Use the 'by activityViewModels()' Kotlin property delegate
// from the fragment-ktx artifact
private val model: SharedViewModel by activityViewModels()
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
model.selected.observe(viewLifecycleOwner, Observer
- { item ->
// Update the UI
})
}
}
这两个 Fragment 都会检索包含它们的 Activity。这样,当这两个 Fragment 各种获取 ViewModelProvider
时,他们会收到相同的SharedViewModel
实例(其范围限定为该 Activity)。
此方法具有以下优势:
SharedViewModel
约定之外,Fragment 不需要相互了解。如果其中一个 Fragment 消失,另一个 Fragment 将继续照常工作。ViewModel
对象存在的时间范围是获取ViewModel
时传递给 VIewModelProvider 的 Lifecycle。也就是上面我们调用的代码:
val accountViewModel = ViewModelProvider(this).get(AccountViewModel::class.java)
这里的this
是Activity
实例对象,因为我们的Activity
实现了 Lifecycle
的关联。ViewModel
将一直留在内存中,直到限定其存在时间范围的 Lifecycle
永久消失:对于 Activity,是在 Activity 完成时;而对于 Fragment,是在 Fragment 分离时。
下图是 Activity 在屏幕旋转而后结束时所处的各种生命周期状态。该图还在关联 Activity 生命周期的旁边显示了 ViewModel
的生命周期。这些基本状态同样适用于 Fragment 的生命周期。
通常是在系统首次调用 Activity 对象的 onCreate()
时请求ViewModel
。ViewModel
存在的时间范围是从首次请求ViewModel
直到 Activity 完成并销毁。
在分析源码前,我先提出两个问题,ViewModel 是如何做到让数据可在发生屏幕旋转等配置更改后继续留存(也就是说ViewModel 实例依然存在)?Fragment 之间是如何通过 ViewModel 共享数据的?
先来看看ViewModel
类
public abstract class ViewModel {
···
private volatile boolean mCleared = false;
/**
* This method will be called when this ViewModel is no longer used and will be destroyed.
*
* It is useful when ViewModel observes some data and you need to clear this subscription to
* prevent a leak of this ViewModel.
*/
//该方法将会在 ViewModel 被清除时调用,可以在这个方法里做一些取消注册,防止内存泄漏
@SuppressWarnings("WeakerAccess")
protected void onCleared() {
}
@MainThread
final void clear() {
mCleared = true;
···
onCleared();
}
···
}
ViewModel 只是一个抽象类,clear()
方法会在 ViewModel 被清除时调用有,用户可以通过重写 onCleared()
方法来处理一些额外的操作。
再从调用处开始分析
val accountViewModel = ViewModelProvider(this).get(AccountViewModel::class.java)
我们再来看看ViewModelProvider
这个类:
public ViewModelProvider(@NonNull ViewModelStoreOwner owner) {
this(owner.getViewModelStore(), owner instanceof HasDefaultViewModelProviderFactory
? ((HasDefaultViewModelProviderFactory) owner).getDefaultViewModelProviderFactory()
: NewInstanceFactory.getInstance());
}
public ViewModelProvider(@NonNull ViewModelStoreOwner owner, @NonNull Factory factory) {
this(owner.getViewModelStore(), factory);
}
public ViewModelProvider(@NonNull ViewModelStore store, @NonNull Factory factory) {
mFactory = factory;
mViewModelStore = store;
}
最终调用到的构造器都是第三个构造器,再来看看ViewModelStore
和Factory
是什么,因为我们传入的是 Activity(是ViewModelStoreOwner
和HasDefaultViewModelProviderFactory
的实现者),所以才会有owner.getViewModelStore()
,第二个参数是getDefaultViewModelProviderFactory()
。
ViewModelStoreOwner
可以理解为 ViewModelStore(ViewModel 存储器)的拥有者,也就是说我们的 Activity/Fragment 是 ViewModel 存储器的拥有者。
然后我们来看看看ViewModelStore
是什么?
// 存储 ViewModel
public class ViewModelStore {
private final HashMap mMap = new HashMap<>();
final void put(String key, ViewModel viewModel) {
ViewModel oldViewModel = mMap.put(key, viewModel);
if (oldViewModel != null) {
oldViewModel.onCleared();
}
}
final ViewModel get(String key) {
return mMap.get(key);
}
Set keys() {
return new HashSet<>(mMap.keySet());
}
/**
* Clears internal storage and notifies ViewModels that they are no longer used.
*/
public final void clear() {
for (ViewModel vm : mMap.values()) {
vm.clear();
}
mMap.clear();
}
}
可以看到ViewModelStore
的代码很简单,就是用一个 HashMap 存储了key(String)
和value(ViewModel)
,这里的 key 的名字为
// key 的名字
DEFAULT_KEY + ":" + canonicalName
private static final String DEFAULT_KEY =
"androidx.lifecycle.ViewModelProvider.DefaultKey";
String canonicalName = modelClass.getCanonicalName();
因为第二个参数是通过getDefaultViewModelProviderFactory()
获取到的,前面说过Activity
是 HasDefaultViewModelProviderFactory
的实现类,我们再来看看Activity
中的getDefaultViewModelProviderFactory()
方法
@NonNull
@Override
public ViewModelProvider.Factory getDefaultViewModelProviderFactory() {
if (getApplication() == null) {
throw new IllegalStateException("Your activity is not yet attached to the "
+ "Application instance. You can't request ViewModel before onCreate call.");
}
if (mDefaultFactory == null) {
mDefaultFactory = new SavedStateViewModelFactory(
getApplication(),
this,
getIntent() != null ? getIntent().getExtras() : null);
}
return mDefaultFactory;
}
可以看到是通过一个SavedStateViewModelFactory
来获取ViewModelProvider.Factory
,命名也很清晰直观,就是保存状态的 ViewModel 工厂。
下面我们再来看看get(AccountViewModel::class.java)
方法
@NonNull
@MainThread
public T get(@NonNull Class modelClass) {
String canonicalName = modelClass.getCanonicalName();
if (canonicalName == null) {
throw new IllegalArgumentException("Local and anonymous classes can not be ViewModels");
}
return get(DEFAULT_KEY + ":" + canonicalName, modelClass); //key的名字
}
@SuppressWarnings("unchecked")
@NonNull
@MainThread
public T get(@NonNull String key, @NonNull Class modelClass) {
ViewModel viewModel = mViewModelStore.get(key); //从 hashmap 中获取 viewmodel 实例
if (modelClass.isInstance(viewModel)) {
if (mFactory instanceof OnRequeryFactory) {
((OnRequeryFactory) mFactory).onRequery(viewModel);
}
return (T) viewModel;
} else {
//noinspection StatementWithEmptyBody
if (viewModel != null) {
// TODO: log a warning.
}
}
//使用 Factory 创建
if (mFactory instanceof KeyedFactory) {
viewModel = ((KeyedFactory) (mFactory)).create(key, modelClass);
} else {
viewModel = (mFactory).create(modelClass);
}
//存入 viewModelStore
mViewModelStore.put(key, viewModel);
return (T) viewModel;
}
简单来说就是从mViewModelStore
获取 ViewModel,如果没有获取到,就使用 Factory 创建,然后存入mViewModelStore
。
这样逻辑就清楚了,ViewModelProvider(this).get(AccountViewModel::class.java)
会把ViewModel
存入ViewModelStore
中。
因为 Activity 实现了ViewModelStoreOwner
接口,可以理解为 ViewModelStore(ViewModel 存储器)的拥有者,也就是说我们的 Activity/Fragment 是 ViewModel 存储器的拥有者。
public interface ViewModelStoreOwner {
/**
* Returns owned {@link ViewModelStore}
*
* @return a {@code ViewModelStore}
*/
@NonNull
ViewModelStore getViewModelStore();
}
然后我们来看看该方法在 Activity 中的实现
@NonNull
@Override
public ViewModelStore getViewModelStore() {
if (getApplication() == null) {
throw new IllegalStateException("Your activity is not yet attached to the "
+ "Application instance. You can't request ViewModel before onCreate call.");
}
if (mViewModelStore == null) {
//从getLastNonConfigurationInstance 获取
NonConfigurationInstances nc =
(NonConfigurationInstances) getLastNonConfigurationInstance();
if (nc != null) {
//恢复viewmodelstore
// Restore the ViewModelStore from NonConfigurationInstances
mViewModelStore = nc.viewModelStore;
}
//如果还是获取不到,就新建一个
if (mViewModelStore == null) {
mViewModelStore = new ViewModelStore();
}
}
return mViewModelStore;
}
从该方法中可以看到,Activity(ViewModelStoreOwner)
内部最终会创建一个ViewModelStore
,用来存储ViewModel
,接下来我们来看getLastNonConfigurationInstance
方法
//ComponentActivity.java
NonConfigurationInstances mLastNonConfigurationInstances;
@Nullable
public Object getLastNonConfigurationInstance() {
return mLastNonConfigurationInstances != null
? mLastNonConfigurationInstances.activity : null;
}
static final class NonConfigurationInstances {
Object custom;
ViewModelStore viewModelStore;
}
为什么使用 getLastNonConfigurationInstance 方法呢,我们先来看看 Activity 状态保存和恢复:
和
onRetainNonConfigurationInstance 的使用场景区别我们知道,在屏幕旋转的时候会执行保存状态和恢复状态的方法
@Override
protected void onSaveInstanceState(Bundle outBundle) { //保存
super.onSaveInstanceState(outBundle);
}
@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) { //恢复
super.onRestoreInstanceState(savedInstanceState);
}
//注意,如果你是继承 AppcompactActiviy,该方法已经在它的父类 ComponentActivity 定义为 final,子类无法重写
//继承 Activity 就可以
public Object onRetainNonConfigurationInstance() {
// TODO Auto-generated method stub
// 在这里设置需要保存的内容,在切换时不是bundle了,我们可以直接通过object来代替。
return super.onRetainNonConfigurationInstance();
}
@Nullable
@Override
public Object getLastNonConfigurationInstance() {
return super.getLastNonConfigurationInstance();
}
在 Android 10,他们的执行顺序都在onStop
和onDestory
之间,而且onSaveInstanceState
比onRetainNonConfigurationInstance
先执行,一般情况我们保存的数据不是太大,适合放在 Bundle 中,这个时候使用onSaveInstanceState
比较合适,如果要保存的数据不适合放在 Bundle 中(比如: 一个socket)或是数据比较大(比如 Bitmap),那么这个时间我们就应该使用onRetainNonConfigurationInstance()
,而且我们使用onRetainNonConfigurationInstance()
可以保存任何类型的对象,像AsyncTask
和SQLiteDatabse
,我们都可以进行保存。这些类型的数据可能会被一个新的Activity
重新使用。
也就是说 Bundle 中只能放一些特定的类型,比如基本数据类型,数组,Serialable 对象,而onRetainNonConfigurationInstance
中只要是个 Object 对象就可以了。
同时当某个activity
变得“容易”被系统销毁时,该activity
的onSaveInstanceState
就会被执行,而onRetainNonConfigurationInstance
更多的是时候是在配置改变时操作的,这个时候保存一些不会因为配置改变而发生改变的东西,而且onSaveInstanceState
数据是序列化保存到磁盘中。而onRetainNonConfigurationInstance
保存的数据是存在内存中。
所以这里我们的 ViewModel 肯定是放在onRetainNonConfigurationInstance
方法中,再来看看
//ComponentActivity.java
@Override
@Nullable
public final Object onRetainNonConfigurationInstance() {
Object custom = onRetainCustomNonConfigurationInstance();
ViewModelStore viewModelStore = mViewModelStore;
if (viewModelStore == null) {
// No one called getViewModelStore(), so see if there was an existing
// ViewModelStore from our last NonConfigurationInstance
NonConfigurationInstances nc =
(NonConfigurationInstances) getLastNonConfigurationInstance();
if (nc != null) {
viewModelStore = nc.viewModelStore;
}
}
if (viewModelStore == null && custom == null) {
return null;
}
//新建 NonConfigurationInstances,将 viewModelStore 保存
NonConfigurationInstances nci = new NonConfigurationInstances();
nci.custom = custom;
nci.viewModelStore = viewModelStore;
return nci;
}
可以看到在该方法中保存了viewModelStore
,保存在了NonConfigurationInstances
。而该getLastNonConfigurationInstance
的真正实现是在 Activity.java 类中
//Activity.java
//静态内部类
static final class NonConfigurationInstances {
Object activity;
HashMap children;
FragmentManagerNonConfig fragments;
ArrayMap loaders;
VoiceInteractor voiceInteractor;
}
NonConfigurationInstances mLastNonConfigurationInstances;
@Nullable
public Object getLastNonConfigurationInstance() {
return mLastNonConfigurationInstances != null
? mLastNonConfigurationInstances.activity : null;
}
而mLastNonConfigurationInstances
的赋值是在attach
方法中的mLastNonConfigurationInstances = lastNonConfigurationInstances;
,
final void attach(Context context, ActivityThread aThread,
Instrumentation instr, IBinder token, int ident,
Application application, Intent intent, ActivityInfo info,
CharSequence title, Activity parent, String id,
NonConfigurationInstances lastNonConfigurationInstances,
Configuration config, String referrer, IVoiceInteractor voiceInteractor,
Window window, ActivityConfigCallback activityConfigCallback, IBinder assistToken) {
attachBaseContext(context);
···
mLastNonConfigurationInstances = lastNonConfigurationInstances;
···
而attach
中的传入的参数lastNonConfigurationInstances
是ActivityClientRecord
的一个变量,而ActivityClientRecord
是存在ActivityThread
的mActivities(ArrayMap)
中,ActivityThread
中的ActivityClientRecord
不受activity
重建的影响,所以ActivityThread
中的lastNonConfigurationInstances
同样也不受影响,所以ComponentActiviy
中的NonConfigurationInstances
也无影响,所以ViewModelStore
不受影响,最终ViewModel
在Activity
重新创建后调用getLastNonConfigurationInstance
获取得到,这也是ViewModel
一直存在的原因。
在更早之前版本保存 ViewModel 是使用HolderFragment
的,Fragment 中的setRetainInstance(boolean)
在设置为 true 时可以是当前的 Fragment 在 Activity 重建时存储下来,所以可以在 Activity 中注入一个 Fragment,这样就可以达到保存 ViewModel 的功能了。详情可以参考这篇文章。
从上面的分析,我们知道ViewModel
存在Activity
的ViewModelStore
中,多个 Fragment 依赖于同一个 Activity,这个时候拿到同一个ViewModel
自然就不是问题了。
原因很简单,因为 LiveData 的事件是粘性事件,也就是说当 Activity 销毁后,因为 ViewModel 中的 LiveData 并没有销毁(有具体的值),在 Activity 重新创建后,LiveData 会将该值发送给当前 Activity 界面,达到恢复 Activity 界面状态的效果。
在ComponentActivity
的构造器中可以看出,getLifecycle().addObserver
添加了一个观察者观察界面是否销毁,一旦销毁,就清空ViewModelStore
中的所有ViewModel
。
public ComponentActivity() {
Lifecycle lifecycle = getLifecycle();
//noinspection ConstantConditions
if (lifecycle == null) {
throw new IllegalStateException("getLifecycle() returned null in ComponentActivity's "
+ "constructor. Please make sure you are lazily constructing your Lifecycle "
+ "in the first call to getLifecycle() rather than relying on field "
+ "initialization.");
}
if (Build.VERSION.SDK_INT >= 19) {
getLifecycle().addObserver(new LifecycleEventObserver() {
@Override
public void onStateChanged(@NonNull LifecycleOwner source,
@NonNull Lifecycle.Event event) {
if (event == Lifecycle.Event.ON_STOP) {
Window window = getWindow();
final View decor = window != null ? window.peekDecorView() : null;
if (decor != null) {
decor.cancelPendingInputEvents();
}
}
}
});
}
getLifecycle().addObserver(new LifecycleEventObserver() {
@Override
public void onStateChanged(@NonNull LifecycleOwner source,
@NonNull Lifecycle.Event event) {
if (event == Lifecycle.Event.ON_DESTROY) {
if (!isChangingConfigurations()) {
getViewModelStore().clear(); //界面执行 onDestroy 方法是,清空 viewmodel
}
}
}
});
if (19 <= SDK_INT && SDK_INT <= 23) {
getLifecycle().addObserver(new ImmLeaksCleaner(this));
}
}
ViewModel 支持协程,ViewMdoelScope 为应用中的每个ViewModel
定义了ViewMdoelScope
,如果 ViewModel
已清除,则在此范围内启动的协程都会自动取消。如果您具有仅在 ViewModel
处于活动状态时才需要完成的工作,此时协程非常有用。例如,如果要为布局计算某些数据,则应将工作范围限定至 ViewModel
,以便在 ViewModel
清除后,系统会自动取消工作以避免消耗资源。
viewModelScope.launch {
// Coroutine that will be canceled when the ViewModel is cleared.
}
Android Jetpack 的这些架构组件配合起来会非常强大,大大节省开发者的开发时间,同时还能轻松避免内存泄漏,简直就是开发利器。
ViewModel 是个非常好用的 Android Jetpack 组件,可在发生屏幕旋转等配置更改后继续留存,同时还能在不同 Fragment 之间共享,在配合协程使用时也非常方便,还能轻松避免内存泄漏。
需要注意的是,不少开发者会将 ViewModel 实现 LifecycleObserver 接口,把 ViewModel 当做一个能感应生命周期变化的组件,在感知到生命周期的方法中执行loadData
之类的操作,然后通过 LiveData 去通知 UI 做出对应的改变,这样的做法丧失了官方为我们设计的 ViewModel 的初衷,反而有点不伦不类了。而且 ViewModel 配合协程也非常方便,也有很多人将网络请求也放到 ViewModel 去调用,个人感觉也是很不合适的,可以参考官方的Demo进行设计。
最近火热的Jetpack Compose是谷歌在2019Google i/o大会上发布的新的库,是用于构建原生Android UI的现代工具包。他有强大的工具和直观的Kotlin API,简化并加速了Android上的UI开发。可以帮助开发者用更少更直观的代码创建View,还有更强大的功能,以及还能提高开发速度。
客观地讲,Compose 确实是一套比较难学的东西,因为它毕竟太新也太大了,它是一个完整的、全新的框架,确实让很多人感觉「学不动」,这也是个事实。
如果你是因为缺少学习资料,而我正好薅到这本谷歌内部大佬根据实战编写的《Jetpack Compose最全上手指南》,从入门到精通,教程通俗易懂,实例丰富,既有基础知识,也有进阶技能,能够帮助读者快速入门,是你学习Jetpack Compose的葵花宝典,快收藏起来!!!
1. 为什么我们需要一个新的UI 工具?
2. Jetpack Compose的着重点
3. API 设计
4. Compose API 的原则
5. 深入了解Compose
1. Android Jetpack Compose 最全上手指南
2. 深入详解 Jetpack Compose | 优化 UI 构建
3. 深入详解 Jetpack Compose | 实现原理
1. Jetpack Compose应用1
2. Jetpack Compose应用2
3. Jetpack Compose应用做一个倒计时器
4. 用Jetpack Compose写一个玩安卓App
5. 用Compose Android 写一个天气应用
6. 用Compose快速打造一个“电影App”