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


如果本文对你有帮助就点个赞支持下吧~~~
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容