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+ 的最新维护版)
在
中声明权限:
初始化
,连接后调用
获取商品信息(需传入在 Play Console 创建的 product ID)
用户点击购买时,用
启动支付流程;结果通过
回调接收
务必验证购买凭证(推荐在服务端用 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+ 推荐):引用
命名空间,调用
查询商品,再用
发起交易
监听
流获取购买结果,成功后调用
测试必须用 App Store Connect 创建的
沙盒测试账号
,不能用主 Apple ID
跨平台封装建议
避免在平台项目里直接写业务逻辑,推荐分层设计:
凹凸工坊-AI手写模拟器
AI手写模拟器,一键生成手写文稿
下载
定义统一接口如
,含
、
、
等方法
Android 实现类注入
,iOS 实现类依赖
,均在各自平台项目中注册为依赖服务
在 MAUI 共享项目中调用接口,UI 层只关心状态(如加载中、已购买、错误提示),不感知平台细节
订阅购买结果时,用
或
通知界面更新,避免内存泄漏
上线前必查项
两个平台审核都极重视 IAP 合规性,漏一项可能导致被拒:
Google Play:商品价格层级已设置、应用状态为
“Draft” 或 “In Review”
、测试账号已添加到内部测试轨道
App Store:Bundle ID 与 App Store Connect 完全一致、IAP 商品状态为
“Approved”
、沙盒账号已在 App Store Connect 的“TestFlight & Sandbox”中创建
双方都要求提供清晰的购买说明页面,且不能绕过官方支付(如禁止跳转网页支付)
所有消耗型商品必须提供恢复购买入口(Restore Purchases 按钮)
基本上就这些。不复杂但容易忽略的是凭证校验和服务端对账——别只信客户端回调。
AndroidManifest.xmlBillingClientquerySkuDetailsAsynclaunchBillingFlowonPurchasesUpdatedStoreKitProduct.products(for: [productID])purchase()Transaction.updatesfinishTransaction()IInAppPurchaseServiceGetProductsAsyncBuyAsyncRestorePurchasesAsyncBillingClientStoreKitWeakEventManagerINotifyPropertyChanged