Apple App Store Server Library Java版完整配置指南

2026-02-06 05:03:54作者：凌朦慧Richard

Apple App Store Server Library是苹果官方推出的Java服务器库，专为简化App Store Server API、App Store Server Notifications和Retention Messaging API的集成而设计。作为苹果官方维护的开源项目，它为Java开发者提供了完整的服务器端解决方案。

项目概述与技术架构

核心功能特性

该Java库提供了与App Store服务器通信的完整能力，包括：

交易历史查询与管理
订阅状态验证与监控
服务器通知处理机制
促销优惠签名创建
收据迁移工具支持

技术栈组成

Java 11+: 基础运行环境要求
Gradle: 自动化构建工具
JWT认证: 安全令牌机制
MIT开源协议: 自由使用与分发许可

环境准备与前置配置

系统环境要求

在开始配置前，请确保开发环境满足以下条件：

已安装Java Development Kit (JDK) 11或更高版本
配置了Git版本控制工具
安装了Gradle 6.x及以上版本

苹果开发者账户配置

访问App Store Connect完成必要的密钥配置：

进入"用户与访问权限" → "集成" → "内购"
创建并下载私钥文件（.p8格式）
记录重要的Issuer ID与Key ID参数

完整安装与配置流程

项目获取与初始化

使用以下命令获取项目并完成初始化：

git clone https://gitcode.com/gh_mirrors/ap/app-store-server-library-java.git
cd app-store-server-library-java
./gradlew clean build

依赖管理配置

根据您的构建工具选择相应的依赖配置：

Gradle配置：

implementation 'com.apple.itunes.storekit:app-store-server-library:3.6.0'

Maven配置：

<dependency>
    <groupId>com.apple.itunes.storekit</groupId>
    <artifactId>app-store-server-library</artifactId>
    <version>3.6.0</version>
</dependency>

核心参数配置

在应用程序中配置关键参数：

String issuerId = "你的Issuer ID";
String keyId = "你的Key ID";
String bundleId = "你的App Bundle ID";
Path filePath = Path.of("/path/to/key/SubscriptionKey_ABCDEFGHIJ.p8");
String encodedKey = Files.readString(filePath);
Environment environment = Environment.SANDBOX;

核心功能使用指南

API客户端基础使用

创建API客户端并进行基础调用：

AppStoreServerAPIClient client =
        new AppStoreServerAPIClient(encodedKey, keyId, issuerId, bundleId, environment);

try {
    SendTestNotificationResponse response = client.requestTestNotification();
    System.out.println(response);
} catch (APIException | IOException e) {
    e.printStackTrace();
}

数据验证功能

使用签名数据验证器确保数据来源可信：

Set<InputStream> rootCAs = Set.of(
        new FileInputStream("/path/to/rootCA1"),
        new FileInputStream("/path/to/rootCA2")
);
Long appAppleId = null;

SignedDataVerifier signedPayloadVerifier = new SignedDataVerifier(rootCAs, bundleId, appAppleId, environment, true);

String notificationPayload = "ey...";

try {
    ResponseBodyV2DecodedPayload payload = signedPayloadVerifier.verifyAndDecodeNotification(notificationPayload);
    System.out.println(payload);
} catch (VerificationException e) {
    e.printStackTrace();
}

收据迁移工具

从传统收据中提取交易信息：

ReceiptUtility receiptUtil = new ReceiptUtility();
String appReceipt = "MI...";
String transactionId = receiptUtil.extractTransactionIdFromAppReceipt(appReceipt);

促销优惠签名创建

为促销活动生成安全签名：

PromotionalOfferSignatureCreator signatureCreator = new PromotionalOfferSignatureCreator(encodedKey, keyId, bundleId);

String productId = "<product_id>";
String subscriptionOfferId = "<subscription_offer_id>";
String appAccountToken = "<app_account_token>";
UUID nonce = UUID.randomUUID();
long timestamp = System.currentTimeMillis();
String encodedSignature = signatureCreator.createSignature(productId, subscriptionOfferId, appAccountToken, nonce, timestamp);
System.out.println(encodedSignature);