トラブルシューティング

このプラグインのインストールステップと全マークダウンガイドのセットアップ用の質問をコピーしてください。

Solutions to common issues when building native apps with Capgo Cloud Build.

ビルドエラー

”Upload failed” or “Connection timeout”

プロジェクトアップロード中にビルドが失敗します。

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

解決策：

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

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

プロジェクトサイズを削減
- アップロード中 node_modules/ アップロード中ではない (自動除外されるはず)
- プロジェクト内の大きなファイルを確認:
ターミナル画面
```
find . -type f -size +10M
```
アップロードURLの有効期限を確認
- 1時間以内に有効期限切れのURLが発生します。
- 有効期限切れのURLエラーが発生した場合は、ビルドコマンドを再実行してください。

エンタープライズオプションの場合は、サポートにご連絡ください。

10分以内にビルドタイムアウト

症状:
ビルド時間が許可された最大時間を超えました。 timeout

Solutions:　

依存関係を最適化する
- 未使用のnpmパッケージを削除する
- 使用 npm prune --production ビルド前に
ビルド中にネットワーク問題を確認する
- ビルド中に大きなファイルをダウンロードする可能性がある依存関係がある
- ロックファイルを使用したプリキャッシングを検討する

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

# iOS - check Podfile for heavy dependencies
cat ios/App/Podfile

# Android - check build.gradle
cat android/app/build.gradle

サポートに連絡する
- If your app legitimately needs more time
- We can adjust limits for specific use cases

Authentication Issues

”API key invalid” or “Unauthorized”

Symptoms:

Build fails immediately with authentication error
401 or 403 errors

Solutions:

Verify API key is correct

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

APIのキー権限を確認
- キーには write または all 権限
- CapgoダッシュボードのAPIキーよりも確認

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)

再認証
ターミナル画面
```
bunx @capgo/cli@latest login
```

アプリが見つかりません

症状:

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

解決策:

アプリが登録されていることを確認してください
ターミナル画面
```
bunx @capgo/cli@latest app list
```
アプリIDが一致していることを確認してください
- 確認する capacitor.config.json appId
- コマンドが正しいアプリIDを使用していることを確認してください
組織へのアクセスを確認する
- 正しい組織にいることを確認する
- API キーはアプリの組織にアクセスできる必要があります

iOS ビルドの問題

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

症状:

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

解決策:

証明書のタイプがビルドのタイプと一致していることを確認する
- 開発用ビルドには開発証明書が必要です
- App Store用ビルドには配布用証明書が必要です

証明書とプロファイルが一致するか確認してください

# 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

プロビジョニングプロファイルが有効であることを確認してください
- 有効期限を確認してください
- App IDが含まれていることを確認してください
- 証明書が含まれていることを確認してください
再生成
- 古い証明書/プロファイルを削除
- Apple Developer Portalで新しいものを作成
- 環境変数を再エンコードして更新する

”署名証明書が含まれないプロビジョニングプロファイル”というエラー

症状:

Xcodeではプロファイルに署名証明書が見つからない

解決策:

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

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

# Extract profile
echo $BUILD_PROVISION_PROFILE_BASE64 | base64 -d > profile.mobileprovision

# View profile contents
security cms -D -i profile.mobileprovision

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

App Store Connect の認証が失敗しました”

症状：

テストフライトへのアップロードが失敗
API キーに関するエラー

解決策：

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

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

# Decode key
echo $APPLE_KEY_CONTENT | base64 -d > AuthKey.p8

# Test with fastlane (if installed)
fastlane pilot list

API キーの権限を確認してください
- キーには “開発者” ロールまたはそれ以上が必要です
- App Store Connect → ユーザーとアクセス → キーで確認してください
キーが取り消されていないことを確認してください
- App Store Connect で確認してください
- 必要に応じて新しいキーを作成してください

”Pod install failed”

症状：

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

解決策：

Podfile.lockがコミットされていることを確認する
ターミナル画面
```
git status ios/App/Podfile.lock
```
ローカルでPod installをテストする
ターミナル画面
```
cd ios/App
pod install
```
iOS用のパッドの不相応を確認する
- Podfileのバージョン間の不相応を確認する
- すべてのパッドがiOSのデプロイメントターゲットをサポートしていることを確認する

パッドのキャッシュをクリアする

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

Androidビルドの問題

「キーストアパスワードが不正です」

症状:

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

Solutions:

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

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

環境変数を確認する

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

base64エンコードを確認する

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

”Key alias not found”

症状：

署名がアリーゼーエラーで失敗します

