トラブルシューティング

Capgo Cloud Buildでネイティブアプリをビルドする際に発生する一般的な問題の解決策です。

ビルド失敗

アップロード失敗”または“接続タイムアウト”

症状：

• プロジェクトアップロード中にビルドが失敗します。
• 60秒以内でタイムアウトエラー

解決策：

1. インターネット接続を確認

   # Test connection to Capgo
   curl -I https://api.capgo.app

2. プロジェクトサイズを削減

   • アップロード中 node_modules/ アップロード中ではない (自動除外されるはず)
   • プロジェクト内の大きなファイルを確認:

   find . -type f -size +10M

3. アップロードURLの有効期限を確認

   • 1時間以内に有効期限切れのURLが期限切れの場合、再度ビルドコマンドを実行してください。
   • ビルドコマンドを再度実行してください。

ヒント

非常に大きなプロジェクトでは、ビルド時間制限に達する可能性があります ( Known Limitations). Contact support for enterprise options.

症状:

ステータスは

• Build exceeds maximum allowed time
• Status shows timeout

ソリューション:

1. 依存関係を最適化する

   • npm の未使用パッケージを削除する
   • 使用 npm prune --production ビルドする前に

2. ビルド中にネットワーク問題を確認する

   • ビルド中に大きなファイルをダウンロードする必要がある依存関係が存在する場合
   • ロックファイルを使用した前キャッシュを検討する

3. ネイティブ依存関係をレビューする

   # iOS - check Podfile for heavy dependencies
   cat ios/App/Podfile
   
   # Android - check build.gradle
   cat android/app/build.gradle

4. サポートに連絡する

   • If your app legitimately needs more time
   • We can adjust limits for specific use cases

Authentication Issues

”API key invalid” or “Unauthorized”

症状：

• ビルドが即座に認証エラーで失敗する
• 401または403エラー

解決策：

1. API キーが正しいことを確認する

   # Test with a simple command
   bunx @capgo/cli@latest app list

2. API キーの権限を確認してください

   • __CAPGO_KEEP_0__ キーには write または all __CAPGO_KEEP_0__ キーの権限を確認してください
   • Capgo ダッシュボードのAPI キー下でCapgo キーを確認してください

3. API キーが正しく読み取られていることを確認してください

   # Check environment variable
   echo $CAPGO_TOKEN
   
   # Or check your saved credentials file
   cat ~/.capgo-credentials/credentials.json   # global
   cat .capgo-credentials.json                 # local (--local)

4. 再認証

   bunx @capgo/cli@latest login

アプリが見つかりません

症状:

• 認証は正常に動作していますが、アプリ固有のエラーが発生しています

解決策:

1. アプリが登録されていることを確認してください

   bunx @capgo/cli@latest app list

2. アプリIDが一致していることを確認してください

   • 確認する capacitor.config.json appId
   • コマンドが正しいアプリIDを使用していることを確認してください

3. 組織へのアクセスを確認する

   • 正しい組織にいることを確認する
   • API キーはアプリの組織にアクセスできる必要があります

iOS ビルドの問題

「Code の署名が失敗しました」

症状:

• ビルドが code 署名フェーズで失敗する
• Xcode から証明書またはプロファイルに関するエラー

解決策:

1. 証明書のタイプがビルドのタイプと一致していることを確認する

   • 開発用ビルドには開発証明書が必要です
   • App Store用ビルドには配布用証明書が必要です

2. 証明書とプロファイルが一致するか確認

   # Decode and inspect your certificate
   echo $BUILD_CERTIFICATE_BASE64 | base64 -d > cert.p12
   openssl pkcs12 -in cert.p12 -nokeys -passin pass:$P12_PASSWORD | openssl x509 -noout -subject

3. プロビジョニングプロファイルが有効であることを確認

   • 有効期限の確認
   • App IDが含まれていることを確認
   • 証明書が含まれていることを確認

4. 再生成

   • 古い証明書/プロファイルを削除
   • Apple Developer ポータルで新しいものを作成
   • 環境変数を再エンコードして更新する

署名証明書が含まれていないプロビジョニング プロファイル

症状:

• Xcodeはプロファイル内に証明書を見つけることができません

解決策:

1. Appleから最新のプロファイルをダウンロードする

   • Apple Developer → 証明書、ID、プロファイルに移動する
   • プロビジョニング プロファイルをダウンロードする
   • プロファイルに自分の証明書が含まれていることを確認する

