如何用.NET Maui.iOS创建Firebase动态链接？解决地址无效问题

一、现有操作的错误点排查 #

• App Store ID不能填随机值：哪怕应用未上架，也必须在Apple Developer后台（免费账号可访问）创建真实的App ID（Bundle ID），随机ID会导致苹果验证失败，直接触发地址无效提示。
• Entitlements.plist配置遗漏细节：免费账号虽无法使用正式发布配置文件，但本地调试时需确保com.apple.developer.associated-domains字段格式正确，应为applinks:example.page.link（不要带http/https前缀）。
• GoogleService-Info.plist一致性检查：确认文件内的BUNDLE_ID、REVERSED_CLIENT_ID与你项目的Bundle ID完全匹配，大小写也必须一致。
• Xcode本地配置缺失：需用Xcode打开Maui的iOS项目，在「Signing & Capabilities」中添加「Associated Domains」并填入正确的动态链接域名，免费账号可临时启用该功能用于本地测试。

二、Maui免费配置完整步骤 #

1. 注册免费Apple Developer账号：前往苹果开发者官网注册免费账号，无需付费订阅，即可创建App ID并进行本地调试配置。
2. 创建真实App ID：登录Apple Developer后台，进入「Certificates, Identifiers & Profiles」，创建新的App ID（格式如com.yourname.yourapp），此ID需同步到Maui项目和Firebase配置中。
3. Firebase项目同步配置：
   • 在Firebase控制台项目设置的iOS应用配置中，填入真实的App ID和免费账号的Team ID（可在Apple Developer后台「Account」页面查看）。
   • 重新下载GoogleService-Info.plist，替换Maui项目iOS目录下的旧文件。
4. Maui项目本地配置：
   • 打开项目iOS目录的Info.plist，确保CFBundleIdentifier与创建的App ID完全一致。
   • 编辑Entitlements.plist，添加com.apple.developer.associated-domains数组，数组内添加字符串applinks:你的动态链接域名（例如applinks:example.page.link）。
   • 用Xcode打开Maui的iOS项目（路径为Platforms/iOS/你的项目名.csproj），在「Signing & Capabilities」中选择你的免费账号作为Team，添加「Associated Domains」并填入正确域名。
5. 真机测试动态链接：
   • 将测试设备连接到电脑，确保设备与电脑在同一网络环境，通过Xcode直接运行Maui应用到真机（模拟器可能存在验证问题，建议用真机测试）。
   • 在Safari中打开你的动态链接，测试是否能正常跳转至应用。

三、额外注意事项 #

• 免费账号生成的Provisioning Profile仅用于本地调试，无法用于发布，但足以完成动态链接的功能验证。
• 可使用苹果官方的关联域名验证工具，输入你的动态链接域名，检查apple-app-site-association文件是否格式正确、配置有效。
• 确保Firebase控制台中配置的动态链接短域名与apple-app-site-association文件的域名完全对应。

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