Appファイルの作成方法

iOSシミュレータでテストを行うには、アプリの実体である「Appファイル」が必要です。

各ユーザーのアプリでテストを行う場合、Appファイルをアプリ開発担当者に用意してもらうか、以下の1〜3のいずれかの手順でアプリのソースコードからAppファイルを生成・取得してください(IPAファイルからAppファイルを生成することはできません。IPAファイル内からAppファイルを取り出してもシミュレータでは動作しません。)。なお、MagicPodが提供するデモアプリのAppファイルをダウンロードして使うことも可能です。

目次

1. Bitriseを使う場合
   1. Bitrise初期設定
   2. Bitriseでシミュレータ用にiOSアプリをビルドする
   3. テスト作成に必要なappファイルを用意する
2. Xcodeを使う場合
3. Cordovaアプリの場合

1.Bitriseを使う場合

1-1.Bitrise初期設定

Bitriseは、最近人気のiOS・Androidアプリのビルドをクラウド上で行えるCIサービスです。最近は色々なCIサービスがありますが、Bitriseには以下のような特徴があります。

• 無料版から使い始められる
• モバイルアプリのビルドに特化している
• 以下のようなGUIでビルド設定が簡単に行える

ワークフローの設定内容はbitrise.ymlというファイルに集約されており、これを直接編集したり、Gitレポジトリで管理することもできるようです。※1

では新規登録から説明します。

• このページではiOSについて説明していますが、Androidもほぼ同じです。Androidの詳しい設定方法についてはBitriseとMagic PodでAndroidアプリもCI & 自動テストをご覧ください。

まずBitriseに新規登録して初期設定を行いましょう。

Bitriseサインアップページへ移動しユーザ登録をします。

Bitriseから「Confirmation instructions」という件名のメールがくるので「Confirm My Account」を押します。

名前などを入力します。

ユーザ登録が完了しました。スタートページに移動したら「Add new app」を押します。

するとアプリのビルド設定の画面になるので、ここでビルドの設定をしていきます。

必要な設定は以下の通りです。

• CHOOSE ACCOUNT:
  • Bitriseの設定を一般公開するかを指定します。Privateでよいでしょう。
• Connect your repository:
  • ビルドしたいiOSアプリのソースコードが入っているGitレポジトリを指定しましょう。GitHub/Bitbucket/GitLabが選べます。手元にちょうどいいアプリが無い場合、MagicPodデモアプリのプロジェクトをGitHub上でフォークして使用してもらっても構いません。
• Setup repository access:
  • GitHubのサブモジュールの機能を使っているなど、追加で別のプライベートGitレポジトリにアクセスする必要がある場合は、「I need to」で必要な設定を行います。特に心当たりがなければ「No, auto-add SSH key」を選択しましょう。
• Choose branch
  • 「master」などの、ビルドするGitのブランチ名を指定します。

ここまで設定すると、Bitriseがレポジトリの内容を解析して、ビルド設定を自動で作成してくれます。

ここで、以下のようなエラーメッセージが出る場合があります。

とりあえずiOSシミュレータでMagicPodのテストをしたいだけの場合は、「Proceed anyway」を選んで先に進んでください。
直近で実機用のビルドも考えている場合は、ちゃんと修正した方がよいです。こちらの記事に従い、Xcode上でビルドShemeをSharedにして、xcshareddataをGitレポジトリにコミットしましょう。その後Bitriseのビルド設定に戻り、「Scan another branch」の項目を選んで(ブランチ名はそのままにします)、ビルド設定を再開します。

続いて以下のような「Select ipa export method」を選択するよう言われますが、MagicPodクラウドテストの場合は関係ないのでとりあえず「ad-hoc」を選んでおきます。※2

アプリアイコンを設定する場合はここで「Choose Image and Proceed」を押します。

最後のWebhook setupを行うと、Gitレポジトリに変更（PushまたはPull Request）が入るたびに自動ビルドが行われるようになります。ぜひとも「Register a Webhook for me!」を選んでおきましょう。※3

以上で初回セットアップは終了です。最後に以下画像のボタンを押すと自動でビルドが始まります。

しかし、１回目は以下のように最初のビルドは失敗してしまうはずです。

1-2.Bitriseでシミュレータ用にiOSアプリをビルドする

初回のビルドが失敗した原因は、iOS実機用のビルドに必要な設定が不十分だったためです※4。ですが、今回紹介する手順はiOSシミュレータに対するビルド設定なので、実機用の設定は削除して、シミュレータ用の設定に差し替えましょう。

まず、ビルド結果画面の上にある「Edit workflow」というボタンを押して、ビルドワークフローの編集画面に移動します。

ここで、左にある「Xcode Archive & Export for iOS」を選択し、

「Delete Step:Xcode Archive & Export for iOS」を押しこのステップを削除します。

次に、「Deploy to Bitrise.io - Apps, Lo...」のすぐ上の「+」ボタンを押し、

「Xcode build for simulator」のステップを検索して追加します※5。

ここまでできたら、画面右上の保存ボタンで変更を保存し、

画面上のアプリ名を押してビルド画面へ移動します。

失敗したビルド結果の「Rebuild」ボタンから再度ビルドを実行します。

今度はビルドが成功するはずです。

1-3.テスト作成に必要なappファイルを用意する

アプリの自動ビルドができるようになったので、次はMagicPodのクラウド端末を使ってテストを作成するためのシミュレータ用アプリ実体ファイルであるappファイルを用意しましょう。

簡単な設定を行えば、Bitriseでビルドされたappファイルがダウンロードできます。

まず、「Workflow」タブを押し、先ほどのWorkflow Editor画面へ移動します。

2.Xcodeを使う場合

1. Xcode(Macが必要です)でアプリのプロジェクトを開きます。
2. ビルド対象を適当なiOSシミュレータに変更します。([1])
3. ビルドを行います。([2])
4. ビルドが成功すると、Productsフォルダの下にAppファイルが生成されています。([3])
5. ファイルを右クリックして「Show in Finder」を選択すると、Appファイルのある場所を開くことができます。([4])　※見つからない場合は/Users/○○/Library/Developer/Xcode/DerivedData/△△△△/Build/Products/Debug-iphonesimulatorを参照してください。

appファイルの生成・取得

3.Cordovaアプリの場合

まず、こちらの手順に従い、「cordova emulate ios」コマンドでiOSシミュレータ上にテスト対象のiOSアプリをインストールします。

インストールできたら、iOSシミュレータ上でアプリを立ち上げます。

続いてMacのターミナルを開き、「ps aux | grep アプリ名」を実行します。アプリ名は通常Cordovaのプロジェクト名と同じで、部分一致も可能です。

これで以下のように結果が見つかれば、そこに.appファイルのパスが含まれているはずなので、これをコピーしてきて利用します。

UICatalog.appのパス

なお、.appファイルの実体はディレクトリ なのですが、Macのマシン上ではファイルのようにして扱うことができます。

※注釈・出典

1. bitrise.ymlをリポジトリ内で管理するための手引き
2. この設定はiOS実機用のipaファイルをビルドする場合の設定ですが、MagicPodのクラウドテストではiOSシミュレータを使うのでipaファイルはビルドしません。
3. 後からWebhookを設定する場合、ビルド設定の「Code」タブから可能です。
4. ビルドのLogを確認すると「No profiles for '***' were found: 」というエラーが出ているはずです。
5. ちなみに「Do anything with Script step」「Certificate and profile installer」のステップは今回のiOSシミュレータビルドに不要なので、邪魔なら削除してもよいです。