使用url_launcher打开含AWS链接的itms-services URL失败求助

问题描述 #

使用url_launcher库打开itms-services协议链接以实现iOS企业版APP强制更新时，触发"Invalid input URL"错误，无法启动APP下载流程。

复现代码 #

final uri = Uri(path: 'itms-services://?action=download-manifest&url=https://awsservice.com/build/manifest.plist');
if (await canLaunchUrl(uri)) {
  await launchUrl(uri);
} else {
  throw 'Could not launch $url';
}

报错信息 #

-canOpenURL: failed for URL: "itms-services://?action=download-manifest&url=https://awsservice.com/build/manifest.plist" - error: "Invalid input URL"

Failed to open URL itms-services%3A//%3Faction=download-manifest&url=https://awsservice.com/build/manifest.plist: Error Domain=NSOSStatusErrorDomain Code=-50 "invalid input parameters" UserInfo={NSDebugDescription=invalid input parameters, _LSLine=249, _LSFunction=-[_LSDOpenClient openURL:fileHandle:options:completionHandler:]}

已尝试但无效的操作：

• 对URL字符串进行编码：Uri(path: Uri.encodeFull(url));
• 在Info.plist中添加itms-services为UrlScheme

解决方法 #

核心问题是Uri构造方式错误，Uri(path: ...)会将传入的字符串当作路径处理，导致协议部分被错误编码，iOS无法识别正确的itms-services协议。

方案1：使用Uri.parse直接解析完整URL #

final uri = Uri.parse('itms-services://?action=download-manifest&url=https://awsservice.com/build/manifest.plist');
if (await canLaunchUrl(uri)) {
  await launchUrl(uri);
} else {
  throw 'Could not launch $uri';
}

方案2：用Uri构造器拆分协议与查询参数 #

这种方式更安全，避免手动拼接URL时的编码问题：

final uri = Uri(
  scheme: 'itms-services',
  queryParameters: {
    'action': 'download-manifest',
    'url': 'https://awsservice.com/build/manifest.plist',
  },
);
if (await canLaunchUrl(uri)) {
  await launchUrl(uri);
} else {
  throw 'Could not launch $uri';
}

额外检查点 #

• 确认manifest.plist文件可通过HTTPS访问，且文件格式符合iOS企业分发要求（bundle ID与当前APP匹配、签名有效等）
• 测试需使用真实iOS设备，模拟器不支持企业版APP安装流程
• url_launcher无需额外配置itms-services scheme，iOS系统默认支持该协议

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