Skip to main content

オンラインでアーティファクトを作成する

概要

Bitriseでのビルドは、アーティファクトを生成する可能性があり、多くの場合、生成されます。たとえば、テストレポート、イメージ、実行可能バイナリなどです。アプリのビルドを選択した場合は、 アーティファクト タブで、ビルド中に生成されたアーティファクトを確認できます。

ビルド成果物とは、Bitrise ビルド中に生成されるファイルです。テスト結果、スクリーンショット、実行可能バイナリなどです。ビルド成果物は 2 つの場所で表示できます。

  • 上の 遺物 ビルドのページのタブ。ここですべての成果物を表示できます。

    builds-artifacts-tab.png

  • の 遺物 アプリのメイン ページの ページ。ここではインストール可能なバイナリのみが表示されます。

    installable-artifacts.png

デプロイされるファイルの数に制限はありません。 遺物 ビルドごとにタブが表示されます。ただし、ファイル サイズには 1 ファイルあたり 2 GB という制限があります。

アーティファクト保存期間

ビルドアーティファクトは、完全に削除されるまでの期間限定で保存されます。ストレージコストと一般的な使用パターンのバランスをとるため、保存期間はアーティファクトの種類によって異なります

古いアーティファクト

2026年3月31日より前に作成されたアーティファクトには、古い保存ポリシーが適用されます。標準アーティファクト、インストール可能なアーティファクト、パイプライン中間ファイルの場合は365日、HTMLレポートの場合は7日間です。

表 1. アーティファクト保存期間

アーティファクトタイプ

リテンション期間

標準アーティファクト (ビルドログ、テストレポート)

90 日間

インストール可能なバイナリ (IPA、APK、AAB)

150 日間

HTML レポート

7 日間

パイプライン中間ファイル

7 日間

アーティファクトを独自のストレージにアーカイブする

保存期間を超えてアーティファクトを保存するには、Bitrise APIを使用してアーカイブしてください。

  1. アーカイブするビルドアーティファクトのリストを生成:使用 /apps/{app-slug}/builds 1 つのプロジェクトに含まれるすべてのビルドのリストを生成します。

  2. ビルドごとに、以下を使用して特定のビルドのすべてのアーティファクトを一覧表示します /apps/{app-slug}/builds/{buildslug}/artifacts。

  3. アーティファクトごとに、次の方法でダウンロード URL を取得します。 /apps/{app-slug}/builds/{buildslug}/artifacts/{artifact-slug}。

  4. ダウンロード URL のリストを使用して各アーティファクトをダウンロードします。

  5. すべてのアーティファクトをお好みのストレージに保存します。

カスタムリテンションポリシー

Enterpriseのお客様は、カスタムリテンションポリシーを利用できます。担当のカスタマーサクセスマネージャーに連絡して話し合ってください。

  • 保存期間の短縮:追加コストなしで利用できます（ストレージのオーバーヘッドを削減するのに役立ちます）。

  • 長期保存:追加料金がかかります。

標準アーティファクトとインストール可能なアーティファクトのみ

カスタム保存期間は、標準アーティファクトとインストール可能なアーティファクトにのみ適用されます (HTML レポートやパイプライン中間ファイルには適用されません)。複数のワークスペースがある場合は、そのすべてにカスタム保存期間を適用することも、それぞれに異なる保存期間をリクエストすることもできます

インストール可能な成果物ページ

上の インストール可能なアーティファクト ページでは、次のことができます。

  • 過去のビルドのインストール可能なバイナリを表示します。

  • インストール可能なアーティファクトをダウンロードします。

  • これらのアーティファクトの詳細ページを確認してください。これには、 パブリックインストールページ。

このページにアクセスするには、Bitriseにログインし、アプリを所有するワークスペースを選択して開きます。 ビットライズCIアプリを選択すると、 遺物 左に。

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

  • バイナリのプラットフォーム (iOS または Android)。

  • それを生成したビルドの時間枠。

    timeframe-artifacts.png

  • ビルドが実行されたワークフロー。

  • 構築されたリポジトリのブランチ。

アーティファクトの詳細

Bitrise ビルドによって生成されたインストール可能なアーティファクト (バイナリ、IPA または APK/AAB ファイル) の詳細を確認できます。詳細には次のものが含まれる可能性があります。

  • 正確なファイル名。

  • バイナリのバージョン。

  • 作成時間やファイル サイズなどのメタデータ。

  • インストール用のQRコード。

  • リンク パブリックインストールページ 有効になっている場合。

詳細ページにアクセスするには、 遺物 ページでファイルを選択し、 インストール可能なアーティファクト リスト。

CrossPlatform.png

詳細ページで最も重要なことは、モバイル デバイスにアプリをインストールすることです。これは、テスト目的に特に役立ちます。次の 2 つのオプションがあります。

  • QR コード: バイナリをインストールするにはこれをスキャンします。

  • パブリックインストールページへのリンク。

qr-code-install.png

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

アーティファクトへのファイルのデプロイ

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

アーティファクトをデプロイするには、 Bitrise.ioにデプロイします アーティファクトを生成するステップの後のステップ、または Bitrise.ioにデプロイします ステップはワークフローの最後にあります。

ステップを適切な場所に配置します

追加します Bitrise.ioにデプロイします 適切な場所に足を踏み入れてください。ビルド中にファイルを生成する他のステップの前にステップを挿入すると、 Bitrise.ioにデプロイします デプロイするものは何もありません。

デプロイディレクトリで見つかったサブディレクトリのコンテンツは、 アーティファクト ビルドのセクション。ただし、デフォルトを変更すると、アーティファクトをzipファイルに圧縮できます。 false の値 true の中に アーティファクトを1つのファイルに圧縮します のフィールド Bitrise.ioにデプロイします ステップ。これにより、ディレクトリ全体とそのサブディレクトリが圧縮され、次の場所に展開されます。 アーティファクト。

ターゲットディレクトリパスの変更

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

ビルドが失敗した場合のアーティファクトの表示

とともに 前のステップが失敗した場合に実行 トグルを有効にすると、ビルドが失敗した場合でも、ビルドアーティファクト（正常に生成されたアーティファクトのみ）にアクセスできます。たとえば、生成されたテストレポートファイルを調べることで、失敗したビルドのバグを検出できます。

ビルドアーティファクトにアクセスできるのは誰ですか？

の遺物 アーティファクト アプリの所有者、管理者、開発者、テスター/ QAであるすべての人がアクセスできます。これらの役割に加えて、デフォルトの構成を維持する場合 アプリの公開ページを有効にする この機能を使用すると、URLを受け取った人は誰でも、アプリとそのアーティファクトにアクセスできるようになります。

このセクションの内容: