Android混合应用在Outlook中被内嵌打开而非独立启动的问题排查

这种内嵌启动的情况确实挺闹心的，我帮你梳理下问题根源和解决方案：

核心问题分析 #

你的MainActivity没有配置合适的启动模式，导致Outlook可以将你的Activity嵌入到它自身的任务栈中启动，而不是唤起独立的应用窗口。这就造成了看起来像是应用被"劫持"内嵌在Outlook里的现象。

具体解决方案 #

1. 为MainActivity指定启动模式 #

修改AndroidManifest.xml中MainActivity的标签，添加android:launchMode="singleTask"属性：

<activity
    android:name="package.name.MainActivity"
    android:exported="true"
    android:launchMode="singleTask"> <!-- 新增该属性 -->
    
    <!-- 原有Intent Filter内容保持不变 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:scheme="https"
            android:host="domain.com"
            android:port="9201" />
    </intent-filter>
</activity>

singleTask启动模式的作用是：让你的Activity在独立的任务栈中启动（如果栈不存在则创建），如果该Activity已经存在于某个任务栈中，系统会直接将整个任务栈带到前台，而不是把Activity嵌入到调用者（Outlook）的任务栈内，这样就能保证应用独立打开。

2. 为Intent Filter设置优先级（可选但推荐） #

给处理链接的intent-filter添加优先级，确保系统优先选择你的应用来处理该链接：

<intent-filter android:priority="1000"> <!-- 新增优先级配置 -->
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data
        android:scheme="https"
        android:host="domain.com"
        android:port="9201" />
</intent-filter>

优先级数值越高（最大为1000），系统越优先考虑你的应用，避免Outlook自行处理链接或用非预期方式启动你的Activity。

3. 处理已存在任务栈的唤起（可选） #

如果应用已经在后台运行，当点击Outlook中的链接时，系统会调用onNewIntent而非onCreate，可以在MainActivity中添加如下代码确保任务栈切换到前台：

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    // 将当前任务栈移到前台
    moveTaskToFront(0, 0)
}

关于WebView配置的说明 #

你当前的WebView配置是没问题的：设置了WebViewClient来拦截页面跳转、启用JavaScript和DOM存储，这些配置不会导致应用被内嵌的问题，不需要修改。

备注：内容来源于stack exchange，提问作者sluppennudel