Skip to content
package

GitHub Action

Setup Android tools

v1 Latest version

Setup Android tools

package

Setup Android tools

Set up Android tools in GitHub Actions workflow with caching

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Setup Android tools

uses: maxim-lobanov/setup-android-tools@v1

Learn more about this action in maxim-lobanov/setup-android-tools

Choose a version

setup-android-tools

This action is intended to install Android tools on Hosted images in GitHub Actions.
It wraps sdkmanager and automates caching of installed packages.

Usage

Install single package without cache:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: setup-android-tools
      uses: maxim-lobanov/setup-android-tools@v1.0
      with:
        packages: ndk;19.2.5345600

Install multiple packages without cache:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: maxim-lobanov/setup-android-tools@v1.0
      with:
        packages: |
          platforms;android-29
          platforms;android-30
          system-images;android-30;google_apis;x86

Install package with cache:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: maxim-lobanov/setup-android-tools@v1.0
      with:
        packages: ndk;19.2.5345600
        cache: true

Cache packages

With cache: true, action will automatically cache all downloaded packages via @actions/cache. In some cases, it could significantly speed up your builds (especially on MacOS images).

Note: GitHub will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited to 5 GB. If you exceed this limit, GitHub will save your cache but will begin evicting caches until the total size is less than 5 GB.
See "Caching dependencies to speed up workflows" for how caching works.

More details about speed advantage of using cache
(Table contains average results since installation time may vary depending on VM connection speed)
Packages OS With cache (sec) Without cache (sec)
ndk;19.2.5345600 Ubuntu 62 85
Windows 149 180
MacOS 25 71
ndk-bundle
system-images;android-30;google_apis;x86
system-images;android-30;google_apis;x86_64
Ubuntu 130 167
Windows 157 182
MacOS 43 205
platforms;android-20
add-ons;addon-google_apis-google-20
constraint-layout-solver;1.0.0-alpha8
extras;google;webdriver
Ubuntu 10 20
Windows 28 42
MacOS 8 59

License

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