xaethos/android-sdk-resource repository overview

⁠Android SDK Resource

Concourse⁠ resource providing Android SDK dependencies.

⁠Resource type

As a third party resource, this needs to be declared in the pipeline's resource_types section.

⁠Source Configuration

• components: Required. An array of strings with the names of components required, as they would be given to the android update sdk tool. platform-tools is always implicitely included. e.g.: if you are building an APK against SDK 23, and using the Android support library, you might have:

  components:
    - tools
    - build-tools-23.0.2
    - android-23
    - extra-android-m2repository
  

  Copy

  The order of the components is not important. Duplicates are ignored.

⁠Behavior

⁠check

No real check is done. The version of the resource is the list of components that will be provided.

⁠in

Fetches the Android SDK.

The destination will have the SDK with requested components installed. The destination directory can be used as the ANDROID_HOME environmental variable for your task.

Since Concourse caches resource versions, the SDK won't be downloaded again unless the set of required components changes.

⁠out

This resource does not support this operation. A put step in the build plan will always fail.

⁠Example pipeline

Below is an example for an android build pipeline. For brevity, I've inline the configuration for the assemble task; normally it would live in a file of its own.

Observe that I set the ANDROID_HOME environmental variable as part of the run script. The path must be absolute, not relative, or some parts of the build won't work.

resource_types:
  - name: android-sdk
    type: docker-image
    source: {repository: xaethos/android-sdk-resource}

resources:
  - name: android-sdk-linux
    type: android-sdk
    source:
      components:
        - android-23
        - build-tools-23.0.2
        - extra-android-m2repository

  - name: project-source
    type: git
    source:
      uri: https://github.com/example/android-project.git
      branch: master

jobs:
  - name: assemble-debug
    plan:
      - get: android-sdk-linux
      - get: project-source
      - task: assemble
        config:
          platform: linux
          image_resource:
            type: docker-image
            source:
              repository: xaethos/android-build
              tag: no-sdk
          inputs:
            - name: android-sdk-linux
            - name: project-source
          run:
            path: sh
            args:
              - -euxc
              - >-
                TERM=screen-256color
                ANDROID_HOME="$PWD/android-sdk-linux"
                project-source/gradlew --project-dir=project-source :app:assembleDebug