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/[email protected]
with:
packages: ndk;19.2.5345600
Install multiple packages without cache:
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: maxim-lobanov/[email protected]
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/[email protected]
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