Flutter：url_launcher在iOS无法唤起App但Android正常的问题

问题分析 #

你遇到的问题是：Android上能正常通过url_launcher唤起Salesforce完成SSO，但iOS上canLaunchUrl返回true，却只会在Safari中打开链接，无法唤起原生App。注意：canLaunchUrl返回true仅表示存在能处理该链接的应用（比如Safari），并不代表Salesforce App会被优先唤起。这通常和iOS的通用链接（Universal Links）配置、url_launcher的参数设置，或者系统对链接的优先级处理有关。

可能的解决方法 #

1. 验证Salesforce的通用链接配置 #

iOS的通用链接需要目标App（这里是Salesforce）与你的SSO域名（sprint48-qa.test.com）完成关联。请确认：

• 你的域名服务器上存在apple-app-site-association文件，且该文件已正确配置Salesforce App的Team ID和Bundle ID。
• Salesforce App已在其Apple开发者后台配置了该域名的关联。
  如果这一步未完成，iOS会默认将HTTPS链接导向Safari，而非Salesforce App。

2. 调整url_launcher的启动模式和参数 #

尝试修改launchUrl的参数，强制使用非浏览器的外部应用启动模式，并添加iOS专属配置：

final uri = Uri.parse(url);
bool canLaunch = await canLaunchUrl(uri);
if (canLaunch) {
  await launchUrl(
    uri,
    mode: LaunchMode.externalNonBrowserApplication,
    webOnlyWindowName: '_self',
    // iOS专属配置，仅尝试通过通用链接唤起App
    universalLinksOnly: true,
  );
}

• LaunchMode.externalNonBrowserApplication：优先唤起非浏览器的外部应用。
• universalLinksOnly: true：跳过浏览器回退，仅尝试用通用链接唤起目标App。

3. 修正Info.plist的配置 #

当前的LSApplicationQueriesSchemes仅添加了http/https，这会导致canLaunchUrl返回true（因为Safari能处理），但无法确保Salesforce App被唤起。可以补充Salesforce的自定义URL scheme（如果适用）：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>http</string>
    <string>https</string>
    <string>salesforce</string> <!-- 添加Salesforce的自定义scheme -->
</array>

另外，确保你的App已开启对通用链接的支持，在Info.plist中添加：

<key>NSUserActivityTypes</key>
<array>
    <string>NSUserActivityTypeBrowsingWeb</string>
</array>

4. 尝试使用Salesforce自定义Scheme #

如果通用链接配置困难，可以尝试将SSO链接转换为Salesforce的自定义scheme格式（例如salesforce://sso?url=你的HTTPS链接），但需要确认你的SSO服务支持这种方式。示例代码：

// 对原HTTPS链接进行URL编码
final encodedUrl = Uri.encodeComponent(url);
final salesforceUri = Uri.parse('salesforce://sso?url=$encodedUrl');
if (await canLaunchUrl(salesforceUri)) {
  await launchUrl(salesforceUri, mode: LaunchMode.externalApplication);
} else {
  // 回退到原HTTPS链接
  await launchUrl(Uri.parse(url));
}

5. 排查系统级的链接处理优先级 #

有些情况下，iOS系统会优先使用默认浏览器打开链接，即使通用链接已配置。可以测试以下操作：

• 在Safari中手动打开该SSO链接，看是否会弹出“打开Salesforce”的提示。
• 确认Salesforce App已更新到最新版本，旧版本可能不支持该域名的通用链接。

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