ビルドアーティファクトの管理

概要

Bitrise APIを使用して、ビルドアーティファクトを一覧表示、取得、更新、および削除できます。

追加した場合 Deploy to bitrise.io ステップ あなたに ワークフロー、ビルドが実行されると、ビルドのビルドアーティファクトにアクセスできますアーティファクト bitrise.ioのタブ。

BitriseAPIを使用して生成されたアーティファクトを管理することもできます。

重要:アーティファクト保存ポリシー

以下を含むアーティファクトビルドログ、ビルドファイル、インストール可能なアーティファクト、またはコードプッシュパッケージは限られた期間のみ保存されます。詳細については、を参照してくださいアーティファクト保存期間。

表 1. APIを使用したビルドアーティファクトの管理に関連するエンドポイント

終点	関数	アプリのチームで必要な役割
GET / apps / {app-slug} / builds / {build-slug} / artifacts	ビルドアーティファクトの一覧表示	どれでも
GET / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug}	特定のビルドアーティファクトのデータを取得する	どれでも
パッチ/アプリ/ {アプリ-スラッグ} / builds / {ビルド-スラッグ} /アーティファクト/ {アーティファクト-スラッグ}	ビルドアーティファクトの更新	所有者、管理者、または開発者
DELETE / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug}	ビルドアーティファクトの削除	所有者、管理者、または開発者

ビルドアーティファクトの一覧表示

必要な役割

APIを使用してビルドアーティファクトを一覧表示するには、アプリのチームにテスター/ QA、開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。プロジェクトチームのユーザーロール。

ビルドアーティファクトエンドポイントを使用できるようにするには、最初にアプリのビルドに属するすべてのアーティファクトを一覧表示する必要があります。応答には、後で必要になるスラッグとともにすべてのアーティファクトが一覧表示されます。

必要なパラメーターは次のとおりです。

アプリスラッグ
ナメクジを作る

ビルドアーティファクトスラグが必須パラメーターである他のビルドアーティファクトエンドポイントで、応答出力から生成されたビルドアーティファクトスラグを使用できます。

例 1. アプリのアーティファクトを一覧表示する

リクエスト：

curl -X GET "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": [
    {
      "title": "another_app-debug.apk",
      "artifact_type": "android-apk",
      "is_public_page_enabled": true,
      "slug": "92e0b6ecae87b832",
      "file_size_bytes": 1574799
    },
    {
      "title": "app-debug.apk",
      "artifact_type": "android-apk",
      "is_public_page_enabled": true,
      "slug": "54ae701761c4f956",
      "file_size_bytes": 1574793
    }
  ],
  "paging": {
    "total_item_count": 2,
    "page_item_limit": 50
  }
}

特定のビルドアーティファクトのデータを取得する

必要な役割

APIを使用して特定のビルドのアーティファクトデータを取得するには、アプリのチームにテスター/ QA、開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。プロジェクトチームのユーザーロール。

アーティファクトエンドポイントを使用して、特定のビルドのアーティファクトの詳細データを取得できます。応答には、ファイル名、アーティファクトタイプ、ダウンロードURL、およびファイルサイズが表示されます。

必要なパラメーターは次のとおりです。

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例 1. 特定のアーティファクトのデータを取得する

リクエスト：

curl -X GET "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/92e0b6ecae87b832" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": {
    "title": "another_app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": "https://bitrise-prod-build-storage.s3.amazonaws.com/builds/b234f959745082e0/artifacts/7626902/another_app-debug.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190426%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190426T131627Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=9f1af26787f34b5cf0cbc18b2372313607b1e3c0203a9ce7e42da884a6ddf70f",
    "is_public_page_enabled": true,
    "slug": "92e0b6ecae87b832",
    "public_install_page_url": "https://bitrise.io/artifact/7626902/p/8e5b2c62abe28fecef09b271de767920",
    "file_size_bytes": 1574799
  }
}

デフォルトでは、 is_public_page_enabled 入力はに設定されます true。このように public_install_page_url が利用可能になり、このURLを介してアーティファクトに関するいくつかの基本情報を表示できます。応答出力からダウンロードURLを使用してアーティファクトをダウンロードすることもできます。

アーティファクトのパブリックインストールページを無効にする

必要な役割

APIを使用してアーティファクトの公開インストールページを無効にするには、アプリのチームに開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。プロジェクトチームのユーザーロール。

あなたは更新することができます is_public_page_enabled APKおよびIPAファイルのパラメータ。このパラメータの値はに設定されていることに注意してください true デフォルトでは、このエンドポイントでのみ無効にできます。

必要なパラメーターは次のとおりです。

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例 1. APKファイルの公開インストールページを無効にする

リクエスト：

curl -X PATCH "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/54ae701761c4f956" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN" -H "Content-Type: application/json" -d "{ \"is_public_page_enabled\": false}"

応答：

{
  "data": {
    "title": "app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": "https://bitrise-prod-build-storage.s3.amazonaws.com/builds/b234f959745082e0/artifacts/7626904/app-debug.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190503%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190503T082800Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=7251fcbc0574ffac60b3f1d4a8c398658e49f0b86fb3cfec1500bde125738abc",
    "is_public_page_enabled": false,
    "slug": "54ae701761c4f956",
    "public_install_page_url": "",
    "file_size_bytes": 1574793
  }
}

ビルドをチェックする場合 APPS & ARTIFACTS タブ、あなたはそれを見るでしょう Public install page トグルは無効です。

ビルドアーティファクトの削除

必要な役割

APIを使用してビルドアーティファクトを削除するには、アプリのチームに開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。プロジェクトチームのユーザーロール。

アプリ固有のビルドアーティファクトを削除できます。

必要なパラメーターは次のとおりです。

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例 1. APKファイルの削除

リクエスト：

curl -X DELETE "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/54ae701761c4f956" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": {
    "title": "app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": null,
    "is_public_page_enabled": true,
    "slug": "54ae701761c4f956",
    "public_install_page_url": "",
    "file_size_bytes": 1574793
  }
}

このセクションの内容:

参照:

ステップワークフロー

ビルドアーティファクトの管理

重要:アーティファクト保存ポリシー

ビルドアーティファクトの一覧表示

必要な役割

特定のビルドアーティファクトのデータを取得する

必要な役割

アーティファクトのパブリックインストールページを無効にする

必要な役割

ビルドアーティファクトの削除

必要な役割

検索結果