Docker搭建安卓工程编译环境
一、前言
作为开发者,除了日常可以轻松通过Android Studio编译我们的安卓源码项目外,有时候我们也需要额外搭建一个编译环境,比如一个一键编译平台,提供给除了开发人员以外的人员使用。
- 为什么要使用Docker?
因为Docker可以轻松虚拟出一台Linux(Ubuntu、CentOS等)且不用担心损坏;创建和备份数据都相对容易,失败了也可以很轻松的重来,可以说是一个非常完美的学习软件。
二、需要具备哪些知识
- Docker相关知识,需要能够实现基本操作;
- Linux 命令行相关知识,比如cp、mv、vim等;
- Git相关知识,熟悉基础操作;
- 安卓编译-出现问题-解决问题相关经验,这就靠平时的积累了,因为什么情况都可能遇见;
三、准备工作
1、在你的设备上安装Docker,比如在我的Windows 10专业版本上,MAC也可,Linux更佳;
2、一个在git平台托管的且可以正常编译的安卓工程;确保在你的设备上能够正常拉取代码,并且找到你的SSH key(Windows在C:\Users\Administrator.ssh目录下的3个文件)
sshkey.png
四、开始搭建
1、拉取镜像&运行虚拟机(本地计算机操作)
开启命令行终端执行如下docker命令:
//拉取镜像,可能需要花费较长时间
docker pull mobiledevops/android-sdk-image:30.0.3
//启动目标镜像
docker run -it -u root -v C:\Users\Administrator\.ssh:/gitkey --name="appbuilder" mobiledevops/android-sdk-image /bin/bash
//docker exec -it -u root appbuilder bash
- 这边拉取的是包含SDK编译版本(30.0.3) 的镜像,具体版本号需要根据你的需求和Docker hub能够提供的版本确定(版本号见: Github--MobileDevOps/android-sdk-image/tags)
-
-u root
使用root账户登录Linux系统虚拟机 -
-v C:\Users\Administrator\.ssh:/gitkey
是将我的电脑的sshkey目录挂载到虚拟机/gitkey
目录下, 后面git拉取代码需要用到,也可以不加,取决于你的git代码拉取校验规则。
2、git准备&拉取代码(虚拟机上操作)
- 生成本地的秘钥(执行命令后回车3次)
ssh-keygen -t rsa -b 4096
- 覆盖我的私人秘钥(为了拉取git代码--非强制)
cp /gitkey/* /root/.ssh
此部分是为了跟我电脑上的秘钥一致(/gitkey/目录是挂着我电脑的秘钥目录), 以便能够成功通过git服务器校验拉取代码, 具体需要根据实际情况变更。
- 拉取代码
git clone -b dev_3.0 git@gitlab.***.com:xxx-android/aicamera.git
cd aicamera
git fetch origin dev_3.0
如下两个参数需要根据你实际情况替换:
dev_3.0
是代码的分支
git@gitlab.***.com:xxx-android/aicamera.git
是代码拉取路径
代码拉取成功后继续>>>>
3、检查java版本(虚拟机上操作)
按需安装特定版本,比如我需要jdk11,所以需要卸载默认的jdk17,不然编译报错。
//输出java版本,默认是jdk17的
java -version
//更新下apt
apt-get update
//列出系统安装的jdk版本
apt list --installed | grep jdk
//卸载jdk17
apt remove openjdk-17-jdk -y
apt remove openjdk-17-jre-headless -y
apt autoremove
//安装jdk11
apt install openjdk-11-jdk -y
//检查版本
java -version
4、编译工程(虚拟机上操作)
./gradlew clean assembleRelease
如果编译成功则会有类似输出:
.....
BUILD SUCCESSFUL in 3m 49s
77 actionable tasks: 74 executed, 3 up-to-date
五、遇到的问题及解决方案
1、gradle下载失败
编译错误并有类似输出:
Exception in thread "main" java.io.IOException: Downloading from https://services.gradle.org/distributions/gradle-6.7.1-bin.zip failed: timeout
出现此问题是因为无法访问https://services.gradle.org/distributions/gradle-6.7.1-bin.zip
导致的,可以检查网络或者自己搭建一个http服务,提供gradle-6.7.1-bin.zip
的下载服务。
搭建一个简易http服务操作如下:
//安装vim
apt-get update
apt install vim -y
//编辑gradle脚本
vim gradle/wrapper/gradle-wrapper.properties
将配置文件(gradle-wrapper.properties)中https://services.gradle.org/distributions/gradle-6.7.1-bin.zip
替换为我本地的http服务http\://172.29.112.1:8890/gradle-6.7.1-bin.zip
搭建http服务则是使用sfk, 在自己的Windows电脑上操作的, 前提是自己提前下载好了gradle-6.7.1-bin.zip(其他版本类似)
在文件相同目录执行命令如下:
sfk httpserv -port=8890
http服务.png
这样就能下载访问了
2、编译异常中断,源代码项目工程确认没有问题,都是一些jdk包的异常堆栈输出
检查虚拟机的内存大小,可能是内存不足导致Daemon进程中断。
确保RAM有7G,多个CPU核心
这是我出现问题后的设置,可以编译成功
docker设置.png