一次编码，双端变现：MAUI跨平台应用内购买完整集成指南
项目地址: https://gitcode.com/GitHub_Trending/ma/maui 你是否正在为.NET MAUI应用实现应用内购买（In-App Purchase）功能而头疼？既要对接Google Play的结算系统，又要适配App Store的支付流程，还要处理跨平台代码的兼容性——本文将带你一站式解决这些难题，实现一套代码同时支持Android和iOS的应用内购买功能。
为什么选择MAUI实现应用内购买
.NET MAUI（Multi-platform App UI）作为微软推出的跨平台应用开发框架，允许开发者使用C#和.NET编写一次代码，即可运行在iOS、Android、Windows等多个平台。对于应用内购买功能而言，MAUI的优势在于：
- 代码复用：核心购买逻辑可在各平台间共享，仅需针对平台特定需求编写少量适配代码
- 原生性能：通过MAUI的Handler机制直接调用平台原生API，保证支付流程的稳定性和安全性
- 统一管理：使用C#的强类型特性，统一管理不同平台的商品ID、支付状态和错误处理
MAUI应用架构示意图，展示了共享代码如何通过Handlers与各平台原生API交互
应用内购买核心概念与工作流程
在开始编码前，我们需要先了解应用内购买的基本概念和工作流程：
核心概念
- 商品（Product）：用户可购买的虚拟物品，分为消耗型（如游戏币）、非消耗型（如高级功能解锁）和订阅型（如月度会员）
- 订单（Order）：记录用户购买行为的实体，包含商品信息、价格、支付状态等
- 收据（Receipt）：支付完成后由应用商店生成的购买凭证，用于验证交易合法性
工作流程
- 应用启动时连接应用商店服务
- 从商店加载商品信息并展示给用户
- 用户选择商品后发起购买请求
- 处理商店返回的购买结果
- 验证购买凭证合法性
- 向用户授予购买的商品或服务
开发环境准备
在开始实现前，请确保你的开发环境满足以下要求：
开发工具
- Visual Studio 2022 17.3或更高版本（安装MAUI工作负载）
- .NET 7 SDK或更高版本
- 相应平台的开发工具：
- Android：Android Studio（用于获取Google Play结算库）
- iOS：Xcode（用于配置App Store连接）
账号准备
- Google Play开发者账号（需付费注册）
- Apple开发者账号（需付费注册）
- 应用已在相应商店创建并配置应用内商品
实现步骤：从基础架构到平台适配
1. 创建共享服务接口
首先，我们需要定义一个抽象的应用内购买服务接口，以便在共享代码中使用：
public interface IInAppPurchaseService
{
// 初始化服务
Task InitializeAsync();
// 获取商品信息
Task<IEnumerable<Product>> GetProductsAsync(IEnumerable<string> productIds);
// 发起购买
Task<PurchaseResult> PurchaseAsync(string productId);
// 恢复购买
Task<IEnumerable<Purchase>> RestorePurchasesAsync();
// 验证购买收据
Task<bool> VerifyReceiptAsync(string receipt);
}
这个接口定义了应用内购买所需的核心功能，包括初始化服务、获取商品、发起购买、恢复购买和验证收据等操作。
2. 实现平台特定服务
接下来，我们需要为Android和iOS平台分别实现上述接口。
Android平台实现（Google Play）
Android平台使用Google Play Billing Library与Google Play商店交互。我们需要创建一个GooglePlayInAppPurchaseService类：
public class GooglePlayInAppPurchaseService : IInAppPurchaseService
{
private BillingClient _billingClient;
private bool _isInitialized;
public async Task InitializeAsync()
{
// 初始化BillingClient
_billingClient = BillingClient.NewBuilder(Android.App.Application.Context)
.EnablePendingPurchases()
.SetListener(new PurchaseUpdatedListener())
.Build();
var connectionState = await _billingClient.StartConnectionAsync(
new BillingClientStateListener());
_isInitialized = connectionState.ResponseCode == BillingResponseCode.Ok;
}
// 其他方法实现...
}
iOS平台实现（App Store）
iOS平台使用StoreKit框架与App Store交互。我们需要创建一个AppStoreInAppPurchaseService类：
public class AppStoreInAppPurchaseService : IInAppPurchaseService
{
private SKProductsRequest _productsRequest;
private List<SKProduct> _products = new List<SKProduct>();
public async Task InitializeAsync()
{
// 请求App Store产品信息
return Task.FromResult(true);
}
// 其他方法实现...
}
3. 注册服务与依赖注入
在MAUI应用中，我们可以使用依赖注入（DI）模式来管理不同平台的服务实现。在MauiProgram.cs中注册服务：
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.ConfigureFonts(fonts =>
{
fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
});
// 注册应用内购买服务
builder.Services.AddSingleton<IInAppPurchaseService>(sp =>
{
#if ANDROID
return new GooglePlayInAppPurchaseService();
#elif IOS
return new AppStoreInAppPurchaseService();
#else
return new MockInAppPurchaseService(); // 其他平台使用模拟服务
#endif
});
return builder.Build();
}
}
服务注册代码位于src/Core/src/Hosting/MauiAppBuilder.cs文件中
4. 商品展示与购买流程实现
在视图模型中使用我们定义的服务来实现商品展示和购买功能：
public class StoreViewModel : BaseViewModel
{
private readonly IInAppPurchaseService _purchaseService;
private ObservableCollection<ProductViewModel> _products = new();
public ObservableCollection<ProductViewModel> Products
{
get => _products;
set => SetProperty(ref _products, value);
}
public ICommand PurchaseCommand { get; }
public StoreViewModel(IInAppPurchaseService purchaseService)
{
_purchaseService = purchaseService;
PurchaseCommand = new Command<string>(async (productId) => await PurchaseProductAsync(productId));
// 初始化并加载商品
_ = InitializeAndLoadProducts();
}
private async Task InitializeAndLoadProducts()
{
await _purchaseService.InitializeAsync();
await LoadProductsAsync();
}
private async Task LoadProductsAsync()
{
var productIds = new[] { "premium_feature", "remove_ads", "monthly_subscription" };
var products = await _purchaseService.GetProductsAsync(productIds);
foreach (var product in products)
{
Products.Add(new ProductViewModel(product));
}
}
private async Task PurchaseProductAsync(string productId)
{
var result = await _purchaseService.PurchaseAsync(productId);
if (result.IsSuccessful)
{
// 处理成功购买
await Application.Current.MainPage.DisplayAlert(
"购买成功",
$"您已成功购买: {result.ProductName}",
"确定");
}
else
{
// 处理购买失败
await Application.Current.MainPage.DisplayAlert(
"购买失败",
result.ErrorMessage,
"确定");
}
}
}
平台特定配置与权限设置
Android平台配置
- 在AndroidManifest.xml中添加必要权限：
<uses-permission android:name="com.android.vending.BILLING" />
- 添加Google Play结算库依赖：
在Android项目的.csproj文件中添加：
<ItemGroup>
<PackageReference Include="Xamarin.GooglePlay.Billing" Version="6.0.0" />
</ItemGroup>
iOS平台配置
- 在Info.plist中添加应用内购买权限：
<key>SKProductsUsageDescription</key>
<string>此应用需要访问App Store以处理应用内购买</string>
- 配置App Store连接：
在Entitlements.plist中启用应用内购买：
<key>com.apple.developer.in-app-purchase</key>
<true/>
不同平台的应用内购买配置界面对比
测试策略与最佳实践
测试环境设置
- Android：使用Google Play Console创建测试账号和测试商品，在测试设备上安装应用的测试版本
- iOS：使用App Store Connect创建沙盒测试账号，在测试设备上使用沙盒环境测试购买流程
错误处理最佳实践
- 网络错误处理：确保在网络不稳定时应用能够优雅降级
- 交易状态处理：正确处理购买过程中的各种状态，特别是待处理状态
- 收据验证：始终在后端服务器验证购买收据，不要仅依赖客户端验证
- 恢复购买：提供恢复购买功能，确保用户在重新安装应用后能够恢复已购买的商品
安全注意事项
- 敏感数据加密：对购买相关的敏感数据进行加密存储
- 防篡改措施：使用签名验证等方法防止应用被篡改
- 服务器验证：所有购买必须经过服务器验证，防止客户端伪造购买信息
结语与进阶方向
通过本文的指南，你已经了解了如何在MAUI应用中实现跨平台的应用内购买功能。从定义共享服务接口，到实现平台特定代码，再到配置和测试，我们覆盖了整个实现过程的关键步骤。
进阶方向
- 订阅管理：实现订阅型商品的生命周期管理，包括续订、取消和升级
- 促销代码：集成应用商店的促销代码功能，允许用户通过代码获取优惠
- 分析与优化：添加购买漏斗分析，优化购买流程提高转化率
- 本地化：根据用户所在地区自动适配商品价格和货币单位
完整的MAUI应用内购买流程图，展示了从商品展示到交易完成的全流程
希望本文能够帮助你顺利实现MAUI应用的应用内购买功能，为你的应用增加变现渠道。如有任何问题或建议，欢迎在项目的GitHub仓库提交issue或PR。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
