Xcodeで適当なbundle identifierを持つ適当なプロジェクトを作成してください。
(既存のプロジェクトと被らないようなbundle identifierで)
Xcodeのプロジェクト作成完了後、git initで初期化してください。
fastlaneを動かすruby環境を構築するために、rbenvを利用します。
$ brew install rbenv
$ brew install ruby-build
rbenvにパスを通すために、
~/.bash_profile に以下を追記します。
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
~/.bash_profileを再読込し、
rubyの2.3.1をインストール、
それから、現在のディレクトリのrubyバージョンを2.3.1で指定します。
$ source ~/.bash_profile
$ rbenv install 2.3.1
$ rbenv local 2.3.1
今回必要なgemをGemfile.lockからインストールするために、
Bundlerをインストールします。
$ gem install bundler
bunlderがインストールされたので、Gemfile.lockから 今回必要なgemをインストールします。
$ bundle install --path vendor/bundle
matchが生成・更新・管理する証明書やProvisioning Profileを格納するためのリポジトリを作成します。
証明書、Provisioning Profileを格納するため、
bundle exec fastlane...を実行する度にAppleIDやbundle identifierを何度も入力するのが面倒なので、このタイミングでfastlane initを実行し、Appfileを生成するようにします。
$ bundle exec fastlane init
一番最初に作成したiOSプロジェクトのディレクトリでmatchを使用する準備を行います。
$ bundle exec fastlane match init
これにより、証明書、Provisioning Profileの更新があった際に
match用のリポジトリに証明書、Provisioning Profileがpushされるようになります。
準備が整ったので、以下のコマンドでAdHoc用の証明書、Provisioning Profileを作成します。
このタイミングで証明書、Provisioning Profileを暗号化するためのpassphraseを入力しますが、これはCircleCI上でファイルを復号する際に必要になりますので、忘れないようにしてください。
$ bundle exec fastlane match adhoc
これを実行することで、Apple Developer Center上に証明書とProvisioning Profileが作成され、
Keychain Accessにも秘密鍵、証明書が取り込まれた状態になります。
bundle exec fastlane initで生成されたFastfileについて、以下の内容のみを残すように編集します。
また、Auto Signingが有効になっていると、コマンドライン経由でのアーカイブに失敗するため、このタイミングでAuto Signingをオフにしておきます。
default_platform :ios
platform :ios do
desc "Runs all the tests"
lane :test do
end
desc "distribute latest app ipa via DeployGate"
lane :beta do
// AdHoc用の証明書、Provisioning Profileをダウンロード、インストール
match(type: 'adhoc')
// AdHoc用のipaファイルをビルド
gym(export_method: 'ad-hoc')
end
end
ローカルで以下を実行し、処理が成功することを確認します。
$ bundle exec fastlane beta
fastlaneをCircleCI上で実行するための準備を行います。
CircleCIでは、Ubuntuがデフォルトのビルドイメージになっていますので、まずこれをOS Xに変更します。
次にcircle.ymlを作成し、以下の内容を記述します。
machine:
xcode:
version: '8.3.3'
environment:
override:
LANG: en_US.UTF-8
dependencies:
cache_directories:
- 'vendor/bundle'
override:
- bundle install --path vendor/bundle
test:
override:
- bundle exec fastlane test
deployment:
deploygate:
branch: master
commands:
- bundle exec fastlane beta
fastlaneをCI環境で利用する際に必要になる以下の環境変数を設定します。
- MATCH_PASSWORD
(暗号化した証明書、Provisioning Profileの復号のために必要) - FASTLANE_PASSWORD
(matchが必要に応じてiOS Developer Centerにアクセスするために必要) - MATCH_KEYCHAIN_NAME
(CircleCI特有。CircleCIがデフォルトのkeychainをcircle.keychainとしているため、circleと設定する必要がある。) - MATCH_KEYCHAIN_PASSWORD
(keychainのパスワード。CircleCIの場合はcircle)
通常、CircleCIなどのCIサーバから複数のプライベートリポジトリへのアクセスは許可されていません。
そのため、user keyを設定し、ホスティングサービスののユーザーとして複数のプライベートリポジトリへのアクセスを可能にします(2つのリポジトリに対してread権限のみを持つユーザーが望ましいです)
各プロジェクトの編集画面(歯車のアイコン)を選択し、プロジェクト編集画面へ遷移
→PERMISSIONS > Checkout SSH keysを選択し、Authorize with GitHubをクリック
Create and add USERNAME user keyをクリック
user keyが追加されたことを確認
ここまで完了した段階でビルドを実行すると、CircleCI上で.ipaファイルが作成できるようになっていると思います。
各プロジェクトの編集画面(歯車のアイコン)を選択し、プロジェクト編集画面へ遷移
→PERMISSIONS > Checkout SSH keysを選択し、画面を右クリック
Inspect Elementを選択
Networkタブの選択後、Create Username user key をクリック
ネットワークタブから、checkout-keyを選択し、生成されたuser keyの公開鍵をコピー
Bitbucketの設定画面へ遷移し、SSH keys > Add Keyからコピーした公開鍵を登録
SSH Keysに公開鍵が登録されたことを確認
ここまで完了した段階でビルドを実行すると、CircleCI上で.ipaファイルが作成できるようになっていると思います。
CircleCI上で.ipaファイルが作成できるようになったので、それをDeployGateで配布してみます。
Fastfileのbeta laneを以下のように編集します。
(DEPLOYGATE_API_TOKEN、DEPLOYGATE_USERは環境変数として定義します)
platform :ios do
desc "distribute latest app ipa via DeployGate"
lane :beta do
// AdHoc用の証明書、Provisioning Profileをダウンロード、インストール
match(type: 'adhoc')
// AdHoc用のipaファイルをビルド
gym(export_method: 'ad-hoc')
deploygate(api_token: DEPLOYGATE_API_TOKEN,
user: DEPLOYGATE_USER,
message: "fastlane study test message")
end
end
※ user, api_tokenはDeployGateのアカウント設定画面に表示されています。
これをpushし、CircleCIで実行することで、CircleCI上での自動ビルド&自動配布が実現�できました。
お疲れさまでした！