解決のためのチェックリスト
すでにインストールされたアプリを削除
- 原因: 既存のアプリが競合している可能性があります。
- 対処法:
- iPhone / シミュレーター上の アプリを削除 する。
- Xcode で再度 「Product」→「Run」 を実行する。
開発用プロビジョニングプロファイルの問題
- 原因: コード署名やプロビジョニングプロファイルが正しく設定されていない可能性。
- 対処法:
- Xcode の設定を確認
- Xcode > Settings (または Preferences) > Accounts から Apple ID が正しく設定されているか確認。
- Team (開発チーム) が適切なものに設定されているか確認。
- プロビジョニングプロファイルのリフレッシュ
- Xcode > Targets > Signing & Capabilities を開く。
- Automatically manage signing にチェックを入れる。
- 「Provisioning Profile」や「Signing Certificate」が適切なものに設定されているか確認。
- Xcode の設定を確認
デバイスのストレージ不足
- 原因: iPhone / シミュレーターの空き容量が不足している可能性。
- 対処法:
- 不要なアプリやデータを削除 して空き容量を確保する。
- 設定アプリ > 一般 > iPhoneストレージ で空き容量を確認する。
✅ 4. Xcode のキャッシュやビルド設定の問題
- 原因: 古いキャッシュやビルドデータが原因でインストールに失敗している可能性。
- 対処法:
- クリーンビルド
⇧ Shift + ⌘ Command + K
を押して クリーンビルド を実行。
- DerivedData の削除
~/Library/Developer/Xcode/DerivedData/
のフォルダを削除。
- Xcode を再起動 して、再度実行する。
- クリーンビルド
iPhone の iOS バージョンが古い / Xcode のバージョンが古い
- 原因: アプリが iOS の新しいバージョンをターゲットにしており、デバイスの iOS バージョンが古い場合、インストールに失敗する。
- 対処法:
- Xcode を最新版に更新(Mac App Store から)。
- iPhone の iOS を最新版にアップデート(設定アプリ > 一般 > ソフトウェア・アップデート)。
USB 接続の問題
- 原因: Mac と iPhone の USB 接続が不安定、または認識されていない。
- 対処法:
- USB ケーブルを抜き差し してみる。
- Mac を再起動 してみる。
- 別の USB ポートに接続 してみる。
アプリの Bundle Identifier が重複
- 原因: すでにインストールされたアプリの Bundle Identifier (
com.example.app
) が競合している。 - 対処法:
- Xcode > Targets > General で
Bundle Identifier
を確認。 com.example.app
のようにユニークなものに変更する。
- Xcode > Targets > General で
コメント