如何在Xamarin.Forms中实现Wallet Extension？配置后无显示问题排查

针对你在Xamarin.Forms中实现Apple Wallet Issuer Provisioning Extension后，Wallet里未显示应用条目的问题，按以下步骤逐一排查：

1. 验证Bundle ID的层级关系 #

Extension的Bundle ID必须是主应用Bundle ID的子ID，例如主App是com.yourcompany.MyApp，Extension需为com.yourcompany.MyApp.WalletExtension。Apple要求Extension的ID必须嵌套在主App ID下，否则系统无法识别两者的关联。

2. 检查Info.plist的配置完整性 #

你添加的配置项必须放在NSExtension字典的正确层级中，且类名需包含完整命名空间：

• 确保Info.plist的结构如下：

  <key>NSExtension</key>
  <dict>
      <key>NSExtensionPointIdentifier</key>
      <string>com.apple.PassKit.issuer-provisioning</string>
      <key>NSExtensionPrincipalClass</key>
      <string>WalletExtension.WalletViewController</string>
  </dict>
  

  注意NSExtensionPrincipalClass必须指定完整的命名空间+类名，Xamarin中仅写WalletViewController会导致系统找不到对应的处理类。

3. 实现PKIssuerProvisioningExtensionHandler的必要方法 #

当前你的WalletViewController仅继承了基类但未实现核心方法，系统会判定Extension不具备功能，因此不会显示。必须重写BeginProvisioningPaymentPass方法（或异步版本），示例如下：

namespace WalletExtension
{
    public partial class WalletViewController : PKIssuerProvisioningExtensionHandler
    {
        public WalletViewController(IntPtr handle) : base(handle) { }

        public override void BeginProvisioningPaymentPass(PKPaymentPass provisioningPaymentPass, PKIssuerProvisioningExtensionCompletionHandler completionHandler)
        {
            // 在这里实现初始化卡片配置的逻辑，比如获取卡片元数据
            // 调用completionHandler返回结果，即使暂时用空实现也要确保调用
            completionHandler(null, null, NSError.FromDomain("com.yourcompany.error", 0));
        }
    }
}

即使是占位实现，也必须调用completionHandler，否则系统会认为Extension无法正常工作。

4. 验证签名与权限配置 #

• Extension的Entitlements：必须添加com.apple.developer.payment-pass-provisioning权限，且配置与主App一致（比如允许的服务器域名）。
• 描述文件：确认Extension的描述文件是Extension类型，包含正确的Bundle ID，且与主App使用同一开发者账号签名。可通过解压IPA包，执行codesign -vvv YourExtension.appex检查签名有效性。
• Capabilities配置：在Xamarin项目的iOS Capabilities中，确保Extension已启用Wallet相关服务（与主App的Apple Pay配置一致）。

5. 测试环境与设备设置 #

• 首次启动Test Flight应用后，尝试重启设备，Wallet有时需要重启才能刷新已安装的Extension列表。
• 确认测试设备的iOS版本符合要求（Issuer Provisioning Extension需要iOS 12及以上）。
• 检查设备的区域设置，部分Wallet功能仅在特定地区（如美国）开放，可暂时切换到支持的区域测试。

6. 检查IPA包结构 #

解压生成的IPA文件，确认Payload/MyApp.app/PlugIns目录下存在你的Wallet Extension的.appex文件，且该文件内的Info.plist配置正确。

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