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 にログインし、ダッシュボード。
クリック新しいアプリを追加ボタン。
下プロジェクトへのアクセス、アプリを所有するワークスペースを選択します。
アプリのプライバシーを設定します。

注意

この設定は後で変更することはできません。アプリをプライベートにする必要があるにもかかわらず、誤ってパブリックアプリとして追加したことに気付いた場合は、アプリを削除して再度追加する必要があります。
- プライベートアプリには、あなた、ワークスペースメンバー、およびアプリでの作業に招待されたユーザーのみがアクセスできます。アプリのリポジトリにアクセスするには認証が必要です。
- 公開アプリ彼らのことを暴露するビットライズ.yml そしてビルドログを全員に送信します。公開アプリのビルド URL がある場合は、そのビルドログを表示して、トラブルシューティングなどに役立てることができます。パブリックアプリは認証を必要とせず、SSH キーを持つことはできません。
リポジトリ URL を設定するには、2 つのオプションのいずれかを選択します。
- とともにリモートリポジトリの選択オプションを使用すると、接続されている Git プロバイダーアカウントのリポジトリのリストからリポジトリを選択できます。ドロップダウンメニューから Git プロバイダーを選択し、クリックします。リポジトリを選択してください... リストからリポジトリを選択します。
- の URLを手動で入力してくださいこのオプションでは、接続された Git プロバイダーアカウントは必要ありません。URL を入力するだけで、認証フェーズに進むことができます。を設定している場合を除き、SSH URL を使用することを強くお勧めします。パブリックアプリ。
リポジトリURL

あなたはできるでしょうプロジェクトのリポジトリ URL を変更する後で。また、いつでもアカウントを Git プロバイダーサービスに接続または切断することができます。

Git プロバイダーアカウントを使用して Bitrise にサインアップした場合、そのアカウントはすでに接続されており、そこから任意のリポジトリを選択できます。
SSHキーを追加するの中に Bitrise を承認するセクション。これはプライベートアプリにのみ関係します。パブリックアプリは SSH キーを持つことができず、認証を必要としません。次の 3 つのオプションから 1 つを選択します。
- 生成された SSH キーをリポジトリに自動追加します: このオプションを使用することをお勧めします。 SSH キーペアが自動的に生成され、公開キーがリポジトリに登録されます。接続された Git プロバイダーアカウントにリポジトリに対する管理者権限が必要です。
- 生成された SSH キーを Git プロバイダーに手動でコピーします: SSH キーペアが生成されるので、公開キーをコピーして Git プロバイダーに手動で登録できます。たとえば、同じ SSH キーを使用して複数のリポジトリにアクセスする必要がある場合に便利です。
- 独自の SSH キーを Bitrise に追加する: このオプションを選択した後、独自の SSH キーを生成し、ここに秘密キーを貼り付けることができます。公開キーをリポジトリに手動で追加することも必要です。 SSH キーペアを生成するには、次の手順を実行します。独自の SSH キーペアの生成。
SSH キーはいつでも設定できます

現時点で有効な機能する SSH キー接続を設定できない場合でも、心配する必要はありません。アプリの追加に進んでください。後で SSH 接続をセットアップできます。 SSHキーの構成。
リポジトリのデフォルトのブランチを選択します。このブランチにはプロジェクトの構成が含まれている必要があります。
- 前の手順で SSH アクセスを正常に構成した場合、またはパブリックアプリを追加している場合、Bitrise はリポジトリを解析し、ドロップダウンメニューからブランチを選択できるようにします。
- リポジトリアクセスを構成していない場合は、ブランチ名を手動で入力する必要があります。
アプリのデフォルトのブランチは後で変更できます。
Bitriseがアプリを自動的に構成しようとしている間待ちます。

プロジェクトの種類

プロジェクトタイプの検出は、アプリの初期構成を支援するのに役立ちます。ただし、アプリを追加した後はいつでも、プロジェクトタイプを含むすべての設定を変更できますのでご安心ください。
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エクスポートの設定に進みます。 ワークフロー。

Workflow Editor

bitrise.yml

必要なことを確認してくださいコード署名ファイルが収集され、アップロードされました。
あなたが持っていることを確認してください iOS用のXcodeアーカイブとエクスポート ワークフローにステップインします。
をセットする 配布方法 ステップの入力。

