GitリポジトリからiOSアプリを構築する方法(QA担当者用)

※Mediumの以下のエントリの日本語版です

medium.com

このエントリはQAスタッフやテスターがGit(GitHubリポジトリからiOSアプリケーションを作成する方法についてのメモです。この記事では、次のことを想定しています。

  • 読者はiOSアプリケーション開発者ではない
  • (エミュレータでなく)実機でテストをする必要がある
  • 読者は自身のAppleアカウントを持っている
  • チームの管理者(開発者やリーダーなど)にプロジェクトに読者を追加するよう依頼することができる
  • チームのGit(GitHub)リポジトリにアクセスしてコンピュータに複製する権限および手段がある
  • スケジュールがとてもヤバく、他の望ましい方法を取る時間がない(例:TestFlight、DeployGate)

TestFlight - Apple Developer 

DeployGate - Distribute your beta apps instantly

上記に加えて、以下の経験があるとわかりやすいかもしれないです。

  • ADBコマンドでAndroid apkを端末にインストールしたことがある
  • なんでもいいのでIDEを使用したことがある

Steps

  1. Appleアカウントをデベロッパーアカウントに登録する
  2. チームの管理者にあなたをメンバーとして招待するよう依頼する
  3. Xcodeをインストールする
  4. XcodeでGitリポジトリをクローンする
  5. XcodeAppleアカウントを設定する
  6. Appleバイスをコンピュータに接続してアプリをビルドする

1. Appleアカウントをデベロッパーアカウントに登録する

まず、Apple Developerアカウントを取得する必要があります。 AppleアカウントをApple Developerアカウントとして登録することができます。

2. チーム管理者にあなたをメンバーとして招待するように依頼する

次に、あなたのチーム開発者にあなたをApple Developer [People]のメンバーとして招待するように依頼してください。プロジェクトにあなたのEメールアドレスを追加した後、招待メールが送信されます。

3. Xcodeをインストールする

Xcodeをダウンロードしてインストールします。 Xcode Betaを使用する必要がない場合は、App Storeから(通常の)Xcodeを入手できます。

※日本語版注:以下のスクリーンショットにはXcode Betaのものも含まれます

4. XcodeでGitリポジトリをクローンする

最初にXcodeを起動すると、Xcodeは以下のようなビューを表示します。 "Clone an existing project"をクリックすると、Xcodeは新しいウィンドウを開きます。 GitリポジトリのURLを入力したら、ソースファイルを取得してプロジェクトを開くことができます。

f:id:wifeofvillon:20180804231325p:plain

f:id:wifeofvillon:20180804231419p:plain

5. XcodeAppleアカウントを設定する

Xcodeであなたのチームプロジェクトを開けるようになったと思いますが、プロジェクトによっては警告が表示されるかもしれません。左ペインの上部にある左のフォルダアイコンをクリックしてプロジェクトディレクトリを開きます。

[Add Account...]をクリックし、Apple IDを入力して[Accounts]画面を開きます。それでも警告が残っている場合は開発者に確認してください。

f:id:wifeofvillon:20180804231730p:plain

f:id:wifeofvillon:20180804231751p:plain

f:id:wifeofvillon:20180804231807p:plain

f:id:wifeofvillon:20180804231821p:plain

6. Appleバイスをコンピュータに接続してアプリをビルドする

これで、元々用意されているエミュレータや実際のAppleバイスでアプリを実行できます。デバイスをコンピュータに接続して選択し、三角(再生?実行?)のボタンをクリックします。 (中央のテキストエリアでビルドの進捗状況を知ることができます)。

f:id:wifeofvillon:20180804232029p:plain

その後、git-pullで最新のソースをビルドして試すことができます。 (私の場合は、GitHub Desktopを使ってリポジトリを管理しています。使い慣れた方法で試してみてください。)

Ex. 実行中のログを取得する

Xcodeを使用してデバイス上で実行されているアプリケーションのログファイルを読むことができます。ツールバーの[Window] - [Devices]を開き、[View Device Logs]をクリックします。

f:id:wifeofvillon:20180804232124p:plain

f:id:wifeofvillon:20180804232127p:plain

TL; DR

QAをするなら断然TestFlightやDeployGateで配布されたアプリを使う方がいいので、もちろんこれは最後の手段なんですけど、このエントリを読んでいるということはもうスケジュールがやばいということだと思います。頑張ってください。

参照記事