0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeでゼロからアプリを審査まで!OshiLogが教えてくれた全自動リリースフローの裏側

0
Last updated at Posted at 2026-11-19

Claude Codeにアプリ開発を丸投げしたら何が起きたか——OshiLog実装記録

はじめに

「App Storeの審査に出せる状態まで一気に実装してほしい」——これをClaude Codeに投げたら、本当に審査まで辿り着いた。

今回は「推し活予算・遠征管理」アプリ OshiLog の開発をClaude Codeと進めた記録をまとめる。フェーズ1〜6の実装、StoreKit 2、iCloud同期、スクショ自動生成、App Store Connect(ASC)へのメタデータ投入、TestFlight、審査提出、さらに1.1向けのサーバーサイド強化まで——ログが数万行に及んだセッションのエッセンスを、実際に詰まったポイントを中心に紹介する。


やったこと

フェーズ構成(1.0リリースまで)

フェーズ 内容
1 XcodeGen初期設定、StoreKit設定ファイル(3商品)、基本テスト
2 推し登録・支出入力・一覧・レビュー依頼
3 予算エンジン・ホーム・予算編集
4 イベント・締切通知・遠征費内訳
5 集計レポート・共有カード
6 課金・iCloud同期・CSV・設定・アプリロック

フェーズごとにビルドとテストが通った状態でコミット(pushはしない)という縛りで進めた。最終的にユニットテスト65件+UIテスト1件が全通過した状態でASCへ提出している。

1.1で追加した要素

1.0審査通過後、1.1で新機能(YouTubeの新着通知、ウィジェット拡張、有料機能の見直しなど)を追加した。サーバーはNode.js + SQLiteで自前構築し、APNsによるPush通知をinstallationごとに分離管理する仕組みを実装した。


ハマったポイント

1. 購入してもプレミアムにならない(StoreKit 2の落とし穴)

症状: TestFlightで購入が成功しても、「復元」を押さないとプレミアムにならない。

原因: Transaction.currentEntitlements は購入直後に反映が遅延することがある(Sandboxも本番も同様)。

// 修正前:currentEntitlementsだけで判定していた
func refresh() async {
    var ids = Set<String>()
    for await result in Transaction.currentEntitlements {
        if case .verified(let tx) = result {
            ids.insert(tx.productID)
        }
    }
    apply(ids)
}
// 修正後:受け取った取引そのものをセッション内で保持
func register(_ transaction: Transaction) {
    guard transaction.revocationDate == nil,
          transaction.expirationDate.map({ $0 > .now }) ?? true else { return }
    sessionGrants.insert(transaction.productID)
}

static func activeProductIDs(current: Set<String>, session: Set<String>, now: Date) -> Set<String> {
    return current.union(session) // 両方をマージ
}

学び(個人の感想): StoreKit 2の Transaction.updates を受けたときも同じ問題が起きる。購入成功時と更新受信時の両方で、受け取った取引を「セッション内のグラント」として保持し、currentEntitlements の反映を待たずに判定に加えるのが安全。


2. CloudKit スキーマの開発環境が作れない(デッドロック)

症状: initializeCloudKitSchema が30秒でタイムアウトする。

原因: RecordSyncMonitor のオブザーバーキューが .main になっていたため、スキーマ初期化処理と待ち合ってデッドロックが発生していた。

// 修正前
let monitor = NSPersistentCloudKitContainer.eventChangedNotification
NotificationCenter.default.addObserver(
    self,
    selector: #selector(cloudKitEventChanged),
    name: monitor,
    object: container,
    queue: .main  // ← これが問題
)
// 修正後
NotificationCenter.default.addObserver(
    self,
    selector: #selector(cloudKitEventChanged),
    name: monitor,
    object: container,
    queue: nil  // メインキューへの依存を外す
)

TestFlightビルドは 本番の CloudKit環境に接続するため、スキーマは開発環境に initializeCloudKitSchema で作成してから本番にDeployする必要がある。シミュレーターで試みたが、iOS 27では「不明なエラー」でiCloudサインインができず、iOS 26.5のシミュレーターに切り替えて解決した。