自動プロビジョニングを使用する場合は、の値と一致していることを確認してください 配布タイプ 関連する入力 iOS自動プロビジョニング ステップ。オプションは次のとおりです。
- auto-detect -このオプションは非推奨であり、削除されることに注意してください。使用はお勧めしません。
- app-store：アプリをApp Storeにデプロイする場合は、これを選択します。配布証明書とAppStoreプロビジョニングプロファイルが必要です。
- ad-hoc：アプリをアドホックテスターにデプロイする場合は、これを選択します。配布証明書とアドホックプロビジョニングプロファイルが必要です。
- enterprise：Apple Enterpriseアカウントをお持ちで、それを使用してアプリを配布する場合は、これを選択してください。
- development：内部テストにはこれを選択してください。開発者証明書と開発プロビジョニングプロファイルが必要です。
をセットする 自動コード署名 コード署名に使用するAppleサービス接続への入力。使用可能なオプションは次のとおりです。
- off 自動コード署名を行わない場合。
- api-key APIキー認証を使用する場合。
- apple-id AppleID認証を使用する場合。
ワークフローを保存して、新しいビルドを開始します。

Make sure all the necessary code signing files are available for your build.
Open the bitrise.yml file of your app.
Make sure you have the xcode-archive Step in your Workflow.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
```
Set the distribution_method input to the correct value. The available options are:
- app-store: Choose this if you want to deploy the app to the App Store. Requires a Distribution certificate and an App Store provisioning profile.
- ad-hoc: Choose this if you want to deploy the app to ad-hoc testers. Requires a Distribution certificate and an Ad Hoc provisioning profile.
- enterprise: Choose this if you have an Apple Enterprise account and want to use that to distribute your app.
- development: Choose this for internal testing. Requires a Developer certificate and a Development provisioning profile.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
      - distribution_method: development
```
Set the automatic_code_signing input to the Apple service connection you want to use for code signing. The available options are:
- off if you don’t do automatic code signing.
- api-key if you use API key authorization.
- apple-id if you use Apple ID authorization.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
      - automatic_code_signing: api-key
      - distribution_method: development
```

それで全部です。 Xcodeは、プロジェクトのバンドルIDとチームIDの設定、および設定したエクスポート方法に基づいて、適切な署名ファイルを自動的に選択します。

別のチームのコード署名ファイルを使用してIPAファイルに署名する

別のチームのコード署名ファイルを使用してIPAファイルに署名する場合（たとえば、社内ビルドに会社のコード署名を使用しているが、App Store配布にクライアントのコード署名ファイルを使用している場合）、設定するだけです。 NS このエクスポートに使用する開発者ポータルチーム オプションも（に加えて 配布方法）。

会社のコード署名ファイルを内部ビルドに使用しているが、クライアントのコード署名ファイルがAppStoreの配布に使用されている場合。
自動コード署名にAppleIDを使用し、Apple IDが複数のチームに属している場合は、開発者ポータルチームを使用してこのエクスポート入力に使用し、自動コード署名資産管理に使用するチームを指定します。

そうするには：

新しい開発チームの正しいコード署名ファイルがBitriseにアップロードされていることを確認してください。
このエクスポートオプションにも使用するように開発者ポータルチームを設定します（ 配布方法）。
をセットする 配布方法。

アプリをiTunesConnectにデプロイする

アプリをiTunesConnectにプッシュするたびに、固有のビルドとバージョン番号が必要であることに注意してください。いずれかまたは両方をインクリメント展開する前に。

あなたが働いていることを確認してください AppleDeveloperアカウントへの接続。
自分のマシンで少なくとも1回はIPAファイルを生成します。
必要なすべてのコード署名ファイルをアップロードする Bitriseに。

アプリをiTunesConnectにデプロイするには、配布タイプの証明書とAppStoreタイプのプロビジョニングプロファイルが必要です。
確認してください iOS用のXcodeアーカイブとエクスポート ステップはワークフローにあります。
をセットする 自動コード署名 コード署名に使用するAppleサービス接続への入力。使用可能なオプションは次のとおりです。
- off 自動コード署名を使用しない場合、またはAppleサービス認証にステップ入力のみを使用する場合。
- api-key 使用する場合 APIキー認証。
- apple-id 使用する場合 AppleID認証。
をセットする エクスポート方法を選択してください ステップの入力 app-store。

このステップでは、エクスポートされた.ipaファイルのパスが$ BITRISE_IPA_PATH環境変数に保存されます。
追加します Deploy to iTunes Connect ワークフローに進みます。
必要な入力を入力します。
- アプリのAppleIDまたはバンドルIDのいずれかが必須の入力です。 2つのうちの1つを提供する必要があります。
- あなたが設定した場合 レビューのために送信 に true、ステップは、送信がiTunes Connectで処理されるのを待ってから、指定されたバージョンのアプリをレビューのために送信します。
- のデフォルト値 アプリバージョンの更新をスキップ 入力は No。別の方法でアプリのバージョン番号をインクリメントした場合にのみ変更してください。
- 複数のチームにリンクされているiTunesConnectアカウントを使用する場合は、チームIDまたはチーム名のいずれかを入力してください。
ビルドを開始します。

すべてがうまくいけば、アプリはiTunes Connectに送信され、TestflightまたはAppStoreから配布できます。

このセクションの内容:

参照:

ビットライズ.ymlステップワークフロー