iOSアプリのプロジェクトを作成しよう
はじめに
iOSアプリのプロジェクトを作成する方法を説明します。
新T-DASHを利用するためには、最初にアプリ種類に応じた「プロジェクト」を作成する必要があります。
プロジェクトは、テストケースや要素定義、テスト実行設定などを管理する単位です。
テストスイートやテストケースの作成、要素定義などの各種設定は、プロジェクト作成後に行うことができます。
プロジェクトは利用目的に応じて自由に作成できますが、多くの場合は、自動テストを実行したいアプリケーション単位で作成します。プロジェクト数に制限はありません。
＜注意事項＞
なお、iOSアプリのプロジェクトはWindows・Macのどちらからでも作成できますが、iOSアプリや端末の登録・変更はMacから行う必要があります。Windowsではプロジェクトの作成のみ可能です。
＜プロジェクト構成イメージ＞
- 新T-DASH
- プロジェクトA
▪ 自動実行したいテストケース
▪ テスト対象の画面情報
▪ テスト実行用の設定情報 - プロジェクトB
▪ 自動実行したいテストケース
▪ テスト対象の画面情報
▪ テスト実行用の設定情報
- プロジェクトA
ゴール
iOSアプリのプロジェクトを作成できること
前提
新T-DASHのライセンス認証が完了していること
もくじ
詳細
1. プロジェクトを作成する
iOSアプリプロジェクトの作成方法は、使用しているOSによって手順が異なります。
まず、以下の共通手順でプロジェクト種類とプロジェクト名を設定します。
その後、使用しているOSに応じて手順を参照してください。
1.｢プロジェクト一覧」画面で「＋プロジェクトを作成」ボタンをクリックします。
2.プロジェクト種類「iOSアプリ」をプルダウンリストから選択します。
3.プロジェクト名を100文字以内で入力します。
文字種に制限はありません。
4.以降の操作手順は、使用しているOSによって異なります。該当するOSの手順を参照してください。
Windows OSの場合
1.Windows OSの場合はプロジェクトの作成時にiOSアプリを登録できません。
対象アプリはテスト実行時に、接続先のリモートPC（Mac）側で選択します。
2.プロジェクト名を入力後、「作成」ボタンをクリックします
Mac OSの場合
- プロジェクト名を入力後、｢次へ｣ ボタンをクリックします。
- デバッグやテスト実行に使用するアプリ設定を行います。
以下どちらかを選択します。
• 登録済みのアプリから設定
• 新規アプリを登録
登録済みのアプリから設定
「アプリ設定」画面にて登録済みのiOSアプリをプロジェクトに設定します。
1.｢登録済みアプリを検索」をクリックするとプロジェクトで使用できる登録済みアプリの一覧が表示されます。設定するアプリを選択します。アプリ名入力で検索することもできます。
2.登録済みのアプリを編集する場合は、「対象アプリ編集」リンクをクリックしてください。
iOSアプリの編集方法は、「iOSアプリを登録・編集しよう」をご覧ください。
3.アプリを選択すると、「プロジェクトへ設定したアプリ」にアプリ名とファイルパスが表示されます。
4.「作成」ボタンをクリックします。
新規アプリを登録
新規でiOSアプリを登録し、プロジェクトに設定します。
iOSアプリは、アプリ種別を「IPAファイル」（①）、「APPファイル」（②）または「インストール済みアプリ」（③）から選択します。
また、登録するアプリ種別に応じてファイルパスやBundle ID（④）、必要に応じてチームID（⑤）を指定します。
| 用語 | 説明 | |
| ① | IPAファイル | iOS実機で使用するアプリファイル（.ipa）です |
| ② | APPファイル | iOSシミュレータで使用するアプリファイル（.app）です |
| ③ | インストール済みアプリ | iOS端末にすでにインストールされているアプリを使用します 対象のアプリを特定するため、Bundle IDを入力します |
| ④ | Bundle ID | iOSアプリを識別するための情報です ※取得方法は BundleIDの取得方法 に記載 |
| ⑤ | チームID | WebDriverAgent（WDA）の署名に使用するApple DeveloperのチームID（xcodeOrgId）です iOSシミュレータで実行する場合、またはWDAを手動で署名済みの場合は、入力する必要はありません（IPAファイルでの実機テストは設定推奨） |
- アプリ名を30文字以内で入力し、アプリ種別を以下のいずれかから選択します。
• IPAファイル
• APPファイル
• インストール済みアプリ
【IPAファイル】
1.「参照」をクリックし、対象アプリのIPAファイルを選択し、チームID（任意）を入力します。
iPhone実機テストを行う場合はチームIDの設定と、有料の「Apple Developer Program」の加入が必要です。
2.「作成」ボタンをクリックします。
【APPファイル】
1.「参照」をクリックし、対象アプリのAPPファイルを選択します。
2.「作成」ボタンをクリックします。
【インストール済みアプリ】
1.Bundle IDとチームID（任意）を入力します。
2.「作成」ボタンをクリックします。
2. プロジェクトを確認する
1.プロジェクトの作成が完了すると、作成したプロジェクトの「分析レポート」画面が表示されます。
2.グローバルヘッダーの左側に、プロジェクト名と設定したアプリ名が表示されます。
3.グローバルヘッダーの「プロジェクト一覧へ｣ をクリックすると、プロジェクト一覧画面に作成したプロジェクトが表示されていることを確認できます。
なお、「プロジェクト一覧」画面には、過去に作成したプロジェクトも含めて、一覧で表示されます。
一覧からプロジェクト名をクリックすると、該当プロジェクトの「分析レポート」画面へ遷移できます。
3. 他の種類のアプリのプロジェクトを作成する場合
iOSアプリ以外のプロジェクトを作成する場合は以下のチュートリアルをご覧ください。
4. BundleIDの取得方法
BundleIDは、アプリの保存形式やインストール先によって取得方法が異なります。以下のいずれかの方法で確認してください。
① Macに保存されているAPPファイル（.app）の場合
1.Macの「ターミナル」を起動します。
2.以下のコマンドを実行します。
mdls -name kMDItemCFBundleIdentifier "取得対象アプリのパス"実行結果の kMDItemCFBundleIdentifier に表示された値がBundleIDです。
※ アプリによっては、このコマンドでBundleIDを取得できない場合があります。その場合は、アプリ内の Info.plist に設定されている CFBundleIdentifier を確認してください。
② Macに保存されているIPAファイル（.ipa）の場合
IPAファイルからBundleIDを取得する場合は、ファイルを展開して確認します。
1. IPAファイルの拡張子を .ipa から .zip に変更し、展開します。
2. 展開した Payload フォルダ内にある .appファイルを確認します。
3. Macの「ターミナル」を起動し、以下のコマンドを実行します。
/usr/libexec/PlistBuddy -c "Print CFBundleIdentifier" "対象アプリパス.app/Info.plist"※ 「取得対象アプリ」 の部分は、実際のアプリのパスに置き換えてください。（.appは拡張子）
4.表示された値がBundleIDです。
③ iOSシミュレーターにインストールされているアプリケーションの場合
1. 対象のiOSシミュレーターを起動します。
2.Macの「ターミナル」を起動します。
3.以下のコマンドを実行します。
xcrun simctl listapps booted4.起動中のシミュレーターにインストールされているアプリの一覧が表示されます。
5.一覧から対象のアプリを探し、CFBundleIdentifier の値を確認します。CFBundleIdentifier = "com.apple.Maps" の部分がBundleIDです。
（例）iPhone標準のMapアプリ
※ 複数のシミュレーターを起動している場合は、対象のシミュレーターのUDIDを指定して実行してください。
xcrun simctl listapps "シミュレーターのUDID"