作業フロー:

  1. iCloudにサインイン済みのシミュレーター(iOS 26.5)で開発用ビルドを実行
  2. initializeCloudKitSchema ですべての型を開発環境に作成
  3. tools/ck_schema_compare.py で開発環境と本番のスキーマをdiff
  4. 増分だけであることを確認してからCloudKit ConsoleでDeploy(本番反映は手動・取り消し不可)

3. ASC APIで説明文に絵文字を入れると409エラー

症状: 説明文の投入スクリプトが409を返す。

原因: ASC APIの説明文フィールドは絵文字を受け付けない。

# asc_push_metadata.py に追加したプレフライトチェック
import re

def check_emoji(text: str) -> list[str]:
    emoji_pattern = re.compile(
        "[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF"
        "\U0001F680-\U0001F6FF\U0001F1E0-\U0001F1FF"
        "\U00002702-\U000027B0\U000024C2-\U0001F251]+",
        flags=re.UNICODE
    )
    matches = emoji_pattern.findall(text)
    return matches

issues = check_emoji(description)
if issues:
    raise ValueError(f"絵文字が含まれています(ASC不可): {issues}")

同様に、審査メモは4,000字制限がある。日英合わせると超過しやすいため、英語版を短くする対策も実装した。


4. Sandbox購入履歴を消しても有料状態が解除されない

症状: TestFlightのSandboxで年額購入 → APIで購入履歴を消去 → アプリを開き直してもプレミアムのまま。

原因: TestFlightの購入は「購入履歴を消去」の対象外。Sandboxでは年額=1時間の自動更新で、期限まで有効状態が維持される。

対策として実施したこと:

  • 新しいSandboxテスターアカウントを商品ごとに作成
  • API(asc_sandbox.py)でテスターの購入履歴を管理
  • 確認順序を「年額 → 履歴消去 → 月額 → 履歴消去 → 買い切り」に固定
# tools/asc_sandbox.py(抜粋)
def clear_purchase_history(tester_id: str) -> dict:
    """Sandbox テスターの購入履歴を消去する"""
    url = f"{BASE_URL}/sandboxTesters/{tester_id}/clearPurchaseHistory"
    response = requests.post(url, headers=auth_headers())
    # 消去の反映はAPIで確認できないため、件数のみ記録
    return {"status": response.status_code}

5. シミュレーターのメモリ問題(同時起動で約6.3GB消費)

別プロジェクトの作業が重なったタイミングで、シミュレーター2台がメモリを6.3GB消費してスワップが逼迫した。

対策として tools/sim_lib.sh に組み込んだルール:

# 1台しか起動させない
sim_boot() {
    local udid="$1"
    # 他のシミュレーターが起動中なら中止
    local booted_count
    booted_count=$(xcrun simctl list devices | grep -c "Booted" || true)
    if [[ "$booted_count" -gt 0 ]]; then
        echo "ERROR: 別のシミュレーターが起動中です" >&2
        return 1
    fi
    xcrun simctl boot "$udid"
    xcrun simctl bootstatus "$udid" -b  # 起動完了まで待つ
}

# 終了時に必ず閉じる(成功・失敗・中断どれでも)
trap 'sim_close "$TARGET_UDID"' EXIT INT TERM

UI テストには並列実行オフを必須指定した:

xcodebuild test \
    -parallel-testing-enabled NO \
    -maximum-concurrent-test-simulator-destinations 1 \
    ...

6. サーバー側のinstallation管理(通知の分離)

1.0では全体で3件までしか通知登録できない設計だったが、1.1でinstallationごとの分離管理に移行した。

// state.mjs(SQLiteによる状態管理)
async function createInstallation(db, { id, secretHash, ipHash }) {
    await db.run(
        `INSERT INTO installations (id, secret_hash, ip_hash, last_seen)
         VALUES (?, ?, ?, unixepoch())`,
        [id, secretHash, ipHash]
    );
}

