メインコンテンツまでスキップ

オンラインのビルドアーティファクト

ビルドアーティファクトとは、Bitriseビルド中に生成されるすべてのファイルのことです。テスト結果、スクリーンショット、実行可能バイナリなどが含まれます。ビルドアーティファクトは、次の2つの場所で確認できます。

  • ビルドページのArtifactsタブ。ここではすべてのアーティファクトを確認できます。

    builds-artifacts-tab.png

  • アプリのメインページにあるArtifactsページ。ここではインストール可能なバイナリのみを確認できます。

Artifactsタブにビルドごとデプロイできるファイル数に制限はありません。ただし、ファイルサイズには1ファイルあたり2GBの制限があります。

Installable artifactsページClick to copy link​

Installable artifactsページでは、次のことができます。

  • 過去のビルドのインストール可能なバイナリを確認する。
  • インストール可能なアーティファクトをダウンロードする。
  • これらのアーティファクトの詳細ページを確認する。ここにはパブリックインストールページが含まれる場合があります。

このページにアクセスするには、Bitriseにログインし、アプリを所有するWorkspaceを選択して、Bitrise CIを開きます。アプリを選択すると、左側にArtifactsが表示されます。

インストール可能なアーティファクトは、いくつかの異なるフィルターを使用して絞り込むことができます。

  • バイナリのプラットフォーム(iOSまたはAndroid)。
  • バイナリを生成したビルドが実行された期間。
  • ビルドが実行されたWorkflow。
  • ビルド対象となったリポジトリのブランチ。

アーティファクトの詳細Click to copy link​

Bitriseビルドで生成されたインストール可能なアーティファクト(IPAまたはAPK/AABファイルのいずれかのバイナリ)の詳細を確認できます。詳細には次の情報が含まれる場合があります。

  • 正確なファイル名。
  • バイナリのバージョン。
  • 作成日時やファイルサイズなどのメタデータ。
  • インストール用のQRコード。
  • 有効になっている場合は、パブリックインストールページへのリンク。

詳細ページにアクセスするには、Artifactsページを開き、Installable artifactsリストからファイルを選択します。

詳細ページ自体で最も重要な操作は、モバイルデバイスにアプリをインストールすることです。これはテストの際に特に役立ちます。次の2つの方法があります。

  • QRコード: スキャンしてバイナリをインストールします。
  • パブリックインストールページへのリンク。

qr-code-install.png

iOSアプリをデバイスにインストールする場合、そのデバイスはApple Developer Portal上でアプリに登録されている必要があります。利用可能なデバイスは、Who can install this app?セクションで確認できます。

ファイルをアーティファクトにデプロイするClick to copy link​

アーティファクトは、Deploy to Bitrise.io Stepを使用して、ビルドページのArtifactsセクションにデプロイされます。ビルド中に生成されたすべてのファイルをデプロイし、$BITRISE_DEPLOY_DIRディレクトリに保存します。

アーティファクトをデプロイするには、アーティファクトを生成するStepの後にDeploy to Bitrise.io Stepを追加してください。さらに良いのは、Deploy to Bitrise.io StepをWorkflowの一番最後に配置することです。

Stepを正しい場所に配置する

Deploy to Bitrise.io Stepを正しい場所に追加してください。ビルド中にファイルを生成する他のStepsより前にStepを挿入すると、Deploy to Bitrise.ioにはデプロイするものがなくなります。

デプロイディレクトリ内にあるサブディレクトリの内容は、ビルドのArtifactsセクションには表示されません。ただし、Deploy to Bitrise.io Stepのアーティファクトを1つのファイルに圧縮するフィールドで、デフォルトのfalseの値をtrueに変更すると、アーティファクトをZIPファイルに圧縮できます。これにより、サブディレクトリを含むディレクトリ全体が圧縮され、Artifactsにデプロイされます。

ターゲットディレクトリパスを変更するClick to copy link​

ターゲットディレクトリパスは別のパスに変更できますが、生成されたファイルが同じディレクトリに収集されるように、Workflow内の他のStepsでも同じディレクトリパスを参照するようにしてください。

ビルドが失敗した場合にアーティファクトを表示するClick to copy link​

Run even if previous Step(s) failedトグルを有効にすると、ビルドが失敗した場合でも、正常に生成されたビルドアーティファクトのみアクセスできます。たとえば、生成されたテストレポートファイルを確認することで、失敗したビルドのバグを検出できます。

ビルドアーティファクトへのアクセス権を持つユーザーClick to copy link​

Artifactsにあるアーティファクトは、アプリのオーナー、管理者、デベロッパー、テスター/QAの全員がアクセスできます。これらのロールに加えて、Enable public page for the App機能をデフォルト設定のままにしている場合、URLを受け取った人は誰でもアプリとそのアーティファクトにアクセスできるようになります。