This is a cache of https://github.com/marketplace/actions/setup-android-sdk-for-self-hosted-runner. It is a snapshot of the page as it appeared on 2025-08-19T18:08:37.716+0200.
setup android sdk for self hosted runner · Actions · GitHub Marketplace · GitHub
Skip to content

setup android sdk for self hosted runner

Actions
setup-android for self hosted runner
v4
Latest
By amyu
Star (49)

setup-android

This action provides the following functionality for GitHub Actions users:

  • Optionally downloading and caching distribution of the requested sdk version or build tools version or ndk,cmake version, and adding it to the PATH
  • Runs on Mac, linux and Windows powered by SelfHostedRunner

Motivation

This Action is provided for SelfHostedRunner.
GithubHostedRunner does not need this Action as it already has the SDK set up.

Usage

See action.yml

Basic:

steps:
  - uses: actions/checkout@v4
  - name: Setup JDK 17
    uses: actions/setup-java@v3
    with:
      java-version: 17
      distribution: temurin

  - name: Setup Android SDK
    uses: amyu/setup-android@v4

  - run: ./gradlew build --stacktrace

Recommend:

If your project uses VersionCatalog, the following settings are recommended

- name: "Get sdkVersion from versions.toml"
  id: read_version
  shell: bash
  run: |
    version=`perl -nlE 'say if s/compileSdkVersion \= \"(.*)\"/$1/g' gradle/libs.versions.toml`
    echo "sdkVersion=$version" >> $GITHUB_OUTPUT

- name: Setup Android SDK
  uses: amyu/setup-android@v4
  with:
    sdk-version: ${{ steps.read_version.outputs.sdkVersion }}

More Information:

  - name: Setup Android SDK
    uses: amyu/setup-android@v4
    with:
      # default: false
      # Whether to use the cache
      cache-disabled: true

      # default: `${sdkVersion}-${buildToolsVersion}-${ndkVersion}-${cmakeVersion}-${hashedCacheDirectory}-v4`
      # Custom key for cache. It is invalid when `cache-disabled: true`
      cache-key: 'custom-cache-key'

      # default: 34
      # sdk version
      # see https://developer.android.com/studio/releases/platforms
      # It will always be installed.
      sdk-version: 34
      # or
      sdk-version: |
        33
        34

      # default: 33.0.2
      # build tools version
      # see https://developer.android.com/studio/releases/build-tools
      # It will always be installed.
      build-tools-version: 33.0.2

      # default: ''
      # cmake version
      # see https://developer.android.com/studio/projects/install-ndk
      # Installed when the version is specified
      cmake-version: 3.10.2.4988404

      # default: ''
      # cmake version
      # see https://developer.android.com/studio/projects/install-ndk
      # Installed when the version is specified
      ndk-version: 23.1.7779620

      # default: true
      # Whether to generate or not the job summary
      generate-job-summary: false

Install Beta SDK:

Set sdk-version to the value written in API Level from SDK Manager

- name: Setup Android SDK
  uses: amyu/setup-android@v4
  with:
    sdk-version: VanillaIceCream

License

The scripts and documentation in this project are released under the MIT License

Contributions

Contributions are welcome!

setup android sdk for self hosted runner is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

setup-android for self hosted runner
v4
Latest
By amyu

setup android sdk for self hosted runner is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.