iOS URL Scheme模拟器Safari可用，真机Safari无法打开问题排查

核心原因分析 #

• URL Scheme权限未在真机打包配置中声明
  你提供的entitlements-release.plist和entitlements-debut.plist仅包含推送环境配置，完全没有URL Scheme相关的权限声明。iOS 15及更早版本对URL Scheme的权限管控更严格，真机打包时必须在权限文件里明确声明Scheme，否则Safari会判定地址无效；而iOS 16模拟器放宽了本地调试的权限校验，所以能正常唤起。
• Cordova打包同步配置遗漏
  Cordova项目的URL Scheme通常在config.xml中配置，但如果打包脚本未将该配置同步到iOS的权限文件，真机打包后就会缺失对应权限，导致Scheme无法生效。

具体解决步骤 #

1. 检查config.xml的Scheme配置
   确认config.xml已正确添加URL Scheme配置，示例格式如下：

   <plugin name="cordova-plugin-customurlscheme" spec="~5.0.2">
       <variable name="URL_SCHEME" value="myapp" />
       <variable name="ANDROID_SCHEME" value="myapp" />
       <variable name="ANDROID_HOST" value="localhost" />
       <variable name="ANDROID_PATHPREFIX" value="/" />
   </plugin>
   

2. 补全entitlements文件的权限声明
   在entitlements-release.plist和entitlements-debut.plist中添加URL Scheme与Universal Links的权限项，修改后的文件示例：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>aps-environment</key>
       <string>production</string>
       <!-- 通用链接权限 -->
       <key>com.apple.developer.associated-domains</key>
       <array>
           <string>applinks:你的通用链接域名</string>
       </array>
       <!-- URL Scheme权限 -->
       <key>com.apple.developer.url-schemes</key>
       <array>
           <string>myapp</string>
       </array>
   </dict>
   </plist>
   

   注意替换你的通用链接域名为实际域名，myapp为你使用的Scheme名称。

3. 重新打包验证
   修改完成后，用Cordova重新打包iOS项目，安装到iPhone 7真机，再在Safari中输入myapp://测试唤起效果。

补充说明 #

iOS 16之后苹果调整了URL Scheme的权限校验逻辑，模拟器环境允许未声明的Scheme唤起，但旧版本系统（iOS 15及以下）的真机要求严格配置权限文件；Android端无此严格限制，因此模拟器和真机均能正常工作。

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