メインコンテンツまでスキップ

USB接続でiOS端末にインストール

iOSプロジェクト設定の修正

iOS端末にインストールして開発する場合、XcodeからApple ID(開発者アカウント)でログインする必要があります。また、その開発者アカウントのプロビジョニングプロファイルや証明書を利用してビルドするように設定を変更する必要があります。

設定方法は、ビルド - 開発者アカウントの設定を参照してください。

セットアップできたら、次のコマンドを実行してください。<device name>はインストール先のiOSデバイス名です。

iOS端末で起動する
npm run ios -- --device='<device name>'

デバイス名がわからない場合は、以下に挙げるコマンドで確認できます。

デバイス名、シミュレータ名を確認する
xcrun xctrace list devices
USB接続されているデバイスを確認する
ios-deploy --detect
注記

Xcodeで一度もプロジェクトを開いていない状態でインストールしようとすると、次のようなエラーが発生します。

error: No profiles for 'personal.jp.fintan.mobile.SantokuApp.local.<personal>' were found: Xcode couldn't find any iOS App Development provisioning profiles matching 'personal.jp.fintan.mobile.SantokuApp.local.<personal>'. Automatic signing is disabled and unable to generate a profile. To enable automatic signing, pass -allowProvisioningUpdates to xcodebuild. (in target 'SantokuApp' from project 'SantokuApp')

このようなエラーが発生した場合は、一度Xcodeでプロジェクトを開いてからデバイスへのインストールを試してください。

デベロッパアカウントのチームIDを確認する

無償のデベロッパアカウントのチームIDは、Xcodeの設定ファイルや開発用証明書などから確認できます。ここでは、開発用証明書から確認する手順を紹介します。

まず、XcodeからApple ID(デベロッパアカウント)でログインし、開発用の証明書を作成します。

  1. Xcodeでアカウントの設定画面を開き、必要ならログインします。
    • 「Preferences」>「Accounts」でアカウントの設定画面が開きます。
    • ログインする場合、左下の「+」ボタンをクリックしてログインします。
  2. 利用するApple IDを選択状態にし、右側のチーム一覧で「<Apple IDの氏名> (Personal Team)」と書かれているチームを選択します。
    • Apple Developer Programなどに登録されているユーザの場合、Apple Developer Programのデベロッパ名なども表示されるため、複数のチームが表示されます。
  3. 「Personal Team」を選択した状態で「Manage Certificates」をクリックします。
  4. 「Apple Development Certificates」に証明書がリストされていることを確認します。
    • 証明書が表示されない場合は、左下の「+」ボタンを押して証明書を作成してください。

次に、「キーチェーンアクセス」を開き、開発用の証明書を確認します。

  1. 「キーチェーンアクセス」を開き、左上のキーチェーン一覧から「ログイン」を選択します。
  2. 「分類」の「証明書」を選択し、ログインキーチェーンに保存されている証明書の一覧を表示します。
  3. 「Apple Development: <Apple IDのメールアドレス> (xxxxxxxxxx)」という名前の証明書をダブルクリックし、情報を表示します。
  4. 表示された情報の中の「部署」に設定されている文字列がチームIDです。