App Storeの設定に関する問題は、多くの場合、商品の承認、StoreKitの設定、bundle IDの不一致に関連しています。このセクションでは、最も一般的なiOS特有の問題を取り上げます。

問題1：商品が承認されていない、または販売できない

エラーメッセージ

warning: RevenueCat SDK is configured correctly, but contains some issues you might want to address
Warnings:
• Your products are configured in RevenueCat but aren't approved in App Store Connect yet.
  This prevents users from making purchases in production.
  Please ensure all products are approved and available for sale in App Store Connect.

よくある原因

1. 商品が審査待ち：商品を提出したものの、まだAppleの承認を受けていない場合です。
2. 商品が却下された：App審査の過程で商品が却下された場合です。
3. 契約が未締結：Paid Applications Agreementに署名していない場合です。
4. 銀行/税務情報が未完了：App Store Connectで財務情報の入力を完了していない場合です。
5. 商品が販売不可の状態：商品は存在するものの、"Available for Sale"と表示されていない場合です。

解決手順

ステップ1：App Store Connectで商品のステータスを確認

1. App Store Connectに移動します。
2. 対象のアプリを選択します。
3. In-App Purchases（一回限りの購入）またはSubscriptionsに移動します。
4. 各商品のステータスを確認します。
   • Ready to Submit：アプリのバイナリと一緒に商品を提出する必要があります。
   • Waiting for Review：提出済みで、Appleの承認待ちです。
   • Approved / Ready to Sell：準備完了です。
   • Rejected：却下の理由を確認し、問題を解決します。

ステップ2：Paid Applications Agreementへの署名

1. App Store Connectで行います。
2. Agreements, Tax, and Bankingをクリックします。
3. 保留中の契約（赤い警告アイコン）がないか確認します。
4. "Paid Applications"の横にあるRequestをクリックします。
5. 規約に記入して同意します。

ステップ3：銀行および税務情報の入力を完了

1. Agreements, Tax, and Bankingで行います。
2. Bankingセクションを完了します（銀行口座情報を追加します）。
3. Tax Formsを完了します（米国はW-9、米国以外の地域はW-8BENです）。
4. Appleの確認を待ちます（24〜48時間かかる場合があります）。

ステップ4：商品を審査に提出

1. 商品は必ずアプリのバイナリと一緒に提出する必要があります。
2. App Store Connectでアプリのバージョンに移動します。
3. 該当バージョンにアプリ内課金を追加します。
4. アプリを審査に提出します。
5. 商品はアプリと一緒に審査されます。

ステップ5：テストにStoreKit Configurationを使用（推奨）

承認を待つ代わりに、ローカルテストにはStoreKit Configuration Fileを使用します。

1. XcodeでFile → New → Fileに移動します。
2. StoreKit Configuration Fileを選択します。
3. 一致するIDで商品を追加します。
4. スキーム設定でStoreKit構成ファイルを有効にします。
5. シミュレーターと実機の両方で商品がすぐに動作します。

問題2：StoreKit Configuration Fileの問題

エラーメッセージ

Error: Product not found in StoreKit configuration
StoreKit.Error: Unknown product identifier

よくある原因

1. 商品IDの不一致：StoreKitファイルのIDがRevenueCat/App Store Connectと一致していない場合です。
2. StoreKitファイルが未有効化：構成ファイルは存在するものの、スキームで有効になっていない場合です。
3. サンドボックスの代わりにプロダクションを使用：アプリがローカルファイルではなくApp Store Connectから取得しようとしている場合です。

解決手順

ステップ1：商品IDが一致しているか確認

1. Xcodeで.storekitファイルを開きます。
2. 商品IDが次の値と完全に一致しているか確認します。
   • App Store Connectの商品ID
   • RevenueCatダッシュボードの商品ID
3. IDは大文字と小文字を区別するため、一文字も違わず一致している必要があります。

ステップ2：スキームでStoreKit Configurationを有効化

1. XcodeでProduct → Scheme → Edit Schemeに移動します。
2. 左側のパネルでRunを選択します。
3. Optionsタブに移動します。
4. StoreKit Configurationの下で.storekitファイルを選択します。
5. 再度ビルドして実行します。

ステップ3：商品の詳細を正しく構成

