Android编译环境构建（二）（可用于物理机、虚拟机、容器化Jenkins环境）

admin_2332024-11-02 18:57

文章目录

说明：
物理环境：物理机、虚拟机等
容器化环境：docker等

需求

bash 复制代码 
Gradle Version:7.5 # 必需项，用于开源构建自动化工具
cmdline-tools # 必需项，SDK 管理器，用于下载SDK、Build-Tools
Android SDK 35 # 必需项，Software Development Kit，软件开发工具包
Build-Tools 35 # 必需项，Android项目构建工具
platform-tools # 必需项，SDK 平台工具
ndkVersion:21.4.7075529 # 非必需项，Native Development Kit，本地开发工具包
apache-maven-3.9.9 # 非必需项，此次为Android编译环境构建

环境要求

JDK17：由于新版SDK只能够使用cmdline-tools下载，而官网提供最版的cmdline-tools又需要JDK17的环境
这里默认已经准备好了JDK17环境

文件下载

Gradle Version:7.5

可参考：https://developer.aliyun.com/article/1377971

所有版本下载地址：https://gradle.org/releases/

  1. 下载

  • 下载方法一（推荐）：

    Windows内下载完后上传到Linux服务器中，以7.5版本为例

    打开下载地址后，找到你需要的版本，点击对应版本中Download: binary-only or complete (checksums)中的"complete"，即可开始下载

    若Linux服务器中没有解压程序，建议在Windows中解压出来后再将整个文件夹上传至Linux服务器指定的目录中

  • 下载方法二：

    Linux内下载并解压

    将下载方法一中的下载地址复制粘贴

    注意：需要已安装unzip，否则无法解压

bash 复制代码 
# 使用curl下载
curl -o /tmp/ https://github.com/gradle/gradle-distributions/releases/download/v7.5.0/gradle-7.5-all.zip
# 使用wegt下载
wget -P /tmp/gradle-7.5-all.zip https://github.com/gradle/gradle-distributions/releases/download/v7.5.0/gradle-7.5-all.zip

#将下载好的压缩包解压至 /opt/ 目录中
unzip /tmp/gradle-7.5-all.zip -d /opt/
  1. 准备文件
    我这边已将Gradle-7.5文件夹上传到了Linux服务器中的 /opt/ 目录下
  • 对于容器化环境部署的Jenkins，需要多执行一步，物理环境则不需要执行该步骤
    将gradle-7.5从Linux服务器中，复制粘贴到容器中
bash 复制代码 
# docker cp Gradle目录路径 Jenkins所在容器名称(或ID):容器内存放Gradle的目录路径
docker cp /opt/gradle-7.5/ jenkins_new:/opt/

Gradle-7.5目录构成如下：

bash 复制代码 
root@bdf796726e0a:/# ls -l /opt/gradle-7.5/
total 60
-rw-r--r--  1 root root 23606 Jan 31  1980 LICENSE
-rw-r--r--  1 root root   868 Jan 31  1980 NOTICE
-rw-r--r--  1 root root   976 Jan 31  1980 README
drwxr-xr-x  2 root root  4096 Jan 31  1980 bin
drwxr-xr-x  5 root root  4096 Jan 31  1980 docs
drwxr-xr-x  2 root root  4096 Jan 31  1980 init.d
drwxr-xr-x  3 root root 12288 Jan 31  1980 lib
drwxr-xr-x 93 root root  4096 Jan 31  1980 src
  1. 配置环境变量，物理环境执行，容器化环境无需执行
bash 复制代码 
vi /etc/profile

# 在文件末尾添加
export GRADLE_HOME=/opt/gradle-7.5
export PATH=$GRADLE_HOME/bin:$PATH

# 刷新环境变量
source /etc/profile

# 测试是否安装成功，有版本输出则为成功
gradle -v

cmdline-tools

sdkmanager

打开网页后，在最下方找到仅限命令行工具，点击下载Linux版的

下载页面：https://developer.android.com/studio?hl=zh-cn

使用文档页面：https://developer.android.com/tools/sdkmanager?hl=zh-cn

若下方命令下载失败，可进入platform-tools下载页面单独下载platform-tools：

https://developer.android.com/tools/releases/platform-tools?hl=zh-cn#downloads.html

  1. 目录准备
bash 复制代码 
# Linux 服务器新建android-sdk目录
mkdir -P /opt/android-sdk

在Windows中解压出来后再将整个cmdline-tools文件夹上传至Linux服务器的 /opt/android-sdk/ 目录中

# 在Linux服务的cmdline-tools目录中新建latest目录，并将目录内容移动到新建的latest目录中
mkdir -P /opt/android-sdk/cmdline-tools/latest # 创建latest目录
cd /opt/android-sdk/cmdline-tools/ # 进入cmdline-tools目录
mv bin/ lib/ NOTICE.txt source.properties -t latest/ # 将原始 cmdline-tools 目录内容（包括 lib 目录、bin 目录、NOTICE.txt 文件和 source.properties 文件）移动到新创建的 latest 目录中
  1. 下载程序
bash 复制代码 
# 查询可用sdk build-tools等工具列表，--channel=0 代表Stable 稳定版
/opt/android-sdk/cmdline-tools/latest/bin/sdkmanager  --list --channel=0

