MAUI需分别对接Google Play Billing和StoreKit实现IAP,Android端集成Billing SDK并验证purchase token,iOS端用StoreKit 2查询商品并处理Transaction更新,跨平台通过IInAppPurchaseService接口封装,上线前须确保双平台商品状态、测试账号及凭证校验合规。

MAUI 本身不内置应用内购买(IAP)功能,需分别对接 Google Play Billing(Android)和 StoreKit(iOS),再通过平台抽象层统一调用。关键不是“写一次代码就跑通两端”,而是按平台规范实现、再封装共用逻辑。
Android 端:集成 Google Play Billing
在 MAUI Android 项目中需显式引入 Billing SDK,并处理生命周期与异步回调:
- 通过 NuGet 安装 Xamarin.GooglePlay.Billing(注意兼容 .NET 8+ 的最新维护版)
- 在
AndroidManifest.xml中声明权限: - 初始化
BillingClient,连接后调用querySkuDetailsAsync获取商品信息(需传入在 Play Console 创建的 product ID) - 用户点击购买时,用
launchBillingFlow启动支付流程;结果通过onPurchasesUpdated回调接收 - 务必验证购买凭证(推荐在服务端用 Google Play Developer API 验证 purchase token)
iOS 端:接入 StoreKit 2(推荐)或 StoreKit 1
iOS 要求严格签名与配置,且必须使用真机测试(模拟器不支持 IAP):
- 确保已启用自动预配,并在 Apple Developer Portal 中为 App ID 开启 In-App Purchase 功能
- 在 App Store Connect 创建对应商品(Product ID 必须与代码中完全一致),状态设为 Ready to Submit 或 Approved
- 使用 StoreKit 2(.NET 7+ / iOS 15.0+ 推荐):引用
StoreKit命名空间,调用Product.products(for: [productID])查询商品,再用purchase()发起交易 - 监听
Transaction.updates流获取购买结果,成功后调用finishTransaction() - 测试必须用 App Store Connect 创建的 沙盒测试账号,不能用主 Apple ID
跨平台封装建议
避免在平台项目里直接写业务逻辑,推荐分层设计:
- 定义统一接口如
IInAppPurchaseService,含GetProductsAsync、BuyAsync、RestorePurchasesAsync等方法 - Android 实现类注入
BillingClient,iOS 实现类依赖StoreKit,均在各自平台项目中注册为依赖服务 - 在 MAUI 共享项目中调用接口,UI 层只关心状态(如加载中、已购买、错误提示),不感知平台细节
- 订阅购买结果时,用
WeakEventManager或INotifyPropertyChanged通知界面更新,避免内存泄漏
上线前必查项
两个平台审核都极重视 IAP 合规性,漏一项可能导致被拒:
- Google Play:商品价格层级已设置、应用状态为 “Draft” 或 “In Review”、测试账号已添加到内部测试轨道
- App Store:Bundle ID 与 App Store Connect 完全一致、IAP 商品状态为 “Approved”、沙盒账号已在 App Store Connect 的“TestFlight & Sandbox”中创建
- 双方都要求提供清晰的购买说明页面,且不能绕过官方支付(如禁止跳转网页支付)
- 所有消耗型商品必须提供恢复购买入口(Restore Purchases 按钮)
基本上就这些。不复杂但容易忽略的是凭证校验和服务端对账——别只信客户端回调。