StoreKitファイルで、各商品に次の項目があるか確認します。

• 正しいProduct ID
• 適切なType（消耗型、非消耗型、自動更新サブスクリプション）
• 有効なPriceおよびLocale
• サブスクリプションの場合：Subscription Duration

問題3：bundle IDの不一致

エラーメッセージ

Error: The bundle identifier does not match the app configured in RevenueCat
Error: Unable to fetch products for bundle ID: com.example.wrongapp

よくある原因

1. RevenueCatのbundle IDの誤り：ダッシュボードに誤ったバンドル識別子が入力されている場合です。
2. プロビジョニングプロファイルの不一致：別のbundle ID用のプロファイルを使用している場合です。
3. 複数のアプリターゲット：誤ったターゲットのbundle IDを使用している場合です。

解決手順

ステップ1：Xcodeでbundle IDを確認

1. Xcodeのナビゲーターでプロジェクトを選択します。
2. アプリのターゲットを選択します。
3. Generalタブに移動します。
4. Bundle Identifierフィールドを確認します。
5. この値を正確にコピーします。

ステップ2：RevenueCatでbundle IDを確認

1. RevenueCatダッシュボードに移動します。
2. 対象のプロジェクトに移動します。
3. Apps & providers → App Storeに移動します。
4. bundle IDがXcodeのbundle IDと完全に一致しているか確認します。
5. 必要であれば修正します。

ステップ3：プロビジョニングプロファイルを確認

1. XcodeでSigning & Capabilitiesタブに移動します。
2. プロビジョニングプロファイルがbundle IDと一致しているか確認します。
3. 自動署名を使用している場合は、Xcodeが自動的に処理します。
4. 手動署名を使用している場合は、Apple Developerポータルから正しいプロファイルをダウンロードします。

問題4：サンドボックステストの問題

エラーメッセージ

Error: Cannot connect to iTunes Store
StoreKitError: Purchase failed - Invalid sandbox account

よくある原因

1. サンドボックスアカウントにログインしていない：デバイスにサンドボックスアカウントが設定されていない場合です。
2. プロダクションアカウントを使用：サンドボックステスターではなく通常のApple IDでログインしている場合です。
3. サンドボックスアカウントが未作成：サンドボックステスターアカウントが存在しない場合です。
4. 誤ったサンドボックス構成：デバイスがサンドボックステスト向けに正しく設定されていない場合です。

解決手順

ステップ1：サンドボックステスターアカウントを作成

1. App Store Connectに移動します。
2. Users and Accessに移動します。
3. 左側のサイドバーでSandbox Testersをクリックします。
4. +をクリックして新しいテスターを追加します。
5. 詳細情報を入力します（一意のメールアドレスを使用します。実在するメールアドレスである必要はありません）。
6. テスターを保存します。

ステップ2：プロダクションのApp Storeからログアウト

1. iOSデバイスでSettingsに移動します。
2. 上部の名前をタップします。
3. 下にスクロールしてSign Outをタップします。
4. ここではサンドボックスアカウントでログインしません。アプリが表示するプロンプトを待ちます。

ステップ3：プロンプトが表示されたらログイン

1. アプリをデバッグモードで実行します。
2. 購入を試みます。
3. Apple IDの入力プロンプトが表示されたら、サンドボックステスターの資格情報を使用します。
4. デバイスは以降のテスト購入のためにこの情報を記憶します。

ステップ4：より高速なテストにTest Storeを使用（代替手段）

サンドボックス特有の煩わしさなしに、より安定したテストを行うにはRevenueCat Test Storeを使用します。

• サンドボックスアカウントが不要です。
• 購入結果が決定的です。
• シミュレーターで動作します。
• Appleのサーバーに依存しません。

問題5：すべてのフィールドを入力したのに"Missing Metadata"ステータスになる

症状

必須フィールドをすべて入力したつもりでも、App Store Connectでサブスクリプション商品が"Missing Metadata"と表示されます。このステータスでは商品を審査に提出できません。

Missing Metadata状態の商品をRevenueCatは取得できますか？

環境によって異なります。

