前置き

iOSアプリの複数人開発で一番厄介なのが「証明書」周りですよね。新しい開発メンバーがJoinしてくると、最小限でも以下の作業が発生してきます。

AppleDeveloperアカウントの新規作成
新メンバーをDeveloperPortalへ招待
証明書・プロビジョニングファイルの作成・更新

基本的には、AutomaticSigningによって自動的に証明書・プロビジョニングファイル周りが設定されますが、厳密なプロジェクトだと証明書を新規作成してはならない。などの制約がある場合があります。

また、CI/CDを運用している場合、どうやってCI上で証明書・プロビジョニングファイルを扱うかといった問題も発生してきます。

そこで、今回は fastlane の match を使って証明書を管理するようにして、簡単に証明書・プロビジョニングファイルの共有・更新を行えるようにします。

Fastlane

FastlaneとはiOS/Androidで必要な様々な作業を自動化してくれる便利ツールです。

fastlane.tools

ipa/apkファイルの作成
AppStoreConnect/GooglePlayへアプリのアップロード
AppStoreConnect/GooglePlayへのメタデータ登録・更新
テスト実行
iOSの証明書・プロビジョニングファイル管理
AppDistribution/TestFlightなどへのアップロード

Fastlane match

Fastlaneのmatchとは、開発チームで共有の証明書・プロビジョニングファイル作成や更新を行い、プライベートリポジトリに格納して、全メンバーで共有できるようにするものです。

メンバーが追加されたら、fastlane matchを使って、管理されている証明書・プロビジョニングファイルを自動で登録・更新してくれるようになるため、AppleDeveloperアカウントを作成したりなどの、面倒な作業をする必要がなくなります。

ざっとしたフローは以下のような感じになります。

フロー図では、makeコマンドを実行していますが、この記事ではfastlaneコマンド実行用のmakeファイルを作成しているので、記事に合わせたコマンドとなっています。

導入手順

fastlane導入には、homebrewやrubyGemを使う方法など、いくつかありますが、今回はrubyGemを利用する方法とします。

また、各バージョン管理には asdf を利用していますので、各環境に合わせて読み替えください🙇‍♀

個人的には asdf のみで様々なツールのVersion管理ができるので、この際に入れてみるのも良いかと思います。

asdf-vm.com

証明書管理用のリポジトリ作成

fastlaneでは証明書をリポジトリで管理するため、Privateの専用リポジトリを先に準備しておく必要があります。

Ruby, Bundlerの設定・インストール

rubyは 2.7.2 を使用します。

システムで利用するrubyのバージョンを変更する必要はないので、local（ワーキングディレクトリ直下のみ適用）で2.7.2を動かすようにします。

$ asdf install ruby 2.7.2
$ asdf local ruby 2.7.2

rubyの設定が終わったら、bundlerをインストールします。

$ gem install bundler

fastlaneのインストール

fastlaneをrubyGem経由でインストールするため、Gemfileを作成します。以下の内容をコピペしてもらえば大丈夫です。

Gemfileは、<project_name>.xcodeproj があるディレクトリに作成してください。

source "https://rubygems.org"

gem "fastlane"

plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
eval_gemfile(plugins_path) if File.exist?(plugins_path)

Gemfileを作成したら、以下のコマンドを実行して、fastlaneをインストールします。

$ asdf exec bundle update

fastlaneの初期設定

以下のコマンドでfastlaneを使用するための初期設定を行います。

コマンドを実行すると、どのようにfastlaneを初期設定するかの選択肢が表示されますので、「4」の手動設定を選択しておきます。

$ asdf exec bundle exec fastlane init
[✔] 🚀 
[✔] Looking for iOS and Android projects in current directory...
[02:25:58]: Created new folder './fastlane'.
[02:25:58]: Detected an iOS/macOS project in the current directory: '<project_name>.xcodeproj'
[02:25:58]: -----------------------------
[02:25:58]: --- Welcome to fastlane 🚀 ---
[02:25:58]: -----------------------------
[02:25:58]: fastlane can help you with all kinds of automation for your mobile app
[02:25:58]: We recommend automating one task first, and then gradually automating more over time
[02:25:58]: What would you like to use fastlane for?
1. 📸  Automate screenshots
2. 👩‍✈️  Automate beta distribution to TestFlight
3. 🚀  Automate App Store distribution
4. 🛠  Manual setup - manually setup your project to automate your tasks
? 4