// 180日間使われなければ自動削除
async function pruneInstalls(db, { now, lifetimeMs }) {
    const cutoff = Math.floor((now - lifetimeMs) / 1000);
    await db.run(
        `DELETE FROM installations
         WHERE last_seen <= ?
           AND id NOT IN (SELECT installation_id FROM subscriptions)`,
        [cutoff]
    );
}

セキュリティ設計のポイント:

  • サーバーに保存するのは秘密のハッシュのみ(値は保存しない)
  • 鍵はGitのコミットに含まれないよう Config/Secrets.xcconfig(.gitignore済み)経由で組み込み
  • 外部公開フォルダに .env・ソース・バックアップを置かないことを public-exposure-check で監視

7. プライバシーマニフェストの落とし穴

1.0でUserDefaultsを使っているのにプライバシーマニフェストが入っていなかった。

<!-- OshiLog/Resources/PrivacyInfo.xcprivacy -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ...>
<plist version="1.0">
<dict>
    <key>NSPrivacyCollectedDataTypes</key>
    <array>
        <dict>
            <key>NSPrivacyCollectedDataType</key>
            <string>NSPrivacyCollectedDataTypeDeviceID</string>
            <key>NSPrivacyCollectedDataTypeLinked</key>
            <true/>
            <key>NSPrivacyCollectedDataTypeTracking</key>
            <false/>
        </dict>
    </array>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <dict>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>CA92.1</string>
            </array>
        </dict>
    </array>
</dict>
</plist>

ウィジェット拡張はデータを収集しないため、別途空のマニフェストが必要だった。


学び

Claude Codeが特に得意だったこと

  1. 文書の一貫性チェック:計画書・実装指示書・ASO指示書・説明文・審査メモ・プライバシーポリシーの間の矛盾を自動検出し、修正してくれた。「開発者のサーバーは存在せず…」という文が1.1で事実でなくなるのを見つけたのも自動だった。

  2. APIによる外部確認:App Store Connect APIを使ってメタデータを投入後に読み戻し、値が反映されていることを確認する処理を自動化した。

  3. セキュリティの守り:upload_guard フックで秘密ファイルのアップロードをブロックし、反映後の403/404確認をルーティンとして実行した。

人間が必ず判断した方がよかったこと(個人の感想)

  • 本番環境への取り消し不可能な操作(CloudKit Deploy、ASC提出):直前で必ず止めて人間が押した
  • 有料/無料の線引き(新機能が増えるたびに都度確認)
  • プライバシーポリシーの公開:差分を出して承認を得てから反映
  • APNs鍵のサーバーへの転送:upload_guard がブロックしたため、scp コマンドを人間が実行し、ハッシュで照合

自動化して効果が高かった部分

# 審査前チェックリストの進捗を自動集計
python3 - <<'EOF'
import re

with open("reports/04_審査前チェックリスト_残作業.md") as f:
    content = f.read()

done = len(re.findall(r'^- \[x\]', content, re.MULTILINE))
total = len(re.findall(r'^- \[.\]', content, re.MULTILINE))
print(f"進み具合: {done}/{total} ({done*100//total}%)")
EOF

外からの疎通確認も自動化し、反映のたびに実行した:

# public-exposure-check(抜粋)
for path in .env server.mjs state.sqlite backup; do
    status=$(curl -s -o /dev/null -w "%{http_code}" \
        "https://oshilog.sns-tool.online/${path}")
    echo "${path}: ${status}"
    [[ "$status" != "404" ]] && echo "ALERT: ${path} が取得できます" >&2
done

まとめ

Claude Codeとの開発で印象的だったのは、「何を自動化してよいか」と「何を人間が判断すべきか」の線引きを、コードの文脈から自律的に判断していた点だ(個人の感想)。

取り消し不可能な操作(本番Deploy、審査提出)では必ず止まって確認を求め、逆に繰り返し確認が必要な作業(文字数チェック、外部疎通確認、テスト実行)は自動化してくれた。

iOSアプリのリリースには「実装が終わってからが長い」という特性がある。メタデータ、プライバシー申告、審査メモ、スクショ、TestFlightによる動作確認——これらの作業をClaude Codeと分担することで、実装に集中できる時間が増えた。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?