Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/JakeWharton/sdk-manager-plugin

DEPRECATED Gradle plugin which downloads and manages your Android SDK.
https://github.com/JakeWharton/sdk-manager-plugin

Last synced: about 1 month ago
JSON representation

DEPRECATED Gradle plugin which downloads and manages your Android SDK.

Host: GitHub
URL: https://github.com/JakeWharton/sdk-manager-plugin
Owner: JakeWharton
License: apache-2.0
Archived: true
Created: 2014-03-29T09:48:51.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2016-10-07T23:07:08.000Z (about 8 years ago)
Last Synced: 2024-09-27T04:20:12.629Z (3 months ago)
Language: Groovy
Homepage:
Size: 442 KB
Stars: 1,410
Watchers: 92
Forks: 132
Open Issues: 44
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt

Awesome Lists containing this project

awesome-android-tools - SDK Manager Plugin - Gradle plugin which downloads and manages your Android SDK. (Gradle Plugin)
awesome-gradle - sdk-manager-plugin - Download and manage Android SDK. (Plugins / Android application development)

README

# DEPRECATED

This plugin is deprecated and is no longer being developed. Tools and dependencies are [automatically downloaded](https://developer.android.com/studio/intro/update.html#download-with-gradle) using version 2.2.0 of the Android Gradle plugin or newer.

![](http://i.imgur.com/8JsJXzn.jpg)

SDK Manager Plugin
==================

SDK missing? API level not downloaded? Support library out-of-date?

These are all typical problems which you shouldn't have to deal with. This is especially painful
when you have multiple developers on a project or a CI machine that you have to keep up-to-date.

This Gradle plugin will manage these SDK dependencies for you automatically.

Supported functionality:

* `local.properties` will be created if missing. The `ANDROID_HOME` environment variable will be
used if present. Otherwise `~/.android-sdk` will be used.
* The platform-specific SDK will be downloaded if missing.
* The build tools and platform tools will be downloaded if missing.
* Compilation API declared in `compileSdkVersion` will be downloaded if missing.
* If any dependencies are declared on support libraries, the support repository will be downloaded
if missing. If the revision of the support repository does not contain the version declared it
will be updated.
* If any dependencies are declared on Google Play Services, the Google repository will be
downloaded if missing. If the revision of the Google repository does not contain the version
declared it will be updated.
* If an emulator is specified, it will be downloaded if missing. If the emulator revision is less
than the available revision, it will be updated.

*Note: By using this plugin you acknowledge that associated licenses of the components downloaded
are accepted automatically on your behalf. You are required to have accepted the respective licenses
of these components prior to using this plugin.*

Usage
-----

Apply the plugin in your `build.gradle` *before* the regular 'android' plugin:
```groovy
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:0.12.+'
classpath 'com.jakewharton.sdkmanager:gradle-plugin:0.12.+'
}
}

apply plugin: 'android-sdk-manager'
apply plugin: 'com.android.application'

// optionally including an emulator
sdkManager {
emulatorVersion 'android-19'
emulatorArchitecture 'armeabi-v7a' // optional, defaults to arm
}
```

On an initial run, the output will look something like this:
```
$ ./gradlew clean assemble
Android SDK not found. Downloading...
SDK extracted at '/Users/jw/.android-sdk'. Writing to local.properties.
Build tools 20.0.0 missing. Downloading...
Compilation API android-19 missing. Downloading...
Support library repository missing. Downloading...
Google Play Services repository missing. Downloading...
Emulator version not installed or outdated. Downloading...

(normal execution output)
```
Your output likely will be different depending on the varying factors listed above. Subsequent runs
will omit this output and proceed directly to normal execution.

How long does this plugin add to the build lifecycle? It currently takes about 100ms on average to
check all of the above conditions. This cost is only paid when Gradle is setting up the model for
the project. If you use the Gradle daemon or use Android Studio this only happens once.

License
--------

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.