解決策：

キーストアのアリーゼーの一覧
ターミナルウィンドウ
```
keytool -list -keystore my-release-key.keystore
```
アリーゼーが正確に一致することを確認
- アリーゼーは大文字小文字が区別されます
- KEYSTORE_KEY_ALIASのスペルミスを確認

正しいアリーゼーをキーストアから使用

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

”Gradle build failed”

Symptoms:

Generic Gradle errors
Compilation or dependency issues

Solutions:

Test build locally first

cd android
./gradlew clean
./gradlew assembleRelease

ローカルでテストビルドを実行してください
- ターミナルウィンドウ内にコピーする
- すべてのプラグインが依存関係にリストされていることを確認する

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

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

Gradle キャッシュをクリア
ターミナル画面
```
cd android
./gradlew clean
rm -rf .gradle build
```

「Play Store へのアップロード失敗」

症状:

ビルドは成功するがアップロードが失敗する
サービスアカウントのエラー

ソリューション:

サービスアカウント JSON を検証します。
ターミナルウィンドウ
```
# Decode and check format
echo $PLAY_CONFIG_JSON | base64 -d | jq .
```
サービスアカウントの権限を確認する
- Play Console へのアクセス設定に進みます → API
- サービスアカウントがアプリにアクセスできるようにする必要があります。
- リリーステストトラックへの許可を付与する権限を与えます。
アプリがPlay Consoleで正しく設定されていることを確認する
- アプリはまずPlay Consoleで作成する必要があります。
- 最初のアップロードには少なくとも1つのAPKを手動でアップロードする必要があります。
APIが有効になっていることを確認してください。
- Google Play Developer API が有効になっている必要があります
- Google Cloud Console で確認してください

一般的な問題

「Job not found」または「Build status unavailable」

ビルドステータスの確認ができません

ジョブIDのエラー
解決策：

しばらく待ってから再試行

ビルドジョブの初期化には数秒かかる場合があります']}
- targetLanguage
ジョブIDが正しいことを確認してください
- 初回ビルドのレスポンスからジョブIDを確認してください
ビルドが期限切れになっていないことを確認してください
- ビルドデータは24時間利用可能です

プロジェクト同期失敗

症状:

コンパイルが開始する前にビルドが失敗する
ファイルが見つからないエラー

解決策:

ローカルで Capacitor 同期を実行してください
ターミナル画面
```
bunx cap sync
```
__CAPGO_KEEP_0__のすべてのネイティブファイルがコミットされていることを確認
ターミナルウィンドウ
```
git status ios/ android/
```
gitignoredのネイティブファイルを確認
- .gitignoreの確認
- 重要な設定ファイルが無視されていないことを確認

”Build succeeded but I don’t see output”

症状:

Build shows success but no download link

Solutions:

ビルド設定を確認してください
- アーティファクトの保存設定が未設定の場合
- __CAPGO_KEEP_0__ アクセスが不可の場合はサポートに問い合わせてください
iOSのTestFlightの投稿用
- App Store Connectを確認してください
- アップロード後5-30分程度の処理時間がかかる場合があります
AndroidのPlay Store
- Play Console → Testing → Internal testingを確認してください
- 処理時間が数分かかる場合があります

CI/CD関連の問題

GitHub Actions: “コマンドが見つかりません”

症状:

bunx @capgo/cli@latest … __CAPGO_KEEP_0__ がCIで失敗し、「コマンドが見つかりません」と表示される

解決策:

Bun をセットアップする したがって bunx __CAPGO_KEEP_0__ が利用可能です:
```
- uses: oven-sh/setup-bun@v2
```
次に、CLI を実行します — bunx __CAPGO_KEEP_0__ はオンデマンドで取得し、グローバルインストールが必要ありません:
```
- run: bunx @capgo/cli@latest build request com.example.app --platform android
```

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

症状：

ビルド環境変数が空

解決策：

シークレットが設定されていることを確認する
- リポジトリの設定 → シークレットと変数 → アクションに移動する
- 必要なすべてのシークレットを追加する

正しい構文を使用する

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

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

ヘルプをさらに取得する

詳細なログを有効にする

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

ビルド情報を収集する

使用したビルドコマンド

ターミナル画面

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

エラーメッセージ (フル出力)
ジョブ ID (ビルド出力から)
ビルドログ (フルターミナル出力をコピー)

環境情報

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

サポートに連絡する

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

既知の制限事項

現在の制限事項:

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

これらの制限は、フィードバックに基づいて調整される場合があります。

追加リソース

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