Skip to main content

最初のアプリを追加する

概要

Bitriseにアプリを追加するということは、ビルドを実行できるようにリポジトリへのアクセスを設定することを意味します。プロジェクトスキャナーはプラットフォームタイプを判別し、アプリをビルドしてデプロイするためのデフォルトのワークフローを生成します。

を追加する アプリ Bitrise へのアクセスとは、ビルドを実行できるようにリポジトリへのアクセスを設定することを意味します。プロセス中に、私たちはまた、 プロジェクトスキャナー アプリのプラットフォーム タイプ (iOS など) を検出し、デフォルトを生成します。 ワークフロー 必要なすべてを備えた 手順 アプリをビルドしてデプロイします。

現在、次のプラットフォーム/フレームワークをすぐにサポートしています。

プロジェクトスキャナー

プラットフォーム/フレームワークをサポートするということは、プロジェクトスキャナーがアプリのタイプを検出し、そのタイプに基づいて基本的なBitrise構成をセットアップできることを意味します。ビルド方法に関係なく、他のアプリも追加できますが、手動で構成する必要があります。

このガイドでは、新しいアプリを Bitrise に追加する方法、リポジトリを Bitrise に接続する方法、SSH キーと初期構成を設定する方法について説明します。 ウェブフックを登録する.

  1. Bitriseにログインします。

  2. クリック 最初のアプリを追加する ボタン。

  3. プロジェクトへのアクセス、アプリを所有するワークスペースを選択します。

    project-access.png
  4. アプリのプライバシーを設定します。

    アプリのプライバシーは変更できません

    この設定を後で変更することはできません。プライベートにする必要があるにもかかわらず、誤ってアプリをパブリックアプリとして追加したことに気付いた場合は、アプリを削除してから再度追加する必要があります。

    • プライベートアプリには、あなた、ワークスペースメンバー、およびアプリでの作業に招待されたユーザーのみがアクセスできます。アプリのリポジトリにアクセスするには認証が必要です。

    • 公開アプリ彼らを暴露するbitrise.yml およびそのビルド ログを全員に送信します。パブリック アプリのビルド URL がある場合は、そのビルド ログを表示して、トラブルシューティングなどに役立てることができます。パブリック アプリは認証を必要とせず、SSH キーを持つことはできません。

  5. Bitrise へのアクセスをソース コード プロバイダーに許可する アプリのリポジトリを選択します。

    • とともに リモートリポジトリの選択 オプションを使用すると、接続されている Git プロバイダー アカウントのリポジトリのリストからリポジトリを選択できます。ドロップダウン メニューから Git プロバイダーを選択し、クリックします。 リポジトリを選択してください... リストからリポジトリを選択します。プライベート アプリに対してこのオプションを選択すると、リポジトリの SSH URL が自動的に使用されます。

      select-repo-open.png
    • URLを手動で入力してください このオプションでは、接続された Git プロバイダー アカウントは必要ありません。URL を入力するだけで認証フェーズに進むことができます。 SSH URL または HTTPS URL のいずれかを使用できます。パブリック アプリの場合は、常に HTTPS URL を使用してください。

    リポジトリの URL

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

    Gitプロバイダーアカウントを使用してBitriseにサインアップした場合、そのアカウントはすでに接続されており、そこから任意のリポジトリを選択できます。

  6. SSH キーを追加する の中に リポジトリ アクセス メニューの設定.これはプライベート アプリにのみ関係します。パブリック アプリは SSH キーを持つことができず、認証を必要としません。

    • SSH URL の場合は、SSH キー ペアを設定する必要があります。

    • HTTPS URL の場合は、Git プロバイダーのサイトで作成されたパーソナル アクセス トークンを追加する必要があります。

    SSHキー認証

    HTTPS認証

    add-ssh-key.png
    • 生成された SSH キーをリポジトリに自動追加します: このオプションを使用することをお勧めします。 SSH キー ペアが自動的に生成され、公開キーがリポジトリに登録されます。接続された Git プロバイダー アカウントにリポジトリに対する管理者権限が必要です。

    • 生成された SSH キーを Git プロバイダーに手動でコピーします: SSH キー ペアが生成されるので、公開キーをコピーして Git プロバイダーに手動で登録できます。たとえば、同じ SSH キーを使用して複数のリポジトリにアクセスする必要がある場合に便利です。

    • 独自の SSH キーを Bitrise に追加する: このオプションを選択した後、独自の SSH キーを生成し、ここに秘密キーを貼り付けることができます。公開キーをリポジトリに手動で追加することも必要です。 SSH キー ペアを生成するには: 独自の SSH キーペアの生成

    https-auth.png

    Fine-grained access

    The Personal Access Token needs to have read access to the repository. We recommend using fine-grained Personal Access Tokens that do not have any additional rights to the repository or your Git provider account.

    • GitHub および Gitlab リポジトリの場合は、GitHub/Gitlab パーソナル アクセス トークンを追加します。

    • Bitbucket リポジトリの場合は、ユーザー名と個人アクセス トークンを追加します。

    いつでも認証を設定できます

    認証をスキップして続行できます。後で構成できます。

  7. Bitrise はこのブランチで最初のビルドを実行し、Bitrise アプリのデフォルト ブランチとして設定されますが、 この設定は後で変更できます.このブランチには、プロジェクトの構成が含まれている必要があります。

    • 前の手順で SSH アクセスを正常に構成した場合、またはパブリック アプリを追加している場合、Bitrise はリポジトリを解析し、ドロップダウン メニューからブランチを選択できるようにします。

    • リポジトリ アクセスを構成していない場合は、ブランチ名を手動で入力する必要があります。

    Bitrise はこのブランチで最初のビルドを実行し、Bitrise アプリのデフォルト ブランチとして設定されますが、 この設定は後で変更できます.このブランチには、プロジェクトの構成が含まれている必要があります。

    choose-branch.png
  8. Bitrise でプロジェクト タイプを自動検出するかどうかを選択します。:

    • はい、構成を自動検出します: このオプションを選択すると、Bitrise はリポジトリをスキャンし、 スタック スキャンの結果に基づいたデフォルトのワークフロー。ほとんどの場合、このオプションを選択することをお勧めします。

    • いいえ、自動検出をスキップして手動で設定を構成します: プロジェクトの種類を選択する必要があります。 スタックタイプ、 と ビルドマシンタイプ

    プロジェクトの種類

    プロジェクトタイプの検出は、アプリの初期構成を支援するのに役立ちます。ただし、アプリを追加した後はいつでも、プロジェクトタイプを含むすべての設定を変更できますのでご安心ください。

  9. 自動構成を選択し、Bitrise がプロジェクト タイプを正常に検出した場合は、次のステップに進みます。 Bitrise がプロジェクト タイプを検出できなかった場合、2 つのオプションがあります。

    • プロジェクトスキャナーが失敗する原因となった問題を修正してみてください。私たちが提供するログが役立つかもしれません。選択が完了したら 自動構成を再試行してください

    • 選択する スキップして手動で構成する。プロジェクトの種類を選択し、選択した種類に基づいてプロジェクト構成を設定する必要があります。選択した場合 その他/マニュアル、スタックタイプを選択するだけです。

  10. プロジェクトのビルド構成を確認し、をクリックします 準備できました それが終わったら。

    正確な構成オプションは、プロジェクトの種類によって異なります。スタックと、選択したスタックのマシン タイプを選択するオプションが常にあります。これらのオプションについてよくわからない場合でも、心配しないでください。 後で変更できます.

  11. 必要に応じて、画像をアップロードしてアプリアイコンを追加します。

    必要に応じて、これをスキップして後でアイコンを追加できます。

  12. 必要に応じて、BitriseがリポジトリにWebhookを設定できるようにします。

    するには Webhook が必要です ビルドを自動的にトリガーする.アプリの Webhook はいつでも設定できるので、今はスキップしてかまいません。

    webhook-registration.png
  13. Once you are done, click View App Page to go to the newly added app's home page. From there, you can start editing your Workflows and run builds.