2. プロファイルに証明書が含まれていることを確認する

   # Extract profile
   echo $BUILD_PROVISION_PROFILE_BASE64 | base64 -d > profile.mobileprovision
   
   # View profile contents
   security cms -D -i profile.mobileprovision

3. Apple Developer ポータルでプロファイルを編集

   • Apple Developer ポータルでプロファイルを編集
   • 配布用証明書が選択されていることを確認してください
   • ダウンロードして再エンコード

”App Store Connect authentication failed”

症状:

• Upload to TestFlight fails
• API key errors

Solutions:

1. Verify API key credentials

   • APPLE_KEY_ID を確認してください (10文字でなければなりません)
   • APPLE_ISSUER_ID を確認してください (UUID形式でなければなりません)
   • APPLE_KEY_CONTENT が正しく base64 でエンコードされていることを確認してください

2. API キーをローカルでテストしてください

   # Decode key
   echo $APPLE_KEY_CONTENT | base64 -d > AuthKey.p8
   
   # Test with fastlane (if installed)
   fastlane pilot list

3. API キーの権限を確認してください

   • キーの権限は “Developer” ロールまたはそれ以上でなければなりません
   • App Store Connect → ユーザーとアクセス → キーで確認してください

4. キーの有効期限が切れていないことを確認してください

   • App Store Connect で確認してください
   • 必要に応じて新しいキーゲンериーションを実行してください

”Pod install failed”

症状:

• CocoaPodsのインストール中にビルドが失敗する
• Podfileのエラー

解決策:

1. Podfile.lockがコミットされていることを確認する

   git status ios/App/Podfile.lock

2. ローカルでpod installをテストする

   cd ios/App
   pod install

3. iOS用のPodが不相応であるかどうかを確認する

   • Podfileのバージョン間の競合を確認する
   • iOSのデプロイターゴールバージョンをすべてサポートしていることを確認する

4. Podキャッシュをクリアする

   cd ios/App
   rm -rf Pods
   rm Podfile.lock
   pod install
   # Then commit new Podfile.lock

Androidビルドの問題

Keystoreのパスワードが不正です

症状：

• 署名中にビルドが失敗する
• Gradleエラーについてのキーストア

Solutions:

1. キーストアパスワードを確認する

   # Test keystore locally
   keytool -list -keystore my-release-key.keystore
   # Enter password when prompted

2. 環境変数を確認する

   # Ensure no extra spaces or special characters
   echo "$KEYSTORE_STORE_PASSWORD" | cat -A
   echo "$KEYSTORE_KEY_PASSWORD" | cat -A

3. base64エンコードを確認する

   # Decode and test
   echo $ANDROID_KEYSTORE_FILE | base64 -d > test.keystore
   keytool -list -keystore test.keystore

”Key alias not found”

症状:

• 署名がアライアスエラーで失敗します

解決策:

1. キーストアのアライアスの一覧を表示

   keytool -list -keystore my-release-key.keystore

2. アライアスが完全に一致することを確認

   • アライアスは大文字小文字が区別されます
   • KEYSTORE_KEY_ALIASに誤字がないか確認

3. キーストアから正しいアライアスを使用

   # Update environment variable to match
   export KEYSTORE_KEY_ALIAS="the-exact-alias-name"

Gradle ビルドが失敗しました。

症状：

• Gradle の一般的なエラー
• コンパイルまたは依存関係の問題

ソリューション:

1. ローカルでテストビルドを実行してください。

   cd android
   ./gradlew clean
   ./gradlew assembleRelease

2. 依存関係の欠如を確認する

   • ビルド.gradleファイルのレビュー
   • すべてのプラグインが依存関係にリストされていることを確認する

3. Gradle バージョンの互換性を確認する

   # Check gradle version
   cat android/gradle/wrapper/gradle-wrapper.properties

4. Gradle キャッシュをクリア

   cd android
   ./gradlew clean
   rm -rf .gradle build

”Play Store upload failed”

Symptoms:

• Build succeeds but upload fails
• Service account errors

ソリューション:

1. サービスアカウント JSON を検証する

   # Decode and check format
   echo $PLAY_CONFIG_JSON | base64 -d | jq .