fastlane matchの初期設定

証明書管理はfastlaneのmatchを使って行うため、fastlaneの設定が終わったら、matchの初期設定を行います。

どの環境で証明書を管理するか聞かれるため、「1」のGitを選択します。

$ asdf exec bundle exec fastlane match init
[✔] 🚀 
[02:31:47]: fastlane match supports multiple storage modes, please select the one you want to use:
1. git
2. google_cloud
3. s3
4. gitlab_secure_files
?  1

選択すると、リポジトリのURLを聞かれるので、https or sshのコピペします。

[02:32:05]: Please create a new, private git repository to store the certificates and profiles there
[02:32:05]: URL of the Git Repo: <https or sshのリポジトリURL>

[02:36:51]: Successfully created './fastlane/Matchfile'. You can open the file using a code editor.
[02:36:51]: You can now run `fastlane match development`, `fastlane match adhoc`, `fastlane match enterprise` and `fastlane match appstore`
[02:36:51]: On the first run for each environment it will create the provisioning profiles and
[02:36:51]: certificates for you. From then on, it will automatically import the existing profiles.
[02:36:51]: For more information visit https://docs.fastlane.tools/actions/match/

AppStoreConnect APIの設定

fastlaneのみで証明書・プロビジョニングファイルを作成・削除・更新ができるわけではありません。

AppStoreConnectのAPIを利用することで、TestFlight配信・ユーザーの追加などを行うことができます。

App Store Connect にアクセスし、「ユーザとアクセス」から「キー」タブをクリックします。

権限がない場合「キー」タブは表示されていません

新しいAPIキーを生成する場合には、確認画面が表示されるので、内容を確認して「提出」ボタンをクリックすると、上記画面に遷移します。

「APIキーを生成」をクリックすると、以下のAPIキー登録画面が表示されます。

「名前」にはどこで利用されているAPIキーなのかなど、識別しやすい名前を入力します。

「アクセス」では、APIキーに付与する権限を設定します。fastlaneでは「App Manager」の権限を付与します。

APIキーが生成されると、APIへ接続するために必要な情報が表示されます。APIキーをダウンロードをクリックして、キーをダウンロードします。

「APIキーをダウンロード」は1度しかできないため注意しましょう。

また、

Issuer ID
キーID

は、fastlaneの処理を記述する際に必要になるため、メモしておきます。

envファイル作成の前準備

fastlaneでは、APIに接続するために必要な情報を変数に渡す必要があります。

各接続情報をハードコードしてしまうと、Githubに掲載されてしまうため、万が一のときにインシデントになってしまう場合があります。

そのため、接続情報などは全てenvファイルで管理するようにします。

先程ダウンロードした、キー情報もenvファイルに記述する必要がありますが、そのままの内容を記述するわけではなく、base64化したものをenvファイルへ記述します。

以下のコマンドを実行して、APIキー情報をbase64化します。出力された結果をメモしておきます。

$ cat AuthKey_KEYID.p8 | base64

envファイルの作成

作成するファイルは2つです。

.env
.env.skel

.env は実際に値が入っているもの、.env.skel はどのようなキーを設定する必要があるのかのSkeletonファイルとなります。

ひとまず .env.skel を作成します。

### 以下を .env.skel にコピー
ASC_KEY_ID=
ASC_ISSUER_ID=
ASC_KEY_CONTENT=
MATCH_PASSWORD=
FASTLANE_USER=

そして .env ファイルも作成して、AppStoreConnect APIの情報（ASC_KEY_ID, ASC_ISSUER_ID, ASC_KEY_CONTENT）を含む設定値を設定します。

MATCH_PASSWORD は証明書に設定するPasswordになりますので、各自任意で設定してもらって大丈夫です。

FASTLANE_USER はAppleIdになります。

また .env は Github で管理しませんが、.env.skel は管理したいため、以下の内容を .gitignore ファイルに追記します。

.env*
!.env.skel

Fastfileの修正

fastlaneフォルダにある、Fastfileにfastlaneで実行したいlaneを記述します。

今回のFastfileでは、以下のことが実行できるようになっています。

