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 にログインし、ダッシュボード。
をクリックします新規プロジェクトボタン。
[選択] ビットライズ CI の設定。
アンダープロジェクトアクセスで、プロジェクトを所有するワークスペースを選択します。
プロジェクトの CI ビルドにアクセスできるユーザーを設定します。

プライバシーは最後

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

次の中から選択できます。
- 接続されている Git プロバイダーアカウント:いずれか経由 OAuth コネクションまたは GitHub アプリによるリポジトリへのアクセス。
- 接続されていない Git プロバイダーアカウント:接続するよう求められます。
- その他: GitHub/GitLab/Bitbucket 以外の Git プロバイダー。
リポジトリを選択します。
- 接続されている Git アカウントを選択した場合は、をクリックできますリポジトリを選択してください。そのアカウントで利用可能なリポジトリから選択します。
- いずれの場合も、URL は手動で入力できます Git リポジトリ (クローン) URL。SSH URL を設定する場合を除き、SSH URL を使用することを強くお勧めしますパブリックプロジェクト。
リポジトリ URL

次のことができるようになりますプロジェクトのリポジトリー URL を変更します。後で。また、アカウントを Git プロバイダーサービスにいつでも接続または切断できます
OAuth接続を使用する場合は、 SSHキーを追加するの中に Bitriseを承認するセクション。

SSHキーを追加するの中に Bitrise を承認するセクション。これはプライベートアプリにのみ関係します。パブリックアプリは SSH キーを持つことができず、認証を必要としません。次の 3 つのオプションから 1 つを選択します。
- あなたのアプリは公開アプリです。
- Git リポジトリには、を使用して接続します。 GitHub アプリケーションのインストール。
- 生成された 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 Test for iOS Stepは、事前定義されたXcodeテストを実行します。変更する必要のないデフォルト構成があります。テストが正しく記述されていれば、機能します。 Xcodeにも同じ構成オプションがあります。

[Stacks & Machines] タブで選択したスタックを確認する

アプリ用に選択したスタックが、アプリのビルドに使用したものと同じXcodeバージョンであることを確認することをお勧めします。たとえば、シミュレータテストが次の場合に失敗した場合スキームの対象外の目的地メッセージが表示されたら、Xcodeのバージョンがスタックとマシンタブは正しいです。あなたは私たちのスタックについてもっと読むことができます：スタックを構築する。

Bitrise.ioにデプロイするステップでは、以下をにデプロイします。ログとアーティファクトビルドのタブ：

Xcodeテストの結果。
生のxcodebuildoutputログ。

ザ・Bitrise.io にデプロイしてくださいStep では、以下の結果もエクスポートされます。iOS 用の Xcode テストステップ 2 へテストレポート。

Xcode プロジェクト用の署名付き IPA の作成

概要

Apple接続が正しく設定されていて、コード署名ファイルをビルドで利用できるようにしておけば、BitriseでXcodeプロジェクト用の署名付きIPAファイルを簡単に作成できます。

ビットライズでの iOS コードサイニングの概要

コードサイニングのアセット管理に使用できるステップの概要については、次のサイトをご覧ください。 iOS コード署名ページ。

Bitriseを使えば、Xcodeプロジェクト用の署名付きIPAファイルを簡単に作成することができます。

設定が完了しました Apple サービス接続ビットライズで。
きみのコード署名ファイルは正しく管理されている。。
当社の関連インプットを設定します iOS 用 Xcode アーカイブとエクスポート ステップ。

配布物と開発署名証明書をアップロードする

プロジェクトの開発署名証明書と配布署名証明書の両方をアップロードすることを強くお勧めします。開発署名証明書をアップロードしていない場合、自動プロビジョニングオプション付きの Steps では、ビルドを開始するたびにその場で証明書が生成されます。その結果、最終的に証明書の数が最大数に達し、新しいビルドを開始できなくなる可能性があります。

設定がすべて完了したら、お使いのIPAエクスポートの設定に進んでください ワークフロー。

[en] Workflow Editor

[en] bitrise.yml

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

オプションは以下のとおりです。
- app-store: アプリを App Store にデプロイする場合はこれを選択してください。配布証明書と App Store プロビジョニングプロファイルが必要です。
- ad-hoc: アプリをアドホックテスターにデプロイしたい場合はこれを選択してください。配布証明書とアドホックプロビジョニングプロファイルが必要です
- enterprise: Apple Enterprise アカウントを持っていて、そのアカウントを使ってアプリを配布したい場合はこれを選択してください。
- development: 内部テストにはこれを選択してください。開発者証明書と開発プロビジョニングプロファイルが必要です。
を設定 自動コード署名 コード署名に使用したい Apple サービス接続に入力します。選択できるオプションは以下のとおりです。
- off 自動コード署名を使用しない場合。
- api-key API キー認証を使用する場合。
- apple-id Apple ID 認証を使用する場合。
ワークフローを保存し、新しいビルドを開始します。

すべてを確認してください必要なコード署名ファイルビルドで使用できます。
[en] Open the bitrise.yml file of your app.
[en] Make sure you have the xcode-archive Step in your Workflow.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
```
[en] Set the distribution_method input to the correct value. The available options are:
- [en] 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.
- [en] 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.
- [en] enterprise: Choose this if you have an Apple Enterprise account and want to use that to distribute your app.
- [en] development: Choose this for internal testing. Requires a Developer certificate and a Development provisioning profile.
```
my-workflow:
  steps:
  - xcode-archive:
      inputs:
      - distribution_method: development
```
[en] Set the automatic_code_signing input to the Apple service connection you want to use for code signing. The available options are:
- [en] off if you don’t do automatic code signing.
- [en] api-key if you use API key authorization.
- [en] 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の配布に使用する場合。
Apple IDを自動コード署名に使用していて、そのApple IDが複数のチームに属している場合は、このエクスポート入力に使用するデベロッパーポータルチームを使用して、自動コード署名アセット管理に使用するチームを指定します。

そのためには:

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

アプリストアコネクトへのアプリのデプロイ

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

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

アプリを App Store Connect にデプロイするには、配布タイプの証明書と App Store タイプのプロビジョニングプロファイルが必要です。
確認してください 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スタックステップワークフロー