Google GitGoogle Git
Sign in
android/tools/fetch_artifact/refs/heads/mirror-goog-main-tools
commit
0b93639b08957306f07abaeded736986b073286c
[log]
author
Dennis Song <denniscy@google.com>
Fri Jul 24 15:28:31 2026 +0000
committer
Dennis Song <denniscy@google.com>
Mon Jul 27 04:56:22 2026 +0000
tree
607e79ebd73f5161e9e4dcce1c320d32a8c0391a
parent
741d638b8414c0611355ca7fc1db177f51946f01 [diff]
Migrate fetch_artifact tool to Android Build API v4.

Update fetch_artifact.go to use the Android Build API v4 endpoints
because v3 will soon be deprecated.

Bug: 538355099
Test: go build -o out/fetch_artifact fetch_artifact.go && \
        out/fetch_artifact -artifact=<> -build_id=<> -target=<> \
	-client_id=<> -secret=<> -project_id=<>
Change-Id: I836615b15b36ca4d9cc15908a8280087eabe858d
1 file changed
tree: 607e79ebd73f5161e9e4dcce1c320d32a8c0391a
  1. .gitignore
  2. build.sh
  3. fetch_artifact.go
  4. go.mod
  5. go.sum
  6. OWNERS
  7. README.md
README.md

Fetch Artifact

Fetch artifact is a tool for downloading artifacts from Android's continuous integration service.

Options

  • target: Required - The target you would like to download the artifact from.
  • artifact: Required - The artifact to download.
  • Required: either build_id or branch, but not both
    • When only build_id is provided, the script would download the artifact from that build_id.
    • When only branch is provided, the script would download the artifact from the last known good build of that branch.
  • output: Optional - If you would like the contents of the file to be written to a specific file.
  • client_id: Optional - If authorization is required to download the artifact, please set this parameter as your OAuth2.0 Client ID.
  • secret: Optional - If authorization is required to download the artifact, please set this parameter as your OAuth2.0 Client secret.
  • port: Optional - If you would like to specify the OAuth callback port to listen on. Default: 10502
  • project_id: Optional - The project id being used to access the fetch APIs.
  • -: Optional - If you would like the contents of the file to be written to stdout (must be the last arg)

Example usage

fetch_artifact -target=aosp_arm64-userdebug -build_id=7000390 -artifact=COPIED

Streaming contents to stdout

fetch_artifact -target=aosp_arm64-userdebug -build_id=7000390 -artifact=COPIED -

Get the latest successful build's artifact without specifying a build_id

fetch_artifact -target=aosp_arm64-trunk_staging-userdebug -branch=aosp-main -artifact=COPIED

Using OAuth to fetch restricted artifacts

In this case, you might need to create an OAuth 2.0 Client ID for a web application and set the redirect URI to http://localhost:<port>(default port: 10502).

fetch_artifact -target=<restricted_target> -build_id=<id> -artifact=COPIED -client_id=<OAuth_client_id> -secret=<OAuth_client_secret>

If you are accessing the fetch APIs from a different project than your OAuth client, you will need to specify the -project_id flag:

fetch_artifact -target=<restricted_target> -build_id=<id> -artifact=COPIED -client_id=<OAuth_client_id> -secret=<OAuth_client_secret> -project_id=<project_id>

Development

Building

OUT_DIR=out ./build