storekit

StoreKit

非同期／待機 API、自動検証、SwiftUI との統合を活用してアプリ内購入を実装するための StoreKit 2 のパターンです。

リファレンスの読み込みガイド

内容が必要になる可能性が少しでもある場合は、必ずリファレンスファイルを読み込んでください。 パターンを見落としたり、間違えたりするより、事前にコンテキストを把握しておくほうが確実です。

リファレンス	読み込むタイミング
はじめに	.storekit 設定ファイルの作成、テスト優先のワークフロー
製品	製品の読み込み、製品タイプ、Product.purchase() による購入
サブスクリプション	自動更新サブスクリプション、サブスクリプショングループ、オファー、更新の追跡
トランザクション	トランザクションリスナー、検証、トランザクションの完了、購入の復元
StoreKit のビュー	SwiftUI の ProductView、SubscriptionStoreView、SubscriptionOfferView

コアワークフロー

1. まず .storekit 設定ファイルを作成します（コードを書く前に）
2. Xcode シミュレータで購入をローカルテストします
3. @MainActor を使用して StoreManager を一元化します
4. アプリ起動時に Transaction.updates リスナーを設定します
5. ProductView またはカスタム UI で製品を表示します
6. エンタイトルメントを付与した後は、必ず transaction.finish() を呼び出します

基本アーキテクチャ

@MainActor
final class StoreManager: ObservableObject {
    @Published private(set) var products: [Product] = []
    @Published private(set) var purchasedProductIDs: Set<String> = []
    private var transactionListener: Task<Void, Never>?

    init() {
        transactionListener = listenForTransactions()
        Task { await loadProducts() }
    }
}

よくある間違い

1. トランザクションで .finish() を呼び出し忘れる — エンタイトルメントを付与した後に transaction.finish() を呼び出さないと、トランザクションが完了しません。ユーザーには購入が反映されません。必ず finish() を呼び出してください。

2. StoreManager の状態が安全でない — @MainActor を指定せずに StoreManager を共有すると、競合状態が発生する可能性があります。複数の非同期タスクが @Published プロパティを同時に更新し、状態が破損することがあります。スレッドセーフにするため、@MainActor を使用してください。

3. アプリ起動時にトランザクションリスナーを設定しない — Transaction.updates リスナーを設定していないと、アプリがクラッシュしたり、返金・キャンセルされた購入を見落としたりする可能性があります。ユーザーが購入ボタンをタップしたときではなく、@main で直ちにトランザクションを監視してください。

4. 製品 ID をハードコードする — ID をハードコードすると、テストやローカライズが難しくなります。製品 ID には設定ファイルまたは環境変数を使用してください。価格にも同じことが当てはまります（App Store から取得し、ハードコードしないでください）。

5. 検証の失敗を無視する — App Store の検証は、ときどき通知なく失敗します。検証ステータスを確認しないと、未検証のトランザクションを受け入れてしまう可能性があります（セキュリティ上のリスク）。エンタイトルメントを付与する前に、必ず検証してください。