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のシミュレーターに切り替えて解決した。
作業フロー:
- iCloudにサインイン済みのシミュレーター(iOS 26.5)で開発用ビルドを実行
-
initializeCloudKitSchemaですべての型を開発環境に作成 -
tools/ck_schema_compare.pyで開発環境と本番のスキーマをdiff - 増分だけであることを確認してから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が特に得意だったこと
-
文書の一貫性チェック:計画書・実装指示書・ASO指示書・説明文・審査メモ・プライバシーポリシーの間の矛盾を自動検出し、修正してくれた。「開発者のサーバーは存在せず…」という文が1.1で事実でなくなるのを見つけたのも自動だった。
-
APIによる外部確認:App Store Connect APIを使ってメタデータを投入後に読み戻し、値が反映されていることを確認する処理を自動化した。
-
セキュリティの守り:
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と分担することで、実装に集中できる時間が増えた。