• サンドボックスおよびStoreKit Configuration：可能です。"Missing Metadata"状態の商品でも、サンドボックス環境とStoreKit Configurationファイルでテストできます。
• プロダクション：不可能です。プロダクションで商品を取得するには"Approved"状態である必要があります。"Missing Metadata"の商品は審査に提出できないため、問題を解決するまでプロダクションには決して反映されません。

よくある原因

"Missing Metadata"ステータスは、もどかしいほど曖昧です。すべての項目が完了しているように見える場合でも発生する、最も一般的な原因は次のとおりです。

1. 審査用スクリーンショットがまだ処理中：最も見落とされがちな原因です。スクリーンショットがUIに表示されていても、App Store Connectの内部ではまだ処理中の場合があります。5〜10分待ってからページを再読み込みします。
2. サブスクリプションのローカライズの欠如：サブスクリプションのDisplay NameとDescriptionを少なくとも1つの言語で追加する必要があります。サブスクリプション → App Store Localizationセクションに移動し、表示名と説明を追加します。
3. 審査用スクリーンショットの欠如：各サブスクリプション商品には、アプリ内のサブスクリプションを示すスクリーンショットが必要です。このスクリーンショットは、アプリバージョンのスクリーンショットではなく、サブスクリプションのReview Informationセクションにアップロードする必要があります。
4. サブスクリプショングループのローカライズの欠如：Subscription Group自体にもローカライズされた表示名が必要です。サブスクリプショングループに移動し、App Store Localizationセクションを確認します。
5. 価格の欠如：商品に少なくとも1つのSubscription Priceが構成されているか確認します。

解決手順

ステップ1：審査用スクリーンショットを確認

最も見落とされやすいポイントです。スクリーンショットがApp Store Connectに表示されていても、まだ処理中の場合があります。

1. App Store Connectでサブスクリプション商品に移動します。
2. Review Information → Screenshotまでスクロールします。
3. スクリーンショットが表示されている場合は、削除してから再度アップロードします。
4. 処理が完了するまで5〜10分待ちます。
5. ページを再読み込みし、ステータスが変わるか確認します。

ステップ2：サブスクリプションのローカライズを確認

1. App Store Connectでサブスクリプション商品に移動します。
2. App Store Localizationをクリックし、少なくとも1つの言語に次があるか確認します。
   • Display Name（ユーザーに表示される名前）
   • Description（サブスクリプションに含まれる内容）
3. Subscription Groupレベルも確認します。グループ名をクリックし、ローカライズされたDisplay Nameと、任意項目のCustom Display Nameがあるか確認します。

ステップ3：すべての必須フィールドを確認

次のチェックリストで漏れている項目がないか確認します。

• ☐ Reference Name：商品の内部用の名前です。
• ☐ Product ID：RevenueCatと一致する識別子です。
• ☐ Subscription Duration：週間、月間、年間などです。
• ☐ Subscription Price：少なくとも1つの価格が構成されている必要があります。
• ☐ App Store Localization：少なくとも1つの言語の表示名と説明です。
• ☐ Subscription Group Localization：グループの表示名です。
• ☐ Review Information：スクリーンショットがアップロードされ、処理が完全に終わっているか確認します（5〜10分待ちます）。
• ☐ Review Notes（任意ですが推奨）：Appleの審査担当者向けの簡単な説明です。

よくある問題のクイックリファレンス

App Store設定クイックチェックリスト

次のチェックリストでApp Storeの構成を点検します。

• ☐ Paid Applications Agreementに署名しました。
• ☐ 銀行情報の入力を完了しました。
• ☐ 税務フォームを提出し、確認を受けました。
• ☐ App Store Connectに商品を作成しました。
• ☐ App Store ConnectとRevenueCatの商品IDが一致しています。
• ☐ 商品を審査に提出しました（またはStoreKit Configurationを使用しています）。
• ☐ "Missing Metadata"ステータスがありません（スクリーンショットの処理、ローカライズ、価格設定を確認します）。
• ☐ XcodeとRevenueCatのbundle IDが一致しています。
• ☐ プロビジョニングプロファイルがbundle IDと一致しています。
• ☐ サンドボックステスターアカウントを作成しました。
• ☐ 正しいサンドボックスの資格情報でテストしています。
• ☐ テストデバイスでプロダクションのApp Storeにログインしていません。