MAUI 本身不内置应用内购买(IAP)功能,需分别对接 Google Play Billing(Android)和 StoreKit(iOS),再通过平台抽象层统一调用。关键不是“写一次代码就跑通两端”,而是按平台规范实现、再封装共用逻辑。
Android 端:集成 Google Play Billing
在 MAUI Android 项目中需显式引入 Billing SDK,并处理生命周期与异步回调:
通过 NuGet 安装 Xamarin.GooglePlay.Billing(注意兼容 .NET 8+ 的最新维护版) 在AndroidManifest.xml中声明权限:
<uses-permission android:name="com.android.vending.BILLING"></uses-permission>初始化
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 按钮)基本上就这些。不复杂但容易忽略的是凭证校验和服务端对账——别只信客户端回调。
