This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

iOS 実機向けのクラウドビルドを作成して実行する

ページを編集

EAS Build を使って iOS の実機向けに開発ビルドを設定する方法を学びます。


この章では、EAS Build を使って iOS の実機で動作する開発ビルドを作成します。

iOS 実機向けの開発ビルドは、iOS アプリのインストールで標準的な .ipa 形式で生成されます。

視聴:iOS 実機向けの開発ビルドを作成する
視聴:iOS 実機向けの開発ビルドを作成する

コード署名の設定を含め、EAS Build を使って iOS 実機で開発ビルドをビルド・実行する方法を学びます。


前提条件

2

1.

Apple Developer アカウント

アプリの署名に必要な 認証情報 にアクセスするために必要です。アプリが信頼できる提供元から来たことを検証するため、各ビルドには署名が必要です。EAS Build はこれらの認証情報の管理を助けてくれます。

2.

iOS 16 以降ではデベロッパモードを有効化

デバイスに開発ビルドをインストールするには、デベロッパモードを有効にする必要があります。初めての場合や現在無効になっている場合は、デベロッパモードを有効にする を参照してください。

プロビジョニングプロファイル

iOS 実機で開発を始めるには、次のことが必要です。

1

iOS デバイスを登録する

EAS CLI で、新しい Apple デバイスを登録するコマンドを実行します。

Terminal
eas device:create

このコマンドは次の質問を表示します。

  • You're inside the project directory. Would you like to use the your-account-name account?(プロジェクトディレクトリ内にいます。your-account-name アカウントを使いますか?)Y を押します。
  • Apple ID. ここでは自分の Apple ID を入力します。すると Apple Developer アカウントにログインします。ターミナルウィンドウの手順に従ってください。
  • How would you like to register your devices?(デバイスをどの方法で登録しますか?)Website を選ぶと、iOS デバイスで開ける登録用の URL が生成されます。

2

プロファイルをダウンロードしてインストールする

デバイスの web ブラウザーで前のステップのリンクを開き、Download Profile ボタンをタップします。

設定 アプリを開くと、デバイスの登録を促されます。

インストール をタップして iOS デバイスを登録します。

プロビジョニングプロファイルがインストールされると、デバイスは web ブラウザーに戻り、処理の完了を示す成功メッセージが表示されます。

iOS 実機向けの開発ビルド

1

作成する

iOS 実機向けの開発ビルドを作成するには、build.development プロファイルで次を確認します。

  • eas.jsondevelopmentClienttrue になっていること。デフォルト設定でそうなっています。
  • 続いて、プラットフォームに ios、ビルドプロファイルに development を指定して eas build コマンドを実行します。
Terminal
eas build --platform ios --profile development

初めてビルドを作成するとき、このコマンドは次の質問を表示します。

  • What would you like your iOS bundle identifier to be?(iOS のバンドル識別子を何にしますか?)Return を押して、表示されるデフォルト値を選びます。まだ定義されていなければ、app.jsonios.bundleIdentifier が追加されます。
  • Do you want to log in to your Apple account?(Apple アカウントにログインしますか?)開発ビルドを作るのは初めてなので、Generate a new Apple Distribution Certificate(新しい Apple Distribution Certificate を生成しますか?)も尋ねられます。どちらも Y を押します。
  • Select a device for ad hoc build.(ad hoc ビルド用のデバイスを選んでください)ここが重要な部分で、事前にプロビジョニングプロファイルを登録しておいたのはこのためです。登録済みのデバイスから 1 台または全部を選び、return を押せば、後でそれらのデバイスにビルドをインストールできます。

回答するとビルドがキューに入り、EAS CLI が表示するリンクから EAS ダッシュボードで進捗を確認できます。

ビルド詳細ページには何が載っている?

ビルド詳細ページには、ビルドの種類、プロファイル、Expo SDK バージョン、アプリバージョン、ビルド番号、最後のコミットハッシュ、そしてビルドを開始した開発者またはアカウント所有者が表示されます。

上の画像では、Build artifact の現在のステータスがビルド進行中であることを示しています。完了すると、このセクションからビルドをダウンロードできるようになります。Logs には、EAS Build 上での iOS ビルドプロセスの各ステップが並びます。ここでは簡潔にするため、各ステップの詳細には触れません。詳しくは iOS のビルドプロセス を参照してください。

iOS bundle identifier とは?

ios.bundleIdentifier はアプリの一意な名前です。いまアプリを公開すると、Apple App Store はこのプロパティの値でストア上のアプリを識別します。

この表記は host.owner.app-name の形式で定義されます。たとえばサンプルアプリでは com.owner.stickersmash となり、com.owner がドメイン、stickersmash がアプリ名です。

2

インストールする

ビルドが完了すると Build artifact セクションが更新され、ビルドの完了が示されます。

このセクションには、iOS 実機で開発ビルドを実行するための手段として、Expo Orbit と Install ボタンが用意されています。

Expo Orbit を使うと、iOS 実機に開発ビルドをスムーズにインストールできます。この方法を使うには次のようにします。

  • iOS 実機を USB で開発マシンに接続します。
  • Orbit のメニューバーアプリを開きます。
  • Orbit アプリで Device を選択します。
  • EAS ダッシュボードの Build artifactOpen with Orbit をクリックします。

ビルドがインストールされると、Orbit アプリが実機上で開発ビルドを起動します。

別の方法:Install ボタンと QR コードを使う

Build artifact セクションの Install ボタンは、手軽にインストールするための QR コードを生成します。

  • Install をクリックすると、QR コードを含むポップアップが表示されます。
  • iOS 実機のカメラで QR コードをスキャンし、開いたリンクをタップして開発ビルドをデバイスにダウンロードします。

3

実行する

プロジェクトディレクトリで npx expo start コマンドを実行して開発サーバーを起動します。

Terminal
npx expo start
  • デバイスでアプリアイコンをタップして開発ビルドを開きます。
  • EAS CLI と開発ビルドの両方にログインした状態にして、アカウント同期機能を使います。EAS CLI にはすでにログイン済みなので、次は開発ビルドの UI からログインします。
  • Fetch development servers をタップし、Development servers の一覧から実行中のサーバーを選びます。

まとめ

第 4 章:iOS 実機向けのクラウドビルドを作成して実行する

EAS Build を使って iOS の実機で開発ビルドを作成・実行しました。

次の章では、1 台のデバイスに複数のアプリバリアントをインストールできるよう、app config を設定する方法を学びます。

次へ:複数のアプリバリアントを設定する