今回のエンジニアブログ担当の岩原です。
３回前、前々回、前回に引き続き、今回もJenkinsについて書きたいと思います。
今回で最終回です。
まずは、前回までのおさらいとTestFlightについて。
・Jenkinsとは Javaで作られているCIサーバーの１つです。 オープンソースなので、手軽に利用できます。 ・そもそもCIサーバーとは？ 継続的インテグレーション(continuous integration)のためのアプリケーションサーバーのことです。 ビルドやデプロイ、ユニットテストなどのソフトウェアの開発にかかるいろいろな手順を代わりに自動でやってくれる賢いヤツです。 ・TestFlightとは 開発中のアプリケーションを共有できるサービスです。 XCodeをインストールしなくてもipaファイルをインストールできるので、 開発者でなくても開発中のiOSアプリケーションを動かすことができます(Androidにも最近対応)。
構築にあたっての前提は以下のとおりです。
【前提】
・Macであること。(要OS X 10.5以上)
・Xcodeがインストール済みであること。
・XcodeからCocos2d-xのiOSアプリがビルド＆実行が出来る状態であること。
・Eclipseなどを使用して、Cocos2d-xのAndroidアプリがビルドできる状態であること。
・ソースがGitで管理されていること(別のSCMを使用している場合は適宜読み替えてください)
・TestFlightが利用できるようになっていること
今回は、太字の箇所について書きたいと思います。
取り消し線の箇所は前回までに取り上げた箇所です。
HomeBrewのインストールGitのインストールJenkinsのインストールプラグインのインストール＆アップデートJenkinsの設定変更(Git)ジョブの作成(iOS)ビルドの実行(iOS)Androidのビルドの準備Antのインストール(Jenkinsから自動インストール)ジョブの作成(Android)ビルドの実行(Android)- TestFlightへのアップロード設定
- ジョブの設定変更(iOS、Android)
今回はTestFlightへのアップロードを自動化するまでを行います。
12.TestFlightへのアップロード設定
TestFlightへのアップロードを簡略化するため、TestFlightプラグインを導入します。
プラグインのインストール方法詳細は３回前の記事を参照してください。
導入するプラグインは「Testflight plugin」になります。
次にTestflightプラグインの設定を行います。
設定はJenkinsの管理画面から行います。
管理画面の下ほどにある「Test Flight」セクション内にある「追加」ボタンをクリックします。
「Token Pair Name」、「API Token」、「Team Token」の３項目すべて入力の必要があります。
「Token Pair Name」は識別するための名前なので、好きなように決められますが、
その他２項目はTestFlightにて指定された値を入力する必要があります。
ということで、TestFlightのページを開いてみましょう。
ここをクリックすると、TestFlightのページを新しいタブで開きます。
画面右上のプロフィール画像をクリックし、「Account Settings」をクリックします。
プロフィール画面の左側にある「Upload API」をクリックします。
Upload API画面のUpload API Tokenの枠内にある文字列をコピーします。
このTokenはJenkinsの「API Token」に入力する文字列となります。
次に、チーム名をクリックし、「Edit Info」をクリックします。
Team Info画面内のTeam Token枠内にある文字列をコピーします。
このTokenはJenkinsの「Team Token」に入力する文字列となります。
以上、３項目を入力後、最下部にある保存ボタンをクリックします。
13.ジョブの設定変更(iOS、Android)
ジョブの設定を変更し、ビルドされたアプリをTestFlightへ自動アップロードするように設定します。
下部の「ビルド後の処理の追加」ボタンをクリックし、Upload to TestFlightを選択します。
「Token Pair」には、Jenkinsの管理画面で設定した「Token Pair Name」を選択します。
「IPA/APK Files (optional)」には「成果物を保存」にて指定しているものと同じファイルを指定します。
「dSYM File (optional)」は空欄で問題ありません。
「Build Notes」には、TesFlightへアップロードする際に、リリースノートに設定する共通のメッセージを指定します。
「Append changelog to build notes」にチェックを入れると、SCMのコミットログをリリースノートに含めることができます。
「高度な設定」をクリックし、さらに詳細な設定を開きます。
基本的に、「高度な設定」に設定するのはオプション項目となります。
「Distribution Lists」には、アプリを利用できるDistributionを指定します。
「Distribution Lists」を確認するには、TestFlightからpeople画面を開く必要があります。
表示されているpeople画面の左部にある「Distribution Lists」以下にあるリストが対象です。
「Notify Team」にチェックを入れると、TestFlightへアップロード後、チームメンバーにメールを送信するようになります。
その際、メールの差出人は、Upload API Tokenの設定を行った人物となり、
本文にリリースノートの内容が記述されます。
「Replace Build」にチェックを入れると、buildsを置き換えるようになります。
「Debug Upload」にチェックを入れると、コンソールにアップロードログが表示されるようになります。
「保存」ボタンをクリックし、設定を保存します。
設定完了後、ビルドを実行するとTestFlightへのアップロードが行われるようになります。
以上でTestFlightへのアップロードは完了です。
ビルドに成功すれば、TestFlightへ成果物がアップロードされます。