iOS アプリケーションのデプロイ
ここでは、CircleCI 上で iOS アプリを配信サービスに自動的にデプロイするための fastlane の設定方法について説明します。
概要
fastlane を使用して、iOS アプリを様々なサービスに自動的にデプロイすることができます。 これにより、iOS アプリのベータ版またはリリース版を対象ユーザーに配信する際の手動作業が不要になります。
デプロイレーンをテストレーンと組み合わせることで、ビルドとテストが成功したアプリが自動的にデプロイされます。
注: 下記のデプロイ例を使用するには、プロジェクトにコード署名が設定されている必要があります。 コード署名の設定方法については、 コード署名の設定をご覧ください。
ベストプラクティス
Git ブランチの使用
リリースレーンは、Git リポジトリの特定のブランチ (専用のリリース/ベータブランチなど) でのみ実行することをお勧めします。 そうすることで、指定したブランチへのマージが成功した場合のみリリースが可能となり、開発段階においてプッシュがコミットされるたびにリリースされるのを防ぐことができます。 また、iOS アプリのバイナリのサイズによっては外部サービスへのアップロードに時間がかかる場合があるため、ジョブ完了までの時間を短縮することができます。 これを実行するためのワークフローの設定方法については、 ブランチレベルでのジョブの実行をご覧ください。
ビルド番号の設定
デプロイサービスにアップロードする際は、iOS アプリのバイナリのビルド番号にご注意ください。 一般的には、 .xcproject
で設定されていますが、一意になるように手動で更新する必要があります。 各デプロイレーンの実行前にビルド番号が更新されていないと、受信サービスがビルド番号の競合によりバイナリを拒否する場合があります。
fastlane により、レーン実行中にビルド番号を変更できる increment_build_number
アクション が可能です。 たとえば、ビルド番号を特定の CircleCI ジョブに関連付けたい場合には、 環境変数 $CIRCLE_BUILD_NUM
の使用を検討してください。
increment_build_number(
build_number: "$CIRCLE_BUILD_NUM"
)
App Store Connect
設定
fastlane が iOS バイナリを App Store Connect や TestFlight に自動的にアップロードするように設定するには、fastlane が App Store Connect アカウントにアクセスできるよういくつかのステップを実施する必要があります。
この設定には、App Store Connect API キーを生成して使用することをお勧めします。 それにより、Apple ID で必須となっている 2FA で問題が発生することを防ぎ、最も確実な方法でサービスを利用することができます。
API キーを作成するには、 Apple 開発者向けドキュメントで説明されている手順に従ってください。 その結果 .p8
を取得したら、 App Store Connect API キーのページに表示される発行者 ID とキー ID をメモします。
注: .p8
ファイルをダウンロードし、安全な場所に保存したことを確認してください。 App Store Connect のポータルから離れてしまうと、ファイルを再度ダウンロードすることはできません。
次に、いくつかの環境変数を設定する必要があります。 CircleCI プロジェクトで、 ビルド設定 > 環境変数 に移動し、以下を設定します。
- 発行者 ID に、
APP_STORE_CONNECT_API_KEY_ISSUER_ID
- (例:
6053b7fe-68a8-4acb-89be-165aa6465141
)
- (例:
- キー ID に、
APP_STORE_CONNECT_API_KEY_KEY_ID
- (例:
D383SF739
)
- (例:
.p8
ファイルの内容に、APP_STORE_CONNECT_API_KEY_KEY
- (例:
-----BEGIN PRIVATE KEY-----\nMIGTAgEAMGByqGSM49AgCCqGSM49AwEHBHknlhdlYdLu\n-----END PRIVATE KEY-----
)
- (例:
注: .p8
ファイルの内容を確認するには、テキストエディターで開きます。 各行を \n
に置き換えて、1つの長い文字列にする必要があります。
最後に、fastlane ではどの Apple ID を使用するか、またどのアプリケーションをターゲットにするかを知るために、いくつかの情報が要求されます。 Apple ID とアプリケーションのバンドル ID は、fastlane/Appfile
で次のように設定できます。
# fastlane/Appfile
apple_id "ci@yourcompany.com"
app_identifier "com.example.HelloWorld"
App Store Connect と Apple Developer Portal に別々の認証情報を使う必要がある場合は、 Fastlane Appfile に関するドキュメントで詳細をご確認ください。
この設定が完了すると、App Store Connect と連動するアクション (pilot
や deliver
など) を呼び出す前に、レーン内で app_store_connect_api_key
を呼び出すだけでよくなります。
App Store へのデプロイ
下記の例は、バイナリをビルドして署名し、App Store Connect にアップロードする基本的なレーンです。 fastlane が提供する deliver
アクションは、App Store への申請プロセスを自動化する強力なツールです。
また、メタデータやスクリーンショット ( snapshot
や frameit アクションで生成可能) を自動的にアップロードするなど、さまざまなオプションが可能です。 設定の詳細については、fastlane の deliver
に関するドキュメントを参照してください。
# fastlane/Fastfile
default_platform :ios
platform :ios do
before_all do
setup_circle_ci
end
desc "Upload Release to App Store"
lane :upload_release do
# プロジェクトからバージョン番号を取得します。
# App Store Connect で既に使用可能な最新のビルドと照合します。
# ビルド番号を1増やします。 使用可能なビルドがない場合は、
# 1 から始めます。
increment_build_number(
build_number: app_store_build_number(
initial_build_number: 1,
version: get_version_number(xcodeproj: "HelloCircle.xcodeproj"),
live: false
) + 1,
)
# 配信コード署名を設定し、アプリをビルドします。
match(type: "appstore")
gym(scheme: "HelloCircle")
#App Store Connect にバイナリをアップロードします。
deliver(
submit_for_review: false,
force: true
)
end
end
TestFlight へのデプロイ
TestFlight は、App Store Connect と連動した Apple のベータ版配信サービスです。 fastlane は、TestFlight の配信管理が簡単に行える pilot
アクションを提供しています。
下記の例では、 iOS バイナリを自動的にビルド、署名、アップロードするように fastlane を設定する方法を紹介しています。 Pilot には TestFlight にアプリを配信するためのカスタムオプションが豊富にあります。 pilot
のドキュメントで詳細を確認することを強くお勧めします。 。
# fastlane/Fastfile
default_platform :ios
platform :ios do
before_all do
setup_circle_ci
end
desc "Upload to Testflight"
lane :upload_testflight do
# プロジェクトからバージョン番号を取得します。
# TestFlight で既に利用可能な最新のビルドと照合します。
# ビルド番号を 1 増やします。 使用可能なビルドがない場合は、
# 1 から始めます。
increment_build_number(
build_number: latest_testflight_build_number(
initial_build_number: 1,
version: get_version_number(xcodeproj: "HelloWorld.xcodeproj")
) + 1,
)
# 配信コード署名を設定し、アプリをビルドします。
match(type: "appstore")
gym(scheme: "HelloWorld")
# TestFlight にバイナリをアップロードし、
# 設定したベータ版のテストグループに自動的にパブリッシュします。
pilot(
distribute_external: true,
notify_external_testers: true,
groups: ["HelloWorld Beta Testers"],
changelog: "This is another new build from CircleCI!"
)
end
end
Firebase へのデプロイ
Firebaseは、Google が提供する配信サービスです。 Firebase へのデプロイは、 Firebase アプリ配信プラグインをインストールすることで簡単に行うことができます。
fastlane プラグインの設定
プロジェクトにプラグインを設定するには、ローカルマシンのターミナルでプロジェクトディレクトリを開き、以下のコマンドを実行します。
fastlane add_plugin firebase_app_distribution
するとプラグインがインストールされ、必要な情報が fastlane/Pluginfile
と Gemfile
に追加されます。
注: bundle install
ステップにより、ジョブの実行中にこのプラグインをインストールできるよう両方のファイルを Git リポジトリに組み込んでおくことが重要です。
CLI トークンの生成
Firebase では、認証時にトークンを使用する必要があります。 トークンの生成には、Firebase CLI とブラウザを使用します。CircleCIはヘッドレス環境であるため、ランタイムではなくローカルでトークンを生成し、環境変数として CircleCI に追加する必要があります。
- コマンド
curl -sL https://firebase.tools | bash
で、Firebase CLI をダウンロードし、ローカルにインストールします。 firebase login:ci
というコマンドでログインをトリガーします。- ブラウザウィンドウでサインインを完了し、ターミナルの出力で提供されたトークンをコピーします。
- CircleCI のプロジェクト設定で、
FIREBASE_TOKEN
という名前の新しい環境変数を作成し、トークンの値を入力します。
fastlane の設定
Firebase プラグインは、最小限の設定で iOS のバイナリを Firebase にアップロードすることができます。 主なパラメータは app
で、Firebase が設定した App ID が必要になります。 これを確認するには、 Firebase のコンソールでプロジェクトにアクセスし、 Project Settings > General を選択します。 [Your apps ] の下に、プロジェクト内のアプリのリストと、App ID (通常、1:123456789012:ios:abcd1234abcd1234567890
の形式) などの情報が表示されます。
その他の設定オプションについては、 Firebase Fastlane プラグインのドキュメントを参照してください。
# Fastlane/fastfile
default_platform :ios
platform :ios do
before_all do
setup_circle_ci
end
desc "Upload to Firebase"
lane :upload_firebase do
increment_build_number(
build_number: "$CIRCLE_BUILD_NUM"
)
match(type: "adhoc")
gym(scheme: "HelloWorld")
firebase_app_distribution(
app: "1:123456789012:ios:abcd1234abcd1234567890",
release_notes: "This is a test release!"
)
end
end
Firebase Fastlane のプラグインを使用するには、 curl -sL https://firebase.tools | bash
コマンドにより Firebase CLI をジョブの一部としてインストールする必要があります。
version: 2.1
jobs:
adhoc:
macos:
xcode: "12.5.1"
environment:
FL_OUTPUT_DIR: output
steps:
- checkout
- run: echo 'chruby ruby-2.6' >> ~/.bash_profile
- run: bundle install
- run: curl -sL https://firebase.tools | bash
- run: bundle exec fastlane upload_firebase
workflows:
adhoc-build:
jobs:
- adhoc
注: Firebase プラグインは、macOS システムの Ruby で実行するとエラーが発生することがあります。 そのため、 別の Ruby バージョンに切り替えることをお勧めします。
Visual Studio App Center へのデプロイ
Visual Studio App Center (以前は HockeyApp) は、Microsoft の配信サービスです。 App Center のプラグインをインストールすると、App Center と Fastlane の統合が可能になります。
Fastlane プラグインの設定
プロジェクトにプラグインを設定するには、ローカルマシンのターミナルでプロジェクトディレクトリを開き、以下のコマンドを実行します。
fastlane add_plugin appcenter
するとプラグインがインストールされ、必要な情報が fastlane/Pluginfile
と Gemfile
に追加されます。
注: bundle install
ステップにより、ジョブの実行中にこのプラグインをインストールできるよう両方のファイルを Git レポジトリに組み込んでおくことが重要です。
App Center の設定
まず、VS App Center でアプリを作成する必要があります。
- Visual Studio App Center にログイン、または登録します。
- ページの右上にある [Add New (追加)] “をクリックし、[Add New App (新しいアプリを追加する)] を選択します。
- 必要に応じて、必要な情報を入力します。
完了したら、Fastlane が App Center にアップロードできるようにするための API トークンを生成する必要があります。
- 設定の API トークン に移動します。
- [New API Token (新しい API トークン)] “をクリックします。
- トークンの説明を入力し、アクセスを [Full Access (フルアクセス)] に設定します。
- トークンが生成されたら、必ず安全な場所にコピーしてください。
- CircleCI のプロジェクト設定で、
VS_API_TOKEN
という名前の新しい環境変数を作成し、トークンの値を入力します。
fastlane の設定
下記は、ベータ版アプリのビルドを Visual Studio App Center に配信するレーンの例です。 App Center にバイナリをアップロードするには、App Center アカウントのユーザー名と「フルアクセス」 の API トークンの両方が必要です。
# Fastlane/fastfile
default_platform :ios
platform :ios do
before_all do
setup_circle_ci
end
desc "Upload to VS App Center"
lane :upload_appcenter do
# ここでは ビルド番号に
# CircleCI ジョブ番号を使います。
increment_build_number(
build_number: "$CIRCLE_BUILD_NUM"
)
# Adhoc コード署名を設定し、アプリをビルドします。
match(type: "adhoc")
gym(scheme: "HelloWorld")
# 必要な情報を設定し、
# アプリのバイナリを VS App Center にアップロードします。
appcenter_upload(
api_token: ENV[VS_API_TOKEN],
owner_name: "YOUR_VS_APPCENTER_USERNAME",
owner_type: "user",
app_name: "HelloWorld"
)
end
end
TestFairy へのアップロード
TestFairy は、よく使用されるエンタープライズアプリの配信およびテストサービスです。 Fastlane には TestFairy のサポートが組み込まれており、新しいビルドを迅速かつ簡単にアップロードすることができます。
- TestFairy ダッシュボードで、[Preferences (設定)] ページに移動します。
- [Preferences (設定)] ページの API キーのセクションで API キーをコピーします。
- CircleCI のプロジェクト設定で、
TESTFAIRY_API_KEY
という名前の新しい環境変数を作成し、API キーの値を入力します。
fastlane の設定
fastlane 内で TestFairy へのアップロードを設定するには、次の例を参照してください。
# Fastlane/fastfile
default_platform :ios
platform :ios do
before_all do
setup_circle_ci
end
desc "Upload to TestFairy"
lane :upload_testfairy do
# ここではビルド番号に
# CircleCI ジョブ番号を使います。
increment_build_number(
build_number: "$CIRCLE_BUILD_NUM"
)
# Adhoc コード署名を設定し、アプリをビルドします。
match(type: "adhoc")
gym(scheme: "HelloWorld")
# 必要な情報を設定し、
# アプリのバイナリを VS App Center にアップロードします。
testfairy(
api_key: ENV[TESTFAIRY_API_KEY],
ipa: 'path/to/ipafile.ipa',
comment: ENV[CIRCLE_BUILD_URL]
)
end
end
ドキュメントの改善にご協力ください
このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。 ご協力いただき、ありがとうございます。
- このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
- ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
- CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。 フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。
サポートが必要ですか
CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。 サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。
または、 サポートサイト から、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.