GitLab と fastlane を使用して iOS アプリケーションを App Store に公開する

fastlane を使用した GitLab が iOS アプリケーションを収集、署名し、App Store に公開する方法。

私たちは最近、 Android アプリケーションをすばやく構築して実行する方法についての投稿 GitLab と 追い越し車線。 ここでは、iOS アプリを構築して実行し、TestFlight に公開する方法を見ていきます。 どれだけクールかチェックしてください GitLab Web IDE を使用して iPad Pro に変更を加えています, アセンブリを取得し、開発したのと同じ iPad Pro でアプリケーションのテスト バージョンの更新を取得します。

ここで取り上げます Swift 上のシンプルな iOS アプリ、一緒にビデオを録画しました。

Apple Storeの設定について一言

すべてを結び付けるには、App Store アプリ、配布証明書、プロビジョニング プロファイルが必要です。

ここで最も難しいのは、App Store での署名権限の設定です。 これについてはご自身で理解していただければ幸いです。 初めての方には正しい方向へ案内しますが、Apple 証明書の管理の複雑さについてはここでは説明しません。また、Apple 証明書は常に変化しています。 この投稿は、始めるのに役立ちます。

私のアプリ

App Store Connect にアプリが必要なので、構成用の ID が必要です .xcodebuild。 プロファイルとアプリケーション ID は、コード ビルド、価格と可用性、およびテスト アプリケーションをユーザーに配布するための TestFlight 構成を組み合わせます。 公開テストは行わないでください。小規模なグループがあり、セットアップが簡単で、Apple からの追加の許可が必要ない場合は、プライベート テストで十分です。

初期化プロファイル

アプリのセットアップに加えて、Apple Developer コンソールの [証明書、識別子、プロファイル] セクションで作成された iOS 配布キーと開発キーが必要です。 これらの証明書はすべて、プロビジョニング プロファイルに組み合わせることができます。

認証されるユーザーは証明書を作成できる必要があります。そうでない場合は、次の手順を実行します。 認定してため息 エラーが表示されます。

その他のオプション

この簡単な方法以外にも、証明書とプロファイルを構成する方法があります。 したがって、これまでと異なる働き方をする場合は、適応する必要があるかもしれません。 最も重要なことは、設定が必要であるということです .xcodebuildこれは必要なファイルを指します。キーチェーンは、ランナーを実行している名前のユーザーがビルド コンピューター上で利用できる必要があります。 デジタル署名には fastlane を使用しています。問題がある場合、または詳細を知りたい場合は、詳細を確認してください。 デジタル署名に関するドキュメント.

この例では、次のアプローチを使用しています 認定してため息、しかし実際の使用にはおそらくそれの方が適しています match .

GitLab と fastlane の準備

CIランナーの準備

このデータをすべて収集したら、MacOS デバイス上の GitLab ランナーの構成に進みます。 残念ながら、iOS アプリは MacOS 上でしか作成できません。 しかし、すべてが変わる可能性があるため、この分野での進歩を期待する場合は、次のようなプロジェクトに注目してください。 xcbuild и サインする、および内部タスク gitlab-ce#57576.

ランナーのセットアップは非常に簡単です。 現在に従ってください macOS で GitLab Runner をセットアップする手順.

注記。 ランナーは実行可能プログラムを使用する必要があります shell。 これは、コンテナ経由ではなくユーザーとして直接動作するように macOS 上に iOS を構築するために必要です。 使用している場合 shell、ビルドとテストはランナー ユーザーとしてビルド ホスト上で直接実行されます。 コンテナほど安全ではないため、閲覧した方がよいでしょう 安全に関する文書だからあなたは何も見逃しません。

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
cd ~
gitlab-runner install
gitlab-runner start

Apple キーチェーンは、Xcode が構築する必要があるキーにアクセスできるようにこのホスト上で設定する必要があります。 これをテストする最も簡単な方法は、ビルドを実行するユーザーとしてログインし、手動でビルドしてみることです。 システムがキーチェーン アクセスを要求する場合は、CI の動作を常に許可するを選択します。 最初のいくつかのパイプラインを観察して、キーチェーンを要求しなくなっていることを確認することは価値があるかもしれません。 問題は、Apple が自動モードの使用を簡単にしてくれないことですが、一度使い始めてしまえば、すべてうまくいきます。

ファストレーンの初期化

