Xcodeでアプリを実機起動｜デバイス信頼・開発者モードと起動手順

▶

この記事の要点

はじめに

iOS アプリは Xcode のシミュレータでも動かせますが、実機での動作確認はカメラ・センサ・パフォーマンス・指タップ操作のいずれにおいても欠かせません。本記事では iPhone を Mac に接続し、Xcode から実機でアプリを起動するまでの手順とハマりどころを整理します。

Apple Silicon Mac の場合は USB-C ケーブル直結のほうが認識が安定します。USB ハブ経由だと一覧に出てこないことがあります。

Xcode の上部にあるスキーム/ターゲットセレクタから、接続中の iPhone を選択します。

Xcode 起動デバイス選択

iOS 16 以降の iPhone は、開発者署名されたアプリを実行する前に端末側でデベロッパモードを有効化する必要があります。

実機ビルドにはコード署名が必要です。プロジェクトのターゲット → Signing & Capabilities タブで設定します。

設定	内容
Automatically manage signing	ON にしておく（学習・個人開発はこれで十分）
Team	自分の Apple ID を追加して選ぶ（無償の Personal Team でも実機テスト可）
Bundle Identifier	世界で一意な逆ドメイン形式（例: `com.example.myapp`）

無償の Personal Team の場合、ビルドした証明書は 7 日で失効します。失効後は再ビルドで再署名すれば OK です。

新しいデベロッパ証明書で初めてビルドしたとき、iPhone でアプリを開くと「信頼されていないデベロッパ」と出ます。

エラー / 症状	原因 / 対処
Could not locate device support files	iPhone の iOS バージョンに対応する DeviceSupport が Xcode にない。対処方法 / Xcode を新しいバージョンに更新
Untrusted Developer / 信頼されていない開発元	設定 → 一般 → VPN とデバイス管理で信頼する
Developer Mode required	iOS 16+ のデベロッパモードを ON にして再起動
device is locked	iPhone をロック解除した状態でビルド
No signing certificate found	Xcode → Settings → Accounts に Apple ID を追加し、Team を選び直す
This application's application-identifier entitlement does not match	Bundle ID とプロビジョニングが不一致。Automatically manage signing を一度オフ → オンで再生成
Provisioning profile doesn't include the currently selected device	デバイス UDID がプロファイルに含まれていない。Automatic signing なら自動追加、手動なら developer.apple.com で追加
The maximum number of apps for free development profiles has been reached	無償アカウントは同時 3 つまで。古いプロビジョニングを削除

ケーブルを抜いて Wi-Fi 経由で実機デバッグも可能です。