android environment using docker and bitbucket pipelines

ⅰ亾dé卋堺 提交于 2019-11-29 23:05:01
Travis

If I understand your question correctly: you technically don't even need to install Docker on your local machine in order to use it in your Bitbucket Pipelines (although it can be quite helpful for debugging).

Bitbucket Pipelines can be configured to use a Docker from Docker Hub, and the one you mentioned (uber/android-build-environment) worked well for me.

Simply add a bitbucket-pipelines.yml to the root of your project, for example:

image: uber/android-build-environment:latest

pipelines:
  default:
    - step:
        script:
          - build.sh

I like to organize my build process in it's own ash script file (build.sh) but that is optional (you could instead put multiple bulleted commands in the yaml file under the script directive). Examples of (and more details about) the bitbucket-pipelines.yml file can be found on the Language guides for Bitbucket Pipelines page.

My build.sh script (also in the root of the project, but could be placed in a subdirectory as long as you refer to it as such in your bitbucket-pipelines.yml, e.g. scripts/build.sh):

#!/bin/sh

mkdir "${ANDROID_HOME}/licenses" || true
echo "8933bad161af4178b1185d1a37fbf41ea5269c55" > "${ANDROID_HOME}/licenses/android-sdk-license"

./gradlew assembleDebug

The licenses portion allows the Android Gradle process to automatically download Android dependencies for you, as mentioned in this answer.

For good measure, set the permissions on the build script accordingly:

git update-index --chmod=+x build.sh

Make sure that you've enabled Bitbucket Pipelines (from your repo page: Settings -> Pipelines: Settings -> Enable Pipelines).

Then just commit the bitbucket-pipelines.yml and build.sh and push to your BitBucket repo. The Bitbucket Pipelines build for your project should begin shortly after your push. The Bitbucket Pipelines will download the uber/android-build-environment Docker from Docker Hub and checkout your project and run the build.sh script within the Docker.


The process you were describing of setting up the Docker on your local machine can be really helpful if your Bitbucket Pipelines build fails and you want to have the same environment running on your local machine so you can experiment with it and test changes to the build.sh script before actually committing and pushing to your repo.

Might also prove helpful if you ran (locally):

docker run -it uber/android-build-environment

Which will start up the Docker (on your local machine) and put you in an interactive shell, so that you can browse around and gain a better understanding of the Docker environment.

Also note that the Bitbucket Pipelines clones your repo in the Docker as part of the build process (which as far as I could tell) you had not done on the Docker running on your local machine, which may have led to some of your confusion about your build.sh script not being present.

If you want a directory on your local machine to exist within a Docker (that you are running on your local machine, perhaps to test building a project on your local machine within a Docker you want to use) you can use the following command to mount your current working directory to /project within the locally running Docker:

docker run -v `pwd`:/project -it uber/android-build-environment

More details can be found at Mount a host directory as a data volume.

As @ming-c pointed out in their answer, there are many other Docker images available on Docker Hub; it is certainly worth browsing around to see if you can find an image best suited to your needs.

uber's image is built for their CI environment, I created a typical docker image only include Android build env. It included the latest SDK and NDK. You can just use following example as your bitbucket-pipelines.yml

image: mingc/android-build-box:latest

pipelines:
  default:
    - step:
        caches:
          - gradle
        script:
          - chmod +x gradlew
          - ./gradlew assemble

It include following components:

  • Ubuntu 17.10
  • Android SDK 16 17 18 19 20 21 22 23 24 25 26 27 28
  • Android build tools 17.0.0 18.1.1 19.1.0 20.0.0 21.1.2 22.0.1 23.0.1 23.0.2 23.0.3 24.0.0 24.0.1 24.0.2 24.0.3 25.0.0 25.0.1 25.0.2 25.0.3 26.0.0 26.0.1 26.0.2 27.0.1 27.0.2 27.0.3 28.0.1 28.0.2 28.0.3
  • Android NDK r18b
  • extra-android-m2repository
  • extra-google-m2repository
  • extra-google-google_play_services
  • Google API add-ons
  • Android Emulator
  • Constraint Layout
  • TestNG
  • Python 2, Python 3
  • Node.js, npm, React Native
  • Ruby, RubyGems
  • fastlane
  • Kotlin 1.3

You can also use this docker image to build your Android project with a single docker run command:

cd <android project directory>  # change working directory to your project root directory.
docker run --rm -v `pwd`:/project mingc/android-build-box bash -c 'cd /project; ./gradlew build'

Your command docker run -i -v $PWD:/project -t uber/android-build-environment /bin/bash /project/ci/build.sh assumes the file /project/ci/build.sh is on the container. Are you sure you're running this docker command from the directory that contains it?

If you're not sure I would try the (from your project directory)

docker run -it -v $PWD:/project uber/android-build-environment /bin/bash

and then check the results of ls -a /project when you get logged into the container.

Another thing to make sure of is that build.sh is allowed to be executed, make sure of this by running chmod +x build.sh on it.

You can use this guide:

https://github.com/danylovolokh/Setup-Free-Bitbucket-Cloud-CI

It is quite exhaustive, it shows how to:

  1. Update build number, build version name etc...
  2. Update build.gradle
  3. Commit and push changes to the repository
  4. Collect a changelog
  5. Build the application

Additional steps:

  1. Sign the application with the "release" signing key.
  2. Upload the apk files to the storage for future usage.
  3. Upload a version to the Fabric Beta for testing purposes.
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!