プロジェクトで fastlane を使用するには、次のコマンドを実行します。 fastlane init。 ただフォローしてください fastlane のインストールと実行の手順、特に、に関するセクションでは、 Gemfile自動化された CI パイプラインを通じて、迅速かつ予測可能な起動が必要なためです。

プロジェクト ディレクトリで、次のコマンドを実行します。

xcode-select --install
sudo gem install fastlane -NV
# Alternatively using Homebrew
# brew cask install fastlane
fastlane init

fastlane は基本構成を要求し、プロジェクト内に次の XNUMX つのファイルを含む fastlane フォルダーを作成します。

1. fastlane/Appfile

ここでは複雑なことは何もありません。 Apple ID と App ID が正しいことを確認してください。

app_identifier("com.vontrance.flappybird") # The bundle identifier of your app
apple_id("[email protected]") # Your Apple email address

2. fastlane/Fastfile

Fastfile ビルドステップを定義します。 fastlane の組み込み機能を多く使用しているため、ここでもすべてが明確です。 証明書を受け取り、アセンブリを実行して、TestFlight にアップロードする XNUMX 行を作成します。 必要に応じて、このプロセスをさまざまなタスクに分割できます。 これらすべての操作 (get_certificates, get_provisioning_profile, gym и upload_to_testflight) はすでに fastlane に含まれています。

活動 get_certificates и get_provisioning_profile 署名アプローチに関連する 認定してため息. 使用している場合 match または何でも、変更を加えます。

default_platform(:ios)

platform :ios do
  desc "Build the application"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

これはオプションのファイルですが、デフォルトの出力ディレクトリを変更し、出力を現在のフォルダーに配置するために手動で作成しました。 これにより CI が簡素化されます。 興味があれば読んでください gym とそのパラメータ ドキュメンテーション.

https://docs.fastlane.tools/actions/gym/

私たちの .gitlab-ci.yml

これで、プロジェクトの CI ランナーが完成し、パイプラインをテストする準備が整いました。 何が入っているか見てみましょう .gitlab-ci.yml:

stages:
  - build

variables:
  LC_ALL: "en_US.UTF-8"
  LANG: "en_US.UTF-8"
  GIT_STRATEGY: clone

build:
  stage: build
  script:
    - bundle install
    - bundle exec fastlane flappybuild
  artifacts:
    paths:
    - ./FlappyBird.ipa

Всеотлично！ 必要に応じて、fastlane の形式を UTF-8 に設定します。、戦略を使用する clone 実行中のプログラムで shellこれにより、各アセンブリにクリーンなワークスペースが確保され、単純に呼び出すことができます。 flappybuild 上で見たように、ファストレーン。 その結果、TestFlight で最新のアセンブリのアセンブリ、署名、展開を取得します。

また、アーティファクトを取得し、アセンブリとともに保存します。 形式に注意してください .ipa 署名された ARM 実行可能ファイルであり、シミュレータでは実行されません。 シミュレーターの出力が必要な場合は、それを生成するビルド ターゲットを追加し、アーティファクト パスに含めます。

その他の環境変数

ここには、すべてを機能させるための環境変数がいくつかあります。

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

App Storeで認証してTestFlightにアップロードするには、fastlaneの認証が必要です。 これを行うには、CI で使用されるアプリケーションのパスワードを作成します。 詳細 ここで.

XNUMX 要素認証を使用している場合は、変数を作成します FASTLANE_SESSION （そこに指示があります）。

FASTLANE_USER и FASTLANE_PASSWORD

その 認定してため息 要求に応じて初期化プロファイルと証明書と呼ばれる変数を設定する必要があります FASTLANE_USER и FASTLANE_PASSWORD。 詳細 ここで。 別の署名方法を使用している場合、これは必要ありません。

結論

すべてがどのように機能するかを見ることができます 私の簡単な例では.

これが役に立ち、GitLab プロジェクトで iOS ビルドを扱うきっかけになったことを願っています。 ここにもう一つあります CI のヒント ファストレーン用、念のため。 使いたいかもしれません CI_BUILD_ID (増分ビルドの場合) 自動的にバージョンをインクリメントします.

fastlane のもう XNUMX つの優れた機能は、 自動スクリーンショット App Store の場合、セットアップは非常に簡単です。

コメントであなたの経験について教えて、iOS アプリ開発のための GitLab を改善するためのアイデアを共有してください。

出所： habr.com