メインコンテンツへスキップ

.appファイルの作成方法

  • 更新

 

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

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

目次

  1. Xcodeを使う場合
  2. Bitriseを使う場合
    1. Bitrise初期設定
    2. Bitriseでシミュレータ用にiOSアプリをビルドする
    3. テスト作成に必要な.appファイルを用意する
    4. トラブルシューティング
  3. Cordovaアプリの場合
  4. React Nativeアプリの場合
    1. 「No bundle URL present」エラーが出る場合
    2. デバッグビルド使用時にアプリが起動できない場合

1.Xcodeを使う場合

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

Screenshot 2023-11-06 at 9.24.32.png
 

Screenshot 2023-12-12 at 11.15.08.png
.appファイルの生成・取得

 

2.Bitriseを使う場合

2-1.Bitrise初期設定

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

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

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

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

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

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

__________2022-06-28_16.37.29.png

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

__________2022-06-28_16.53.32.png

名前などを入力します。

__________2022-06-28_16.56.22.png

ユーザ登録が完了しました。スタートページに移動したら「Start with Bitrise CI」を押します。

Bitrise_2_welcome.png

「Get Started with Bitrise CI」に遷移したら、「New CI project」を押します。
Bitrise_3_start with CI.png
するとアプリのビルド設定の画面になるので、ここでビルドの設定をしていきます。

Bitrise_4_ci_top.png

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

  • Project access:

    • Bitriseの設定を一般公開するかを指定します。Privateでよいでしょう。

      Bitrise_5_ci_project_access.png
  • Select repository:

    • ビルドしたいiOSアプリのソースコードが入っているGitレポジトリを指定しましょう。GitHub/Bitbucket/GitLabが選べます。手元にちょうどいいアプリが無い場合、MagicPodデモアプリのプロジェクトをGitHub上でフォークして使用してもらっても構いません。

      Bitrise_6_ci_select_repository.png
  • Setup repository access:
    • GitHubのサブモジュールの機能を使っているなど、追加で別のプライベートGitレポジトリにアクセスする必要がある場合は、「I need to」で必要な設定を行います。特に心当たりがなければ「No, auto-add SSH key」を選択しましょう。__________2022-06-28_17.34.27.png
  • Choose branch

    • 「master」などの、ビルドするGitのブランチ名を指定します。

      Bitrise_8_ci_choose_branch.png

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

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

mode3_w1024-Screen-Shot-2019-03-14-at-10.12.23-1024x509.png

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

  • Default configuration
    • MagicPodクラウドテストはモバイルアプリテストなので「iOS」を選択します。
Bitrise_9_ci_default_configuration.png

「Distribution method」はMagicPodクラウドテストでは関係ないのでとりあえず「ad-hoc」を選んでおきます。※2

Bitrise_10_distribution_method.png

 

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

Bitrise_11ci_view_1st_build.png

 


 

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

Bitrise_12_failed.png

 

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

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

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

Bitrise_13_edit_workflow.png

ここで、左にある「Xcode Build for testing for iOS」の三点メニューを押して、このステップを削除します。

Bitrise_14_delete.png

 

次に、「Git Clone Repository」のすぐ下にカーソルを当て、「＋」を押し、

Bitrise_15_add_step.png

 

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

Bitrise_16_select_app.png

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

Bitrise_17_save_changes.png

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

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

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

Bitrise_20_success.png

 

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

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

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

まず、成功したビルド結果を押します。

Bitrise_21_select_result.png
 
 
ビルド結果の「Artifacts」タブを押して、作成されたアプリファイルをダウンロードします。
Bitrise_22_artifacts_download.png
 
zipファイルをダウンロードした後、一度解凍し、再度zip圧縮してください。BitriseでビルドしたzipファイルはそのままMagicPodのテストに利用すると、フォルダ構成によりうまく動かないためです。
 

2-4.トラブルシューティング

Bitriseでビルドしたappファイルのテストが失敗する

Bitriseの「Xcode build for simulator」のステップが、Keychainにうまくアクセスできる.appファイルを生成できていない可能性があります。

詳しくはこちらのヘルプページの内容をご確認ください：Bitriseでビルドしたappファイルのテストが「Client has neither application-identifier nor keychain-access-groups entitlements」で失敗する

 

3.Cordovaアプリの場合

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

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

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

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

Screen-Shot-2020-02-02-at-22.03.20.png
 

UICatalog.appのパス

 

4.React Nativeアプリの場合

4-1. 「No bundle URL present」エラーが出る場合

Xcodeを使う場合の手順で.appファイルを生成した際に「No bundle URL present」エラーが出ることがあります。本エラーが出た場合は以下の方法でビルドを行ってください。(参照: No bundle URL present [fixed])

1. Xcodeの既存のtargetを複製する

2. .jsbundleファイルを作成する
ReactNativeプロジェクトのルートディレクトリにて以下を実行する

$ npx react-native bundle --entry-file='index.js' --bundle-output='./ios/main.jsbundle' --dev=false --platform='ios'

ビルドしたアプリで画像が表示されないトラブルが起きた場合は以下を実行する（参照）

$ npx react-native bundle --entry-file='index.js' --bundle-output='./ios/main.jsbundle' --platform='ios' --assets-dest='ios'

3. ビルド時に.jsbundleファイルを含める
Xcode上で手順1で作成したtargetのBuildPhases > Copy Bundle Resourcesに手順2で作成したmain.jsbundleを追加する

4. ビルドする
Xcode上で手順1で作成したtargetを選択し、ビルドを行う

 

4-2. デバッグビルド使用時にアプリが起動できない場合

リリースビルドに変更してください。デバッグビルドを使用しているとシミュレータを起動しているPCのローカルファイルを参照しようとするために発生する問題が確認されています。（参照）

 

 

 

※注釈・出典

  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シミュレータビルドに不要なので、邪魔なら削除してもよいです。

関連記事