GitHub - amyu/setup-android: Setup Android SDK for self hosted runner

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.
Runs on Mac, Linux and Windows powered by SelfHostedRunner.
Exporting environment variables:
- ANDROID_SDK_ROOT
- ANDROID_HOME
- ANDROID_NDK_ROOT (when ndk-version is specified)
- ANDROID_NDK_HOME (when ndk-version is specified)
- ANDROID_NDK (when ndk-version is specified)
- CMAKE_VERSION (when cmake-version is specified)
Adding to PATH:
- $ANDROID_SDK_ROOT/platform-tools
- $ANDROID_SDK_ROOT/ndk-bundle
- $ANDROID_SDK_ROOT/cmdline-tools/latest/bin

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@v5
  - name: Setup JDK 17
    uses: actions/setup-java@v5
    with:
      java-version: 17
      distribution: jetbrains

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

  - 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@v5
  with:
    sdk-version: ${{ steps.read_version.outputs.sdkVersion }}

More Information:

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

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

      # default: 36
      # sdk version
      # see https://developer.android.com/studio/releases/platforms
      # It will always be installed.
      sdk-version: 36
      # or
      sdk-version: |
        35
        36
      # or set sdk-version to the value written in API Level from SDK Manager
      sdk-version: Baklava

      # default: ''
      # build tools version
      # see https://developer.android.com/studio/releases/build-tools
      # Optional. If omitted, this action does not preinstall build-tools.
      # In typical Android/Gradle projects, prefer letting AGP manage the required version.
      # Set this only when you need to preinstall a specific version in CI.
      build-tools-version: 36.0.0
      # or
      build-tools-version: |
        30.0.3
        31.0.0
        36.0.0

      # 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: 14742923
      # see https://developer.android.com/studio#command-tools
      # ex commandlinetools-mac-${command-line-tools-version}_latest.zip
      command-line-tools-version: 14742923

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

License

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

Contributions

Contributions are welcome!