行业资讯
MacOS编译Android源码环境搭建与实战指南
1. 准备工作MacOS编译Android源码的环境搭建在MacOS上编译Android源码需要做好充分的准备工作这包括硬件配置、软件环境和系统设置三个方面。我曾在2019年第一次尝试在MacBook Pro上编译Android 9.0当时因为准备工作不充分导致整个编译过程反复失败浪费了整整一周时间。下面我会分享经过多次实践验证的可靠方案。1.1 硬件配置要求编译Android源码对硬件要求较高特别是存储空间和内存容量。根据我的经验存储空间至少需要200GB可用空间。Android 11.0完整编译后占用约150GB加上中间文件和源码200GB是底线。建议准备250GB以上空间。内存16GB是基本要求32GB更为理想。编译过程中会生成大量临时文件内存不足会导致编译失败。处理器建议使用Intel Core i7或更高性能的处理器。M1/M2芯片的Mac虽然性能强劲但由于架构差异可能会遇到兼容性问题。提示我曾经尝试在128GB存储空间的Mac mini上编译结果在编译到70%时因空间不足失败不得不从头开始。建议使用外接SSD或者清理出足够空间再开始。1.2 软件环境准备Android源码编译需要特定的软件环境以下是必须安装的组件Xcode命令行工具xcode-select --install这是编译基础工具链的必备组件。安装完成后验证版本xcode-select -vHomebrew MacOS的包管理器用于安装其他依赖/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)编译依赖库brew install gmake libsdl git gnupgJava开发环境 Android 11.0需要Java 8brew install --cask adoptopenjdk/openjdk/adoptopenjdk81.3 系统参数调整MacOS默认的系统参数限制会影响编译过程需要进行以下调整增加文件描述符限制 在~/.zshrc或~/.bash_profile中添加ulimit -S -n 2048然后执行source ~/.zshrc创建区分大小写的APFS宗卷打开磁盘工具选择主容器 - 点击添加宗卷格式选择APFS区分大小写大小建议设置为200GB以上命名为android便于识别这个宗卷将专门用于存放Android源码和编译输出避免大小写问题导致的编译错误。2. 获取Android源码获取Android源码有两种主要方式从Google官方源下载或使用国内镜像源。由于网络原因国内开发者通常更倾向于使用镜像源。下面我会详细介绍两种方式的具体操作步骤。2.1 初始化Repo工具Repo是Google开发的用于管理Android源码的工具首先需要安装mkdir ~/bin curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo ~/bin/repo chmod ax ~/bin/repo将repo添加到PATH环境变量中echo export PATH$PATH:~/bin ~/.zshrc source ~/.zshrc2.2 从清华镜像源同步代码进入之前创建的区分大小写的宗卷cd /Volumes/android初始化仓库export REPO_URLhttps://mirrors.tuna.tsinghua.edu.cn/git/git-repo/ repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-11.0.0_r1同步代码repo sync -j4这里的-j4表示使用4个线程同步可以根据网络情况调整。注意同步过程可能需要数小时取决于网络速度。我曾遇到同步中断的情况可以使用以下命令恢复repo sync -j4 --fail-fast2.3 处理同步过程中的常见问题网络中断导致同步失败 可以创建自动重试脚本sync.sh#!/bin/bash while [ $? -ne 0 ]; do repo sync -j4 done然后执行chmod x sync.sh ./sync.sh磁盘空间不足 定期检查磁盘空间df -h /Volumes/android如果空间紧张可以只同步当前分支repo sync -c -j4文件权限问题 如果遇到权限错误可以尝试repo forall -c git reset --hard3. 编译Android源码源码同步完成后就可以开始编译了。这一阶段会遇到各种问题下面我会结合自己的踩坑经验详细介绍完整的编译过程和解决方案。3.1 初始化编译环境进入源码目录cd /Volumes/android/aosp加载编译环境source build/envsetup.sh选择目标设备lunch会显示可选设备列表对于模拟器通常选择aosp_x86_64-eng对应数字47lunch 473.2 开始编译使用make命令开始编译make -j8-j8表示使用8个线程编译一般设置为CPU核心数的1-1.5倍。3.3 解决常见编译错误Mac SDK版本不匹配 错误信息Could not find a supported mac sdk解决方案查看支持的SDK版本cat build/soong/cc/config/x86_darwin_host.go | grep darwinSupportedSdkVersions下载对应版本的MacOS SDK放到/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs文件描述符不足 错误信息too many open files解决方案临时提高限制ulimit -n 8192永久修改 在/etc/sysctl.conf中添加kern.maxfiles65536 kern.maxfilesperproc65536然后重启系统。Java版本问题 确保使用的是Java 8export JAVA_HOME$(/usr/libexec/java_home -v 1.8)3.4 编译完成后的操作编译成功后会在out/target/product/generic_x86_64/目录下生成系统镜像文件system.img系统镜像ramdisk.imgramdisk镜像userdata.img用户数据镜像可以启动模拟器测试emulator4. 在Android Studio中导入源码为了方便阅读和修改源码可以将其导入Android Studio。这个过程需要一些特殊配置。4.1 生成IDE工程文件在源码根目录执行source build/envsetup.sh mmma development/tools/idegen development/tools/idegen/idegen.sh这会生成android.ipr和android.iml文件。修改android.iml文件排除不常用的模块excludeFolder urlfile://$MODULE_DIR$/bionic / excludeFolder urlfile://$MODULE_DIR$/bootable / !-- 添加其他不需要的模块 --4.2 配置Android Studio增加内存设置Help Edit Custom VM Options添加-Xms2g -Xmx8g修改文件大小限制Help Edit Custom Properties添加idea.max.intellisense.filesize100000 idea.case.sensitive.fstrue配置JDK创建新的JDK配置命名为1.8 (No Libraries)删除Classpath中的所有jar文件4.3 导入和索引打开android.ipr文件等待索引完成可能需要数小时配置完成后就可以享受代码跳转、查找引用等IDE功能了提示首次索引会非常耗时建议在夜间进行。我曾遇到索引卡住的情况解决方案是删除.idea目录重新导入。5. 刷机与测试编译完成的系统可以通过模拟器或真机进行测试。5.1 使用模拟器测试启动模拟器source build/envsetup.sh lunch 47 emulator查看日志adb logcat5.2 刷入真机如果要在Google Pixel等支持的真机上测试解锁bootloaderadb reboot bootloader fastboot flashing unlock刷入系统fastboot flashall -w重新锁定bootloader可选fastboot flashing lock警告刷机会清除设备上的所有数据请提前备份。我曾因为忘记备份而丢失了重要数据。6. 高级技巧与优化经过多次编译实践我总结出一些提高效率的技巧增量编译 修改代码后只需重新编译受影响的部分mmm path/to/module使用ccache加速 在~/.bashrc中添加export USE_CCACHE1 export CCACHE_DIR/Volumes/android/.ccache ccache -M 50G然后初始化ccacheprebuilts/misc/darwin-x86/ccache/ccache -M 50G并行编译 观察CPU使用情况调整编译线程数make -j$(nproc)清理编译结果 需要完全重新编译时make clobber选择性编译 只编译特定模块make framework在MacOS上编译Android源码虽然挑战重重但掌握正确的方法后整个过程会变得可控且高效。最重要的是保持耐心遇到问题时仔细阅读错误日志通常都能找到解决方案。
郑州网站建设
网页设计
企业官网
