什么？按Home键SingleInstance Activity销毁了？？？

前段时间，突然有朋友询问，自己写的SingleInstance Activity在按home键的时候被销毁了，刚听到这个问题的时候，我直觉怀疑是Activity在onPause或者onStop中发生了Crash导致闪退了，但是安装apk查看现象，没有发现异常日志，这究竟是怎么回事呢？编写测试Demo来详细探索下

Demo代码说明

Demo日志很简单，包含MainActivity和SingleInstanceActivity两个页面，在MainActivity中的TextView点击事件中启动SingleInstanceActivity，在SingleInstanceActivity中的TextView点击事件中调用moveTaskToBack(true)切回后台，随后在MainActivity界面按Home键返回桌面，就可以看到SingleInstanceActivity被销毁了，示例代码如下所示：

// MainActivity.kt
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MyApplicationTheme {
                // A surface container using the 'background' color from the theme
                Surface(
                    modifier = Modifier
                        .fillMaxSize()
                        .clickable { onBtnClick() },
                    color = MaterialTheme.colorScheme.background
                ) {
                    Greeting("Android")
                }
            }
        }
    }
    fun onBtnClick() {
         startActivity(Intent(this,                                  SingleInstanceActivity::class.java))
    }
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!",
        modifier = modifier
    )
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
    MyApplicationTheme {
        Greeting("Android")
    }
}

// SingleInstanceActivity.java
public class SingleInstanceActivity extends ComponentActivity {
    private static final String TAG = "SingleInstanceActivity";
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    Log.d(TAG,"SingleInstanceActivity onCreate method called",new Exception());
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_single_instance);
    findViewById(R.id.move_back).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            moveTaskToBack(true);
        }
    });
  }

  @Override
  protected void onDestroy() {
    Log.d(TAG,"SingleInstanceActivity onDestroy method called",new Exception());
    super.onDestroy();
  }
}

<!-- AndroidManifest.xml文件中application节点的内容-->
<application
    android:allowBackup="true"
    android:dataExtractionRules="@xml/data_extraction_rules"
    android:fullBackupContent="@xml/backup_rules"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.MyApplication"
    tools:targetApi="31">
    <activity
        android:name=".SingleInstanceActivity"
        android:launchMode="singleInstance"
        android:exported="true" />
    <activity
        android:name=".MainActivity"
        android:exported="true"
        android:label="@string/app_name"
        android:theme="@style/Theme.MyApplication">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

调用栈回溯

即然SingleInstanceActivity被销毁了，那么我们只需要在Activity生命周期中添加日志，来看下onDestroyed函数是怎么驱动调用的即可，从Activity生命周期可知，在Framework中框架通过ClientLifecycleManager类来管理Activity的生命周期变化，在该类的scheduleTransaction函数中，Activity的每一种生命周期类型均被包装成一个ClientTransaction来处理，在该函数中添加日志，打印调用栈，即可确定是那个地方销毁了SingleInstanceActivity，添加日志的代码如下：

随后编译framework.jar并push到设备上，查看日志，可以看到SingleInstanceActivity是在Task类的removeActivities方法中被销毁的，日志如下：

按照如上的思路，逐步类推，添加日志，查看调用栈，我们最终追溯到ActivityThread的handleResumeActivity，在该函数的最后，添加的IdlerHandler里面会执行RecentTasks的onActivityIdle方法，在该函数的调用流程里，会判断当前resume的Activity是不是桌面，是的话在HiddenTask不为空的情况下，就会执行removeUnreachableHiddenTasks的逻辑，销毁SingleInstanceActivity(这里的代码分支为android-13.0.0_r31)。

完整的正向调用流程如下图所示：

remove-hidden-task机制

前文中我们已经跟踪到Activity销毁的调用流程，那么为什么要销毁SingleInstanceActivity呢？我们继续看前文中的日志，可以看出Activity销毁的原因是：remove-hidden-task。

那么这个remove-hidden-task到底是用来干嘛的呢？我们来看下代码提交信息：

从代码提交说明不难看出，这里的意思是：当我们向最近任务列表中添加一个任务时，会移除已不可达/未激活的Task，这里我们的SingleInstanceActivity所在的Task被判定为不可达/未激活状态，所以被这套机制移除了。

不可达/未激活的Task

那么为什么SingleInstanceActivity被认为是不可达的呢？我们进一步追踪代码，可以看到RencentTasks.removeUnreachableHiddenTasks移除的是mHiddenTasks中的任务，代码如下：

这样我们就只需要搞清楚什么样的Task会被加入mHiddenTasks中即可，mHiddenTasks.add的调用代码如下所示：

从上述代码可知，在removeForAddTask中通过findRemoveIndexForAddTask来查找当给定Task添加到最近任务列表时，需要被移除的Task，在findRemoveIndexForAddTask中最典型的一种场景就是当两个Task的TaskAffinity相同时，当后来的Task被添加到最近任务列表时，前一个Task会被销毁，这也就意味着在SingleInstanceActivity按Home键，MainActivity也会被销毁，经过实践，确实是这样。

解决方案

前文中已探讨了remove-hidden-task的运行机制，那么解决方案也就很简单了，给SingleInstanceActivity添加独立的TaskAffinity即可(注意：此时SingleInstanceActivity会显示在最近任务中，如果不想显示，请指定android:excludeFromRecents=“true”)。

影响范围

经排查，Google Pixel记性从Android 12开始支持该特性，针对国内定制厂商而言，大多数应该是在Android 13跟进的，大家可以测试看看。