# 下载Android SDK 35 Build-Tools 35
/opt/android-sdk/cmdline-tools/latest/bin/sdkmanager --sdk_root=/opt/android-sdk "platform-tools" "platforms;android-35" "build-tools;35.0.0" "ndk;21.4.7075529"

# 核对文件，下载完成后应该会有以下目录
ls -l /opt/android-sdk/
total 32
drwxr-xr-x 4 root root 4096 Oct 29 09:59 build-tools
drwxr-xr-x 3 root root 4096 Oct 28 06:52 cmdline-tools
drwxr-xr-x 8 root root 4096 Oct 29 09:59 emulator
drwxr-xr-x 2 root root 4096 Oct 28 07:46 licenses
drwxr-xr-x 3 root root 4096 Oct 28 07:49 ndk
drwxr-xr-x 3 root root 4096 Oct 28 08:03 platform-tools
drwxr-xr-x 5 root root 4096 Oct 29 10:00 platforms
drwxr-xr-x 6 root root 4096 Oct 29 09:59 tools
  1. 配置环境变量，物理环境执行，容器化环境无需执行
bash 复制代码 
vi /etc/profile

# 在文件末尾添加
export ANDROID_HOME=/opt/android-sdk
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export NDK=/opt/android/ndk/21.4.7075529/
export PATH=${PATH}:$NDK

# 刷新环境变量
source /etc/profile

# 测试是否安装成功，有版本输出则为成功
adb --version

至此普通物理环境的Android编译环境已部署完毕

4 拷贝程序到容器中，物理环境无需执行，容器化环境执行

将android-sdk从Linux服务器中，复制粘贴到容器中

bash 复制代码 
# docker cp android-sdk目录路径 Jenkins所在容器名称(或ID):容器内存放android-sdk的目录路径
docker cp /opt/android-sdk/ jenkins_new:/opt/

部署maven(可选)

  1. 下载

    官网地址：https://maven.apache.org/download.cgi

    下载 apache-maven-3.9.9-bin.zip

    按照上面安装gradle的方法，将压缩包上传到Linux服务器 /opt/ 目录中

  2. 配置环境变量，物理环境执行，容器化环境无需执行

bash 复制代码 
vi /etc/profile

# 在文件末尾添加
export M2_HOME=/opt/apache-maven-3.9.9
export PATH=$PATH:$M2_HOME/bin

# 刷新环境变量
source /etc/profile

# 测试是否安装成功，有版本输出则为成功
mvn -version
  1. 拷贝程序到容器中，物理环境无需执行，容器化环境执行
    将apache-maven-3.9.9从Linux服务器中，复制粘贴到容器中
bash 复制代码 
# docker cp maven目录路径 Jenkins所在容器名称(或ID):容器内存放maven的目录路径
docker cp /opt/apache-maven-3.9.9/ jenkins_new:/opt/

Jenkins配置Android构建环境

  1. 配置JDK
    路径：系统管理 > 全局工具配置 > JDK 安装
    配置完成后，点击保存
    配置如图：
  2. 配置Gradle
    路径：系统管理 > 全局工具配置 > Gradle 安装
    配置完成后，点击保存
    配置如图：
  3. 配置android SDK、NDK
    路径：系统管理 > System > 全局属性
    勾选环境变量，配置完成后，点击保存
    配置如图：
  4. 配置Maven(可选)
    路径：系统管理 > 全局工具配置 > Maven 安装
    配置完成后，点击保存
相关推荐
梦想很大很大16 小时前
拒绝“盲猜式”调优：在 Go Gin 项目中落地 OpenTelemetry 链路追踪
运维·后端·go
Sinclair17 小时前
内网服务器离线安装 Nginx+PHP+MySQL 的方法
运维
叶落阁主17 小时前
Tailscale 完全指南：从入门到私有 DERP 部署
运维·安全·远程工作
雨白18 小时前
Android 快捷方式实战指南：静态、动态与固定快捷方式详解
android
hqk18 小时前
鸿蒙项目实战：手把手带你实现 WanAndroid 布局与交互
android·前端·harmonyos
LING18 小时前
RN容器启动优化实践
android·react native
恋猫de小郭21 小时前
Flutter 发布官方 Skills ，Flutter 在 AI 领域再添一助力
android·前端·flutter
Kapaseker1 天前
一杯美式搞懂 Any、Unit、Nothing
android·kotlin
黄林晴1 天前
你的 Android App 还没接 AI？Gemini API 接入全攻略
android
恋猫de小郭1 天前
2026 Flutter VS React Native ，同时在 AI 时代 VS Native 开发，你没见过的版本
android·前端·flutter
热门推荐
01GitHub 镜像站点02OpenClaw 使用和管理 MCP 完全指南03OpenClaw + 飞书（Feishu）环境搭建指南04OpenClaw优化飞书API 额度已耗尽问题05本地部署 OpenClaw + DeepSeek-R1 完全指南06Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services07Window 10部署openclaw报错node.exe : npm error code 12808小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）09OpenClaw大龙虾机器人完整安装教程10让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南