如何防止Android锁屏后应用被最小化？附状态保存异常排查

问题概述 #

• 采用单Activity多Fragment架构，锁屏（主动/闲置触发）后解锁，应用被最小化，而Gmail等应用解锁后可保持前台最大化。
• 旋转屏幕时状态保存/恢复功能正常，但锁屏解锁时存在以下异常（仅真机出现，模拟器无此问题）：
  • 锁屏时onSaveInstanceState被调用，但解锁时onRestoreInstanceState不触发；
  • 切换到Fragment B（含TabView及3个子Fragment）时，锁屏解锁会触发Activity完全重建且saveState为null，Fragment A则能正常重启恢复状态。

核心排查方向 #

1. Activity启动模式与Manifest配置检查

   • 确认Activity的launchMode是否为standard，singleInstance/singleTask模式可能导致系统栈行为异常；
   • 排查Manifest中是否错误添加android:excludeFromRecents="true"，该属性会让应用退出后无法在最近任务列表保留；
   • 查看android:configChanges配置，虽然锁屏解锁不属于常规配置变更，但遗漏关键参数可能间接引发系统重建逻辑异常。

2. 进程被系统回收验证

   • 真机锁屏后，系统可能因内存不足杀死后台进程，此时解锁会重新创建Activity，若状态未正确持久化则会出现saveState为null的情况；
   • 开启开发者选项中的「不保留活动」，模拟进程被回收场景，验证是否复现问题；
   • 在onSaveInstanceState中写入自定义持久化数据（如SharedPreferences），解锁时检查数据是否存在，判断进程是否被回收。

3. Fragment状态保存逻辑排查

   • 检查Fragment B及其子Fragment的onSaveInstanceState是否调用了super.onSaveInstanceState(outState)，遗漏该调用会导致系统无法正确保存Fragment状态；
   • 确认是否使用FragmentTransaction.replace()切换Fragment，replace会销毁旧Fragment，若未正确保存状态则重建时会丢失；建议改用add()配合hide()/show()管理Fragment；
   • 检查是否为Fragment设置了setRetainInstance(true)（AndroidX中已不推荐），建议改用ViewModel保存非UI状态；
   • 排查Fragment B的Tab子Fragment是否每次都重复实例化，未利用系统恢复的Fragment实例，导致状态丢失。

4. Activity状态恢复逻辑校验

   • 检查Activity的onCreate方法是否正确判断savedInstanceState是否为null，仅当非null时执行状态恢复，避免强制重置到首个Fragment；
   • 确认onRestoreInstanceState是否调用了super.onRestoreInstanceState(savedInstanceState)，且恢复逻辑在super调用之后执行；
   • 排查onResume/onRestart中是否存在错误的Fragment重置逻辑，导致已恢复的状态被覆盖。

具体解决方案 #

1. 调整Activity配置

   • 在Manifest的Activity标签中确保launchMode="standard"，移除不必要的excludeFromRecents或taskAffinity配置；
   • 若需避免系统因配置变更重建Activity，可添加android:configChanges="orientation|screenSize|keyboardHidden"，但需自行处理配置变更逻辑。

2. 优化Fragment管理方式

   • 改用add()+hide()/show()管理Fragment，减少状态丢失风险：

     // 首次初始化Fragment
     if (savedInstanceState == null) {
         supportFragmentManager.beginTransaction()
             .add(R.id.container, FragmentA(), "TAG_A")
             .add(R.id.container, FragmentB(), "TAG_B")
             .hide(FragmentB())
             .commit()
     }
     // 切换Fragment
     supportFragmentManager.beginTransaction()
         .hide(currentFragment)
         .show(targetFragment)
         .commit()
     

   • 使用ViewModel保存Fragment业务状态（如滚动位置、Tab选中状态）：

     class FragmentBViewModel : ViewModel() {
         val selectedTabIndex = MutableLiveData(0)
         val recyclerViewScrollPos = MutableLiveData<Pair<Int, Int>>(Pair(0, 0))
     }
     // Fragment中获取ViewModel
     val viewModel = ViewModelProvider(this)[FragmentBViewModel::class.java]
     

3. 确保状态保存正确性

   • 在所有Fragment的onSaveInstanceState中必须调用super.onSaveInstanceState(outState)，并手动保存关键状态：

     override fun onSaveInstanceState(outState: Bundle) {
         super.onSaveInstanceState(outState)
         outState.putInt("selected_tab", tabLayout.selectedTabPosition)
     }
     

   • 在Fragment的onViewCreated中恢复状态：

     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
         super.onViewCreated(view, savedInstanceState)
         savedInstanceState?.let {
             tabLayout.selectTab(tabLayout.getTabAt(it.getInt("selected_tab")))
         }
     }
     

4. 处理进程被回收场景

   • 在Activity的onSaveInstanceState中保存当前显示的Fragment标签，onCreate中恢复：

     override fun onSaveInstanceState(outState: Bundle) {
         super.onSaveInstanceState(outState)
         val currentFragment = supportFragmentManager.findFragmentById(R.id.container)
         outState.putString("current_fragment_tag", currentFragment?.tag)
     }
     
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
         if (savedInstanceState != null) {
             val tag = savedInstanceState.getString("current_fragment_tag")
             tag?.let {
                 val targetFragment = supportFragmentManager.findFragmentByTag(it)
                 supportFragmentManager.beginTransaction()
                     .show(targetFragment!!)
                     .commit()
             }
         } else {
             // 首次启动加载默认Fragment
             supportFragmentManager.beginTransaction()
                 .add(R.id.container, FragmentA(), "TAG_A")
                 .commit()
         }
     }
     

内容的提问来源于stack exchange，提问作者Michel