2. サービス アカウントの権限を確認する

   • Play Console へのアクセス → セットアップ → API アクセス
   • サービスアカウントがアプリにアクセスできるようにしてください。
   • リリーステストトラックへの許可を付与

3. アプリがPlay Consoleで正しく設定されていることを確認する

   • アプリはまずPlay Consoleで作成する必要があります。
   • 最初のアップロードでは少なくとも1つのAPKを手動でアップロードする必要があります。

4. Capgoを使用している場合は、APIが有効になっていることを確認してください。

   • Google Play Developer API を有効にする必要があります。
   • Google Cloud Console で確認してください。

一般的な問題

「ジョブが見つかりません」または「ビルドのステータスが利用できません」

症状:

• ビルドのステータスを確認できません
• ジョブ ID のエラー

解決策:

1. しばらく待ってから再試行してください

   • ビルドジョブは数秒間で初期化されることがあります

2. Check job ID is correct

   • Verify the job ID from the initial build response

3. Check build hasn’t expired

   • Build data is available for 24 hours

”Project sync failed”

Symptoms:

• Build fails before compilation starts
• Run __CAPGO_KEEP_0__ sync locally

Solutions:

1. Run Capacitor sync locally

   bunx cap sync

2. すべてのネイティブファイルがコミットされていることを確認

   git status ios/ android/

3. gitignored されているネイティブファイルを確認

   • .gitignore を確認
   • 重要な設定ファイルが無視されていないことを確認

”Build succeeded but I don’t see output”

Symptoms:

• ビルド成功ですが出力が見られません

Solutions:

1. __CAPGO_KEEP_0__ Actions: “Command not found”

   • ビルド設定を確認
   • アーティファクトの保存設定が未設定の場合

2. アーティファクトのアクセスがビルドで利用できない場合のサポートにご連絡ください

   • iOSのテストフライトの提出用
   • App Store Connectを確認

3. アップロード後5-30分程度で処理が完了する可能性があります

   • AndroidのPlayストア
   • Play Console → テスト → 内部テストを確認

処理時間は数分程度です

GitHub Actions: “Command not found”

症状:

• bunx @capgo/cli@latest … __CAPGO_KEEP_0__ が CI で失敗し “コマンドが見つかりません”

解決策:

1. Bun を設定してください そして bunx 利用可能です:

   - uses: oven-sh/setup-bun@v2

2. 次に、CLI を実行してください — bunx __CAPGO_KEEP_0__ はオンデマンドで取得され、グローバルインストールが必要ありません:

   - run: bunx @capgo/cli@latest build request com.example.app --platform android

GitHub アクション: “シークレットが見つかりません”

症状:

• ビルド環境変数が空

解決策:

1. シークレットが設定されていることを確認する

   • リポジトリの設定 → シークレットと変数 → アクションに移動する
   • 必要なすべてのシークレットを追加する

2. 正しい構文を使用する

   env:
     CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

3. シークレット名が一致していることを確認する

   • 名前は大文字小文字区別
   • シークレット参照に誤字がないことを確認する

サポートを受ける

詳細ログを有効にする

# Add debug flag (when available)
bunx @capgo/cli@latest build request com.example.app --verbose

ビルド情報を収集する

サポートに連絡する際には、以下を含めてください。

1. 使用したビルドコマンド

   bunx @capgo/cli@latest build request com.example.app --platform ios

2. エラー メッセージ (フル出力)

3. ジョブ ID (ビルド出力から)

4. ビルド ログ (フルターミナル出力をコピー)

5. 環境情報

   node --version
   npm --version
   bunx @capgo/cli@latest --version

サポートに連絡する

• Discord: コミュニティに参加してください
• メール: support@capgo.app
• ドキュメント: Capgo ドキュメント

知られている制限事項

現在の制限事項:

• 最大ビルド時間: 10 分
• 最大アップロードサイズ: ~500MB
• iOS ビルドには 24 時間の Mac のレンタルが必要です。Mac でビルドすると、最適な使用を確保するためにキューに追加されます。
• ビルドアーティファクトのダウンロードの可用性は、ビルドの目的地とアーティファクトのストレージの構成に依存します。

フィードバックに基づいてこれらの制限を調整することができます。

追加リソース

• はじめに - 初期設定ガイド
• iOS ビルド - iOS固有の設定
• Android ビルド - Android固有の設定
• CLI リファレンス - 完全なコマンドドキュメント