dockcross/android-arm

dockcross/android-arm 镜像文档

概述

dockcross/android-arm 是一个提供Android NDK独立工具链的Docker镜像，专为arm架构设计。该镜像预配置了完整的Android NDK环境，旨在简化跨平台编译流程，帮助开发者无需手动配置NDK即可为Android arm设备编译原生代码（C/C++）。

核心功能与特性

• 预配置Android NDK环境：内置指定版本的Android NDK独立工具链，无需手动安装和配置
• 专注arm架构：针对armv7、arm64等arm架构优化，支持主流Android设备
• 独立工具链：工具链独立于系统环境，避免版本冲突，便于集成到自动化构建流程
• 轻量级设计：基于精简基础镜像，减少资源占用，加快启动速度

使用场景

• Android应用开发者需要编译C/C++原生代码（如使用JNI）并面向arm架构设备
• CI/CD流程中集成Android原生代码的自动化编译环节
• 跨平台项目需要统一编译环境，确保不同开发/构建机器上的编译一致性
• 快速搭建临时Android NDK开发环境，避免本地环境配置繁琐

使用方法

基本使用命令

通过以下命令启动容器并使用工具链：

bash
docker run --rm -v $(pwd):/work dockcross/android-arm sh -c "cd /work && <编译命令>"

• --rm：容器退出后自动删除
• -v $(pwd):/work：将当前目录挂载到容器内的/work目录（工作目录）
• sh -c "<编译命令>"：在容器内执行编译命令（如make、cmake等）

示例：编译C文件

1. 创建项目目录并编写C代码（如hello.c）
2. 执行编译命令：

bash
docker run --rm -v $(pwd):/work dockcross/android-arm sh -c "arm-linux-androideabi-gcc /work/hello.c -o /work/hello_arm"

3. 编译产物hello_arm将生成在当前目录

环境变量配置

可通过环境变量调整工具链行为，常用变量：

• ANDROID_NDK_VERSION：指定NDK版本（需镜像支持）
• CC/CXX：覆盖默认C/C++编译器路径
• CFLAGS/CXXFLAGS：添加额外编译参数（如-O2优化）

集成到构建系统

可将工具链路径添加到构建系统配置，例如CMake：

bash
docker run --rm -v $(pwd):/work dockcross/android-arm sh -c "cmake -DCMAKE_TOOLCHAIN_FILE=/usr/local/toolchain/arm-linux-androideabi.cmake /work && make"

注意事项

• 确保挂载目录权限正确，避免容器内无法读写文件
• 不同NDK版本可能对应不同工具链路径，具体以镜像内实际路径为准
• 如需支持64位arm架构（arm64），可使用dockcross/android-arm64镜像