- Bitriseドキュメントへようこそ!
- 入門
- iOSアプリ入門
iOSアプリ入門
メールまたはGitプロバイダーを介してサインアップし、リポジトリに接続して、iOSアプリの最初のビルドを実行することにより、Bitriseの使用を開始します。
iOS向けの開発は必ずしも簡単ではありません。私たちの目的は、iOSをできるだけシンプルにすることです。このガイドでは、iOSアプリをBitriseに追加する方法、Xcodeテストを実行する方法、コード署名ファイルを管理する方法、およびアプリをにデプロイする方法について説明します。bitrise.ioそしてAppStoreへ。
fastlane を Bitrise に統合する
ローカルで使用するのと同じコマンドを使用して、Bitrise で fastlane レーンを実行できます。 Bitrise の自動化されたステップは、レーンに追加機能を提供し、ビルドを高速化します。詳細については、こちらをご覧ください fastlane を Bitrise に統合する.
BitriseへのiOSアプリの追加
Bitriseアカウントをお持ちですか?
サインアップしていることを確認してください bitrise.io Bitriseアカウントにアクセスできます。アカウントを登録する方法は複数あります。
-
あなたのBitriseに行きます ダッシュボード。
-
クリック + 上部のメニューバーにサインオンして、 WebUIに新しいアプリを追加する、に移動します 新しいアプリを作成する ページ。
または、CLIを使用してアプリを追加することもできます。詳細については、チェックアウトしてください CLIからの新しいアプリの追加。
-
アプリを追加するアカウントを選択します。
-
アプリのプライバシーを次のいずれかに設定します 民間 また 公衆 をクリックします 次。
プライベート アプリとパブリック アプリ
パブリック アプリとプライベート アプリの最も重要な違いは、アプリがパブリックの場合、ビルド URL を知っている全員がビルド ログを表示できることです。 公開アプリ.プライベート アプリを使用すると、誰がアプリにアクセスできるかを完全に制御できます。
-
リポジトリをホストするGitホスティングサービスを選択してから、プロジェクトをホストする独自のリポジトリを見つけて選択します。
-
リポジトリアクセスを設定するように求められたら、をクリックします いいえ、SSHキーを自動追加します。
-
プロジェクトの構成を含むブランチの名前を入力します-
主要
たとえば、-次にクリックします 次。 -
Bitriseがプロジェクトを検証している間待ちます。
構成ファイルを探し、それらに基づいてアプリをセットアップします。 iOSアプリの場合、Xcodeプロジェクトを探しています(
.xcodeproj
)またはXcodeワークスペース(.xcworkspace
) 道。プロジェクトにSHAREDスキームがない場合、検証は失敗することに注意してください。 Bitriseを手動でXcodeスキームにポイントすることもできますが、共有されている場合は、自動的に検出されます。 -
IPAエクスポート方法を選択します。これは後で変更できます-今のところ、発達。
クリックすると、次のように表示されます。
-
プロジェクトまたはワークスペースのパス。
-
スキーム名
-
IPAエクスポート方法。
-
iOSスタック。
-
-
プロンプトが表示されたらWebhookを登録して、コードがリポジトリにプッシュされたとき、またはプルリクエストが作成されたときにBitriseがビルドを自動的に開始できるようにします。これにより、最初のビルドも開始されます。メッセージをクリックすると、ビルドページに移動します。
iOSアプリのテスト
アプリを作成すると、最初のビルドは自動的に作成されたプライマリワークフローに基づいて実行されます。アプリのワークフローエディターで確認できます。ダッシュボードでアプリの名前をクリックしてから、[ワークフロー]タブをクリックします。
テストターゲットを定義している場合、iOSアプリの主要なワークフローには、Xcodeテストを実行してその結果を表示するために必要な2つのステップが含まれます。bitrise.io:
-
iOS用Xcodeテスト
-
Bitrise.ioにデプロイします
コード署名ファイル
Xcodeテストを実行し、その結果をBitriseにデプロイするために、コード署名ファイルは必要ありません。だから、まだそれらについて心配しないでください!
Xcode Test for iOS Stepは、事前定義されたXcodeテストを実行します。変更する必要のないデフォルト構成があります。テストが正しく記述されていれば、機能します。 Xcodeにも同じ構成オプションがあります。
[Stacks & Machines] タブで選択したスタックを確認する
アプリ用に選択したスタックが、アプリのビルドに使用したものと同じXcodeバージョンであることを確認することをお勧めします。たとえば、シミュレータテストが次の場合に失敗した場合 スキームの対象外の目的地 メッセージが表示されたら、Xcodeのバージョンが スタックとマシン タブは正しいです。あなたは私たちのスタックについてもっと読むことができます: スタックを構築する。
Bitrise.ioにデプロイするステップでは、以下をにデプロイします。ログとアーティファクトビルドのタブ:
-
Xcodeテストの結果。
-
生のxcodebuildoutputログ。
NSBitrise.ioにデプロイしますステップはまた、結果をエクスポートしますiOS用Xcodeテストにステップテストレポートアドオン。
Xcodeプロジェクト用に署名されたIPAを作成する
Apple接続が正しく設定されていて、コード署名ファイルをビルドで使用できるようにすると、Bitriseを使用してXcodeプロジェクトの署名付きIPAファイルを簡単に作成できます。
Bitrise での iOS コード署名の概要
コード署名資産管理に利用できるステップの包括的な概要については、次のWebサイトをご覧ください。 iOSコード署名ページ。
Bitriseを使用すると、Xcodeプロジェクト用の署名付きIPAファイルを簡単に作成できます。あなたがする必要があるのはあなたのコード署名ファイルが正しく管理されていることを確認し、そして私たちの関連する入力を設定することです iOS用のXcodeアーカイブとエクスポート ステップ。
-
設定しました Appleサービス接続 Bitriseで。
-
あなたの コード署名ファイルは正しく管理されています。
-
あなたは私たちの関連する入力を設定します iOS用のXcodeアーカイブとエクスポート ステップ。
ディストリビューションと開発署名証明書をアップロードします
プロジェクトの開発署名証明書と配布署名証明書の両方をアップロードすることを強くお勧めします。アップロードされた開発署名証明書がない場合は、ビルドを開始するたびに、自動プロビジョニング オプションを使用するステップによってオンザフライで生成されます。これにより、最終的に証明書の最大数に達し、新しいビルドを開始できなくなる可能性があります。
すべての設定が完了したら、IPAエクスポートの設定に進みます。 ワークフロー。
-
必要なことを確認してください コード署名ファイルが収集され、アップロードされました。codesigndocを使用したコード署名ファイルの収集とエクスポート
-
あなたが持っていることを確認してください iOS用のXcodeアーカイブとエクスポート ワークフローにステップインします。
-
をセットする 配布方法 ステップの入力。
自動プロビジョニングを使用する場合は、の値と一致していることを確認してください 配布タイプ 関連する入力 iOS自動プロビジョニング ステップ。オプションは次のとおりです。
-
auto-detect
-このオプションは非推奨であり、削除されることに注意してください。使用はお勧めしません。 -
app-store
:アプリをApp Storeにデプロイする場合は、これを選択します。配布証明書とAppStoreプロビジョニングプロファイルが必要です。 -
ad-hoc
:アプリをアドホックテスターにデプロイする場合は、これを選択します。配布証明書とアドホックプロビジョニングプロファイルが必要です。 -
enterprise
:Apple Enterpriseアカウントをお持ちで、それを使用してアプリを配布する場合は、これを選択してください。 -
development
:内部テストにはこれを選択してください。開発者証明書と開発プロビジョニングプロファイルが必要です。
-
-
をセットする 自動コード署名 コード署名に使用するAppleサービス接続への入力。使用可能なオプションは次のとおりです。
-
off
自動コード署名を行わない場合。 -
api-key
APIキー認証を使用する場合。 -
apple-id
AppleID認証を使用する場合。
-
-
ワークフローを保存して、新しいビルドを開始します。
それで全部です。 Xcodeは、プロジェクトのバンドルIDとチームIDの設定、および設定したエクスポート方法に基づいて、適切な署名ファイルを自動的に選択します。
別のチームのコード署名ファイルを使用してIPAファイルに署名する
別のチームのコード署名ファイルを使用してIPAファイルに署名する場合(たとえば、社内ビルドに会社のコード署名を使用しているが、App Store配布にクライアントのコード署名ファイルを使用している場合)、設定するだけです。 NS このエクスポートに使用する開発者ポータルチーム オプションも(に加えて 配布方法)。
-
会社のコード署名ファイルを内部ビルドに使用しているが、クライアントのコード署名ファイルがAppStoreの配布に使用されている場合。
-
自動コード署名にAppleIDを使用し、Apple IDが複数のチームに属している場合は、開発者ポータルチームを使用してこのエクスポート入力に使用し、自動コード署名資産管理に使用するチームを指定します。
そうするには:
-
新しい開発チームの正しいコード署名ファイルがBitriseにアップロードされていることを確認してください。
-
このエクスポートオプションにも使用するように開発者ポータルチームを設定します( 配布方法)。
-
をセットする 配布方法。
アプリをiTunesConnectにデプロイする
アプリをiTunesConnectにプッシュするたびに、固有のビルドとバージョン番号が必要であることに注意してください。 いずれかまたは両方をインクリメント 展開する前に。
-
あなたが働いていることを確認してください AppleDeveloperアカウントへの接続。
-
自分のマシンで少なくとも1回はIPAファイルを生成します。
-
必要なすべてのコード署名ファイルをアップロードする Bitriseに。
アプリをiTunesConnectにデプロイするには、配布タイプの証明書とAppStoreタイプのプロビジョニングプロファイルが必要です。
-
確認してください iOS用のXcodeアーカイブとエクスポート ステップはワークフローにあります。
-
をセットする 自動コード署名 コード署名に使用するAppleサービス接続への入力。使用可能なオプションは次のとおりです。
-
をセットする エクスポート方法を選択してください ステップの入力
app-store
。このステップでは、エクスポートされた.ipaファイルのパスが$ BITRISE_IPA_PATH環境変数に保存されます。
-
追加します
Deploy to iTunes Connect
ワークフローに進みます。 -
必要な入力を入力します。
-
アプリのAppleIDまたはバンドルIDのいずれかが必須の入力です。 2つのうちの1つを提供する必要があります。
-
あなたが設定した場合 レビューのために送信 に
true
、ステップは、送信がiTunes Connectで処理されるのを待ってから、指定されたバージョンのアプリをレビューのために送信します。 -
のデフォルト値 アプリバージョンの更新をスキップ 入力は
No
。別の方法でアプリのバージョン番号をインクリメントした場合にのみ変更してください。 -
複数のチームにリンクされているiTunesConnectアカウントを使用する場合は、チームIDまたはチーム名のいずれかを入力してください。
-
-
ビルドを開始します。
すべてがうまくいけば、アプリはiTunes Connectに送信され、TestflightまたはAppStoreから配布できます。