Android端React Native应用接收Files分享时状态重置问题排查

问题背景 #

我的React Native应用通过react-native-share-menu组件接收其他Android应用的文件分享，从图库类应用分享时功能正常，但在部分设备的系统“Files”应用分享时出现异常：Intent能正常发送，应用可以启动或回到前台，但应用状态会被重置，导致运行异常。核心疑问是：与图库等应用相比，部分设备的Files应用发送的Intent存在哪些差异？

MainActivity配置 #

<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask"
    android:windowSoftInputMode="adjustResize"
    android:exported="true"
    android:alwaysRetainTaskState="true"
    android:documentLaunchMode="never">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
        <action android:name="android.intent.action.DOWNLOAD_COMPLETE"/>
    </intent-filter>

    <!-- react-native-share-menu -->
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
            <data android:mimeType="*/*"/>
    </intent-filter>
</activity>

Intent日志对比 #

正常Intent日志（来自图库应用） #

03-25 11:16:39.502   672  4613 I ActivityManager: START u0 {act=android.intent.action.SEND typ=application/pdf flg=0xb080001 cmp=com.geo.geoop.dev/com.geo.MainActivity clip={application/pdf U:content://com.google.android.apps.nbu.files.provider/2/3875} (has extras)} from uid 10117, pid -1
03-25 11:16:39.520   672  4613 I ActivityManager: Ignoring FLAG_ACTIVITY_NEW_DOCUMENT, launchMode is "singleInstance" or "singleTask"
03-25 11:16:39.547   672  4613 I ActivityManager: ->startActivity for ActivityRecord{60fe743 u0 com.geo.geoop.dev/com.geo.MainActivity t44} result:START_TASK_TO_FRONT

异常Intent日志（来自Files应用） #

03-25 11:24:49.029   672  1654 I ActivityManager: START u0 {act=android.intent.action.SEND typ=application/pdf flg=0x13000001 pkg=com.geo.geoop.dev cmp=com.geo.geoop.dev/com.geo.MainActivity clip={application/pdf U:content://com.google.android.apps.nbu.files.provider/2/3876} (has extras)} from uid 10309, pid 11323
03-25 11:24:49.057   672  1654 I ActivityManager: ->startActivity for ActivityRecord{88d66b2 u0 com.geo.geoop.dev/com.geo.MainActivity t47} result:START_TASK_TO_FRONT

两者Flags差异 #

正常版本Flags：

• 0x00080000 FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
• 0x08000000 FLAG_RECEIVER_NO_ABORT
• 0x04000000 FLAG_ACTIVITY_CLEAR_TOP

异常版本Flags：

• 0x10000000 FLAG_ACTIVITY_NEW_TASK
• 0x02000000 FLAG_ACTIVITY_FORWARD_RESULT

问题代码定位 #

排查react-native-share-menu库代码后，发现以下逻辑是导致应用状态重置的原因：删除这段代码后，应用不再崩溃，但会出现Files应用图标与我的应用关联异常（点击Files图标会打开我的应用）。

public void getSharedText(Callback successCallback) {
    Activity currentActivity = getCurrentActivity();

    if (currentActivity == null) {
        return;
    }

    // If this isn't the root activity then make sure it is
    if (!currentActivity.isTaskRoot()) {
        Intent newIntent = new Intent(currentActivity.getIntent());
        newIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        currentActivity.startActivity(newIntent);

        ReadableMap shared = extractShared(newIntent);
        successCallback.invoke(shared);
        clearSharedText();
        currentActivity.finish();
        return;
    }

    Intent intent = currentActivity.getIntent();

    ReadableMap shared = extractShared(intent);
    successCallback.invoke(shared);
    clearSharedText();
}

问题分析与修复方案 #

1. Intent Flags差异的影响 #

Files应用发送的Intent携带了FLAG_ACTIVITY_NEW_TASK和FLAG_ACTIVITY_FORWARD_RESULT：

• FLAG_ACTIVITY_NEW_TASK：原本会在新任务栈启动Activity，但你的MainActivity设置为singleTask模式，系统会将已有任务栈调到前台，但配合代码中的逻辑会打乱栈结构。
• FLAG_ACTIVITY_FORWARD_RESULT：表示当前Activity需将结果返回给调用它的前一个Activity，这会干扰任务栈的正常状态流转。

而图库应用的Intent携带FLAG_ACTIVITY_CLEAR_TOP，会将栈内已存在的MainActivity实例调到顶部并清除其上方的Activity，符合singleTask的预期行为。

2. 库代码的问题 #

代码中判断!currentActivity.isTaskRoot()时，会创建新Intent并添加FLAG_ACTIVITY_NEW_TASK，然后finish当前Activity。在Files应用的场景下：

• 原Intent已携带FLAG_ACTIVITY_NEW_TASK，重复添加会导致系统错误复用任务栈，进而重置应用状态。
• 调用currentActivity.finish()会破坏原任务栈结构，导致Files应用的任务栈与你的应用栈关联混乱，出现图标点击异常。

3. 修复方案 #

修改库代码逻辑，避免重复添加冲突Flag，同时调整任务栈处理逻辑：

public void getSharedText(Callback successCallback) {
    Activity currentActivity = getCurrentActivity();

    if (currentActivity == null) {
        return;
    }

    Intent intent = currentActivity.getIntent();
    ReadableMap shared = extractShared(intent);

    // 仅当当前Activity不是根Activity且Intent未携带NEW_TASK时，才执行栈调整
    if (!currentActivity.isTaskRoot() && (intent.getFlags() & Intent.FLAG_ACTIVITY_NEW_TASK) == 0) {
        Intent newIntent = new Intent(intent);
        newIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
        currentActivity.startActivity(newIntent);
        currentActivity.finish();
    }

    successCallback.invoke(shared);
    clearSharedText();
}

或者更简洁的处理：直接复用当前Intent的Flag，避免手动添加FLAG_ACTIVITY_NEW_TASK，同时移除finish()调用，改为更新当前Activity的Intent：

public void getSharedText(Callback successCallback) {
    Activity currentActivity = getCurrentActivity();

    if (currentActivity == null) {
        return;
    }

    Intent intent = currentActivity.getIntent();
    ReadableMap shared = extractShared(intent);

    // 如果不是根Activity，更新当前Activity的Intent并清除冲突Flag
    if (!currentActivity.isTaskRoot()) {
        currentActivity.setIntent(intent);
        intent.setFlags(intent.getFlags() & ~Intent.FLAG_ACTIVITY_FORWARD_RESULT);
    }

    successCallback.invoke(shared);
    clearSharedText();
}

额外建议 #

• 检查MainActivity的android:documentLaunchMode="never"是否合理，确保不会影响文件分享的任务栈处理。
• 测试时覆盖多台不同品牌的设备（如三星、小米、谷歌原生系统），验证修复后的兼容性。

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