できること	実行コマンド
Development証明書・プロビジョニングファイルの作成・更新	make match_force_development
Development証明書・プロビジョニングファイルの取得	make fetch_development_profiles
Development証明書・プロビジョニングファイルの削除	make delete_development_profiles
Distribution証明書・プロビジョニングファイルの作成・更新	make match_force_appstore
Distribution証明書・プロビジョニングファイルの取得	make fetch_appstore_profiles
Distribution証明書・プロビジョニングファイルの削除	make delete_appstore_profiles

以下をFastfileへコピペします。初期化後の既存で書かれている内容は削除して問題ありません。

appstore_identifier（本番環境用AppID）
dev_identifier（検証環境用AppID）

の2項目については、各自プロジェクトに合わせてください。

# This file contains the fastlane.tools configuration
# You can find the documentation at https://docs.fastlane.tools
#
# For a list of all available actions, check out
#
#     https://docs.fastlane.tools/actions
#
# For a list of all available plugins, check out
#
#     https://docs.fastlane.tools/plugins/available-plugins
#

# Uncomment the line if you want fastlane to automatically update itself
# update_fastlane

default_platform(:ios)

platform :ios do
  def asc_api_key
    app_store_connect_api_key(
      key_id: ENV['ASC_KEY_ID'],
      issuer_id: ENV['ASC_ISSUER_ID'],
      key_content: ENV['ASC_KEY_CONTENT'],
      is_key_content_base64: true
    )
  end

  def appstore_identifier
    "your.appstore.identifier"
  end

  def dev_identifier
    "your.development.identifier"
  end

  def dev_identifiers
    [appstore_identifier, dev_identifier]
  end

  def appstore_identifiers
    [appstore_identifier]
  end

  desc "create development cert and profiles"
  lane :match_force_development do
    api_key = asc_api_key
    match(
      api_key: api_key,
      type: "development",
      app_identifier: dev_identifiers,
      force: true
    )
  end

  desc "create appstore cert and profiles"
  lane :match_force_appstore do
    api_key = asc_api_key
    match(
      api_key: api_key,
      type: "appstore",
      app_identifier: appstore_identifiers,
      force: true
    )
  end

  desc "fetch development profiles and cert"
  lane :fetch_development_profiles do
    api_key = asc_api_key
    match(
      api_key: api_key,
      type: "development",
      app_identifier: dev_identifiers,
      readonly: true
    )
  end

  desc "fetch appstore profiles and cert"
  lane :fetch_appstore_profiles do
    api_key = asc_api_key
    match(
      api_key: api_key,
      type: "appstore",
      app_identifier: appstore_identifiers,
      readonly: true
    )
  end

  desc "delete development profiles and cert"
  lane :delete_development_profiles do
    api_key = asc_api_key
    match_nuke(
      api_key: api_key,
      type: "development",
      app_identifier: dev_identifiers
    )
  end

  desc "delete appstore profiles and cert"
  lane :delete_appstore_profiles do
    api_key = asc_api_key
    match_nuke(
      api_key: api_key,
      type: "appstore",
      app_identifier: appstore_identifiers
    )
  end
end

Makefileの作成

毎回fastlaneコマンドを打つのは面倒。かつ、様々な処理を実行した後にfastlaneを実行したい。という場合を想定して、Makefileを作成します。

MakefileはXcodeプロジェクトファイルと同じ階層に配置します。（Gemfileとかと同じ階層）

基本的には、makeコマンドを実行してもらうこととなります。

FASTLANE := bundle exec fastlane

match_force_development:
    $(FASTLANE) ios match_force_development

match_force_appstore:
    $(FASTLANE) ios match_force_appstore

fetch_development_profiles:
    $(FASTLANE) ios fetch_development_profiles

fetch_appstore_profiles:
    $(FASTLANE) ios fetch_appstore_profiles

delete_development_profiles:
    $(FASTLANE) ios delete_development_profiles

delete_appstore_profiles:
    $(FASTLANE) ios delete_appstore_profiles

おわりに

以上で、iOSプロジェクトでのFastlane組み込みが終わりました。

全てのプロジェクトでFastlaneを導入して、ストレスフリーな開発環境を作りましょう！

のむのむのconsole.log

Fastlaneを使ってiOSの証明書／プロファイルを管理する

前置き