Xamarin Android应用相机扫码打开时嵌入相机应用的问题排查

问题背景 #

我开发了一款Xamarin应用，期望用户使用相机扫描二维码时直接打开该应用，目前Android和iOS平台均已实现该功能。但在部分设备（如Android 13的Pixel 4XL、Android 12的Sony Xperia XQ-BT52）上出现异常：扫码后会跳转至存放assetlinks.json的网页，随后应用在相机应用内部打开；而在Pixel 4XL模拟器中使用adb命令 adb shell am start -W -a android.intent.action.VIEW -d "web-site-url" 测试功能正常。

当前MainActivity.cs中的Intent Filter配置如下：

[IntentFilter(new[] { Android.Content.Intent.ActionView },
        DataScheme = "https",
        DataHost = "web-site-url",
        DataPathPrefix = "/",
        AutoVerify = true,
        Categories = new[] { Android.Content.Intent.ActionView, Android.Content.Intent.CategoryDefault, Android.Content.Intent.CategoryBrowsable })]

assetlinks.json配置如下：

{
  "statements": [
    {
      "source": {
        "web": {
          "site": "web-site-url."
        }
      },
      "relation": "delegate_permission/common.handle_all_urls",
      "target": {
        "androidApp": {
          "packageName": "package-name",
          "certificate": {
            "sha256Fingerprint": "[cert hash]"
          }
        }
      }
    }
  ],
}

问题 #

这种应用在相机内打开的情况为何会发生？如何让应用以独立实例打开？

原因分析 #

1. 应用链接验证失败：部分设备上assetlinks.json存在格式或内容错误，导致系统无法确认应用与目标网站的关联关系，因此先跳转至网页，再由网页唤起应用。而部分相机应用会用内置WebView加载网页，进而在自身进程内启动你的应用。
2. Intent Filter配置错误：当前配置的Categories中错误包含了ActionView——Categories字段仅用于声明Intent类别，ActionView属于动作类型，这个错误会干扰系统的Intent匹配逻辑，导致部分设备的相机应用采用非标准方式唤起应用。
3. 厂商定制化行为：谷歌、索尼等部分厂商对相机应用的扫码链接处理做了定制，当应用链接验证存疑时，会优先在相机内部的Web容器中处理请求，而非直接唤起独立的应用实例。

解决方案 #

1. 修正Intent Filter配置 #

移除Categories中的Android.Content.Intent.ActionView，正确配置如下：

[IntentFilter(new[] { Android.Content.Intent.ActionView },
        DataScheme = "https",
        DataHost = "web-site-url",
        DataPathPrefix = "/",
        AutoVerify = true,
        Categories = new[] { Android.Content.Intent.CategoryDefault, Android.Content.Intent.CategoryBrowsable })]

CategoryDefault是隐式Intent必须的类别，CategoryBrowsable允许浏览器、相机等应用唤起你的应用，错误添加的动作类型会破坏Intent匹配规则。

2. 修复assetlinks.json的格式与内容错误 #

原配置存在末尾多余逗号、site字段格式不规范、relation类型错误等问题，修正后的配置：

{
  "statements": [
    {
      "source": {
        "web": {
          "site": "https://web-site-url"
        }
      },
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
        "androidApp": {
          "packageName": "package-name",
          "certificate": {
            "sha256Fingerprint": "[cert hash]"
          }
        }
      }
    }
  ]
}

注意要点：

• site字段必须包含完整的https://协议前缀，且末尾不能加多余的点
• relation字段需为数组类型，部分系统对此有严格要求
• 确保JSON格式无语法错误（如多余逗号）

3. 设置应用启动模式为独立实例 #

在MainActivity的ActivityAttribute中添加LaunchMode = Android.Content.PM.LaunchMode.SingleTask，强制应用以独立任务栈启动，避免被嵌入到相机进程中：

[Activity(Label = "YourAppName", LaunchMode = Android.Content.PM.LaunchMode.SingleTask, /* 其他原有属性 */)]
public class MainActivity : AppCompatActivity
{
    // 你的代码逻辑
}

SingleTask模式下，系统会为应用创建独立的任务栈，无论从哪个应用唤起，都会启动为独立的应用实例。

4. 验证应用链接配置有效性 #

• 直接访问https://web-site-url/.well-known/assetlinks.json，确认能正常加载且JSON格式无误
• 在设备上执行命令 adb shell pm verify-app-links --re-verify package-name，查看验证结果，确保应用链接已通过系统验证

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