Xcode・SwiftでのiPhone実機テストエラー、ビルドエラーの一覧と解決方法

こんにちは、こばやしよしのり @yoshiii514 です。

Xcode・SwiftからiPhone本体へアプリを転送（実機転送）した時や、ビルドした時にエラーメッセージが表示されることがあります。
エラーメッセージの内容応じて、解決方法を記載いたしますので、参考にしてください。

また、Xcode、Swift、アプリ開発についてのおすすめ本と学習方法については次のページで書いています。

あわせて読みたい

初心者向けiPhone（iOS）アプリ開発おすすめ本・動画（Udemy）と勉強方法！まずはXcodeの使い方を学ぼう！

Xcode・Swift 実機テストエラー・ビルドエラーの一覧と解決方法

an error was encountered while attempting to communicate with this device. (the service is invalid.)

エラーメッセージ：

日本語訳：

解決方法：

iPhoneをケーブルから外したのちに、iPhoneを再起動してください。
 参考：iPhone、iPad、iPod touch を再起動する – Apple サポート

iPhoneを再起動後に、再度、ケーブルを接続して、実機転送を行ってください。

Failed to create provisioning profile.

エラーメッセージ：

日本語訳：

解決方法：

1. iPhone 本体が Mac と接続されている必要があります。
そして、次の図のように、 Xcode の ［Device］ の欄で ご自身の iPhone が選択されている必要があります。

2.Bundle Identifier は世界中で重複したIDを使うことができません。
そのために、メールアドレスやドメイン等を活用して重複を回避します。
Bundle Identifier を重複しない ID に変更したのちに、再度、ご確認ください。
Bundle Identifier の解説は、本書に掲載されています。

Development cannot be enabled while your device is locked.

エラーメッセージ：

日本語訳：

解決方法：

iPhoneがロックされているときは、アプリの転送が行えません。
iPhoneをケーブルから外したのちに、iPhoneのロックを解除して再接続してください。
iPhoneがロックされていないことを確認してから、再度、XcodeよりBuildボタン（▶）を押してください。

Your maximum App ID limit has been reached.You may create up to 10 App ID every 7 Days.

エラーメッセージ：

日本語訳：

解決方法：

AppIDは、Bundle Identifierのことです。
Bundle Identifierの解説は、本書に掲載されています。
Bundle Identifierは世界中で重複したIDを使うことができません。
そのために、メールアドレスやドメイン等を活用して重複を回避します。ですが、このIDを何度も変更していると７日間で10個のIDしか作れない制限がかかります。
７日間なので、少し期間をあけてもらえると新しくIDが作成できるようになり、実機転送が行えます。
この制限は、Apple Developer Programで無料アカウントの場合に発生しています。

Failed to register bundle identifier.

エラーメッセージ：

日本語訳：

解決方法：

「bundle identifier」が重複することがエラーの原因ですので、重複しないようにIDを設定することで、エラーは解消されます。
詳細は、 Xcode10でUIパーツとコードの関連付け（紐付け）と削除する方法 を参照してください。

Could not launch “（アプリ名）”

エラーメッセージ：

日本語訳：

解決方法：

Xcodeで登録したDeveloperアカウントからiPhone本体へ転送することを、iPhone本体で信頼させる必要があります。
次の手順で、信頼してください。
iPhone で［設定］→［一般］→［プロファイルとデバイス管理］の順にメニューをたどります。［プロファイルとデバイス管理］から次の手順ですすめます。

解説は、本書に掲載されています。

Could not locate device support files.

エラーメッセージ：

日本語訳：

解決方法：

iPhoneのiOSのバージョンに対応したXcodeのバージョンではない可能性があります。
直近で、iOSのみをバージョンアップした場合は、必ずXcodeのバージョンアップも実施してください。
App store でXcodeのアップデートを確認してください。
また、企業内ネットワークなどの特殊な環境では、App storeでのアップデートが許可されていないときがあります。
ご自宅での一般的なネットワーク環境でApp storeのアップデートをご確認ください。

A server with the specified hostname could not be found.

エラーメッセージ：

日本語訳：

解決方法：

ご使用しているMacがインターネットに接続できている環境であるかご確認ください。
Xcodeでは実機転送を行うために、ネット環境が必要になります。
また、VPNや企業内ネットワークなどの特殊なネット環境では、接続が許可されておらず、失敗してエラーになることがあります。
一般的なご自宅のネット環境でご確認ください。

The run destination XXXXX iPhone is not valid for Running the scheme ‘MyJanken’.

エラーメッセージ：

日本語訳：

解決方法：

iPhone の OS バージョンと Xcode でiPhoneアプリ用として作っている OS バージョンの指定が異なります。
最新バージョンの Xcode であれば、常に最新のiOSバージョンのアプリ作成がデフォルトになっています。
iPhone の OS をアップデートしてください。

Unexpectedly found nil while implicitly unwrapping an Optional value

エラーメッセージ：

日本語訳：

解決方法：

使用している変数は、@IBOutlet で接続されたものです。画面のパーツと @IBOutlet の接続が正常にできていないことが原因です。
@IBOutlet の接続を確認してください。

Cannot use instance member ‘xxxxxx’ within property initializer

エラーメッセージ：

日本語訳：

解決方法：

記述する場所が間違っています。
classで、変数を宣言・初期化する場所で変数を利用しているためエラーになります。
変数を利用したいアクションが発生するメソッド内にコードを移動します。

Could not launch Simulator.app.

エラーメッセージ：

日本語訳：

解決方法：

1.Macを再起動後にシミュレータの実行
2.プロジェクトをクリーンアップして再ビルドします。
 Shift + Command + k でクリーンできます。
 メニューなら［Product］> ［Clean Build folder］でできます。
3.プロジェクトを削除して最初から作り直す

terminating with uncaught exception of type NSException

エラーメッセージ：

日本語訳：

解決方法：

1.画面パーツとコードの関連付けを確認します。
2.関連付けで警告マークがある場合は、関連付けを削除して、再設定してください。

書籍「たった2日でマスターするiPhoneアプリ開発集中講座 Xcode 11 Swift 5対応」のP105を参考にしてください。

アプリ開発が学べる勉強会を開催中！

アプリ開発を学ぶための勉強会を定期開催しています。
学習する習慣を身につけたい、他の参加者と作業したい、アプリ開発の基本をマスターしたい、という方のために無料で学べる勉強会です。
グループにメンバー登録して頂くと、イベント開催時にメールで通知されます。
 グループのメンバーとして参加する

徹底した基礎学習からのマスターするiPhoneアプリ開発集中オンライン講座開講！

本書「iPhoneアプリ開発集中講座」を執筆している現役エンジニア講師陣が直接に指導！
基礎、課題実習で実践力を鍛えて、オリジナルアプリ公開までチャレンジ！
充実した転職支援もあるので、エンジニアへ転職したい人にもおすすめです！
まずは、現役エンジニアに相談できる無料相談をご利用ください。