从零搞定 Android.mk：把你的 Android Studio 项目编译成系统固件（附踩坑记录）

从零搞定 Android.mk：把你的 Android Studio 项目编译成系统固件（附踩坑记录）

目录

• 一、背景：为什么要写 MK 文件？
• 二、Android 编译系统简介
• 三、Android.mk 核心语法
  • 3.1 一个最简 APK 的 mk
  • 3.2 常用变量速查
  • 3.3 编译 Java 库（共享 & 静态）
• 四、从 Android Studio 项目提取 MK 的完整流程
• 五、编译 SO 库的 MK 写法
• 六、实战：把一个真实项目编进系统
  • 6.1 项目结构
  • 6.2 Android.mk 完整写法
  • 6.3 编进去了但闪退？常见问题排查
• 七、Android.bp 写法（Android 8.0+ 推荐）
• 八、真实踩坑记录
• 九、总结与速查

一、背景：为什么要写 MK 文件？

平时用 Android Studio 开发，Gradle 帮我们搞定了所有编译的事。但很多时候你面对的不是标准 Android 项目：

• 做系统开发（ROM 定制），需要把 App 直接编译进系统镜像
• 维护 AOSP 源码，你的模块要和系统其他模块一起编
• 写 HAL 层或者 Native 服务，只能用 ndk-build
• 公司有自己的编译平台，不认 Gradle，只认 Android.mk

这时候你就得自己写 MK 文件了。说白了，Android.mk 就是告诉编译系统：我这个模块叫啥、依赖了哪些库、源码在哪、编出来是个 APK 还是 SO 还是 JAR。

二、Android 编译系统简介

Android 源码的编译系统经历了三代演变：

三者关系图：

#mermaid-svg-UIjS27gmb2CExzSY{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-UIjS27gmb2CExzSY .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-UIjS27gmb2CExzSY .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-UIjS27gmb2CExzSY .error-icon{fill:#552222;}#mermaid-svg-UIjS27gmb2CExzSY .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-UIjS27gmb2CExzSY .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-UIjS27gmb2CExzSY .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-UIjS27gmb2CExzSY .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-UIjS27gmb2CExzSY .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-UIjS27gmb2CExzSY .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-UIjS27gmb2CExzSY .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-UIjS27gmb2CExzSY .marker{fill:#333333;stroke:#333333;}#mermaid-svg-UIjS27gmb2CExzSY .marker.cross{stroke:#333333;}#mermaid-svg-UIjS27gmb2CExzSY svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-UIjS27gmb2CExzSY p{margin:0;}#mermaid-svg-UIjS27gmb2CExzSY .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-UIjS27gmb2CExzSY .cluster-label text{fill:#333;}#mermaid-svg-UIjS27gmb2CExzSY .cluster-label span{color:#333;}#mermaid-svg-UIjS27gmb2CExzSY .cluster-label span p{background-color:transparent;}#mermaid-svg-UIjS27gmb2CExzSY .label text,#mermaid-svg-UIjS27gmb2CExzSY span{fill:#333;color:#333;}#mermaid-svg-UIjS27gmb2CExzSY .node rect,#mermaid-svg-UIjS27gmb2CExzSY .node circle,#mermaid-svg-UIjS27gmb2CExzSY .node ellipse,#mermaid-svg-UIjS27gmb2CExzSY .node polygon,#mermaid-svg-UIjS27gmb2CExzSY .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-UIjS27gmb2CExzSY .rough-node .label text,#mermaid-svg-UIjS27gmb2CExzSY .node .label text,#mermaid-svg-UIjS27gmb2CExzSY .image-shape .label,#mermaid-svg-UIjS27gmb2CExzSY .icon-shape .label{text-anchor:middle;}#mermaid-svg-UIjS27gmb2CExzSY .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-UIjS27gmb2CExzSY .rough-node .label,#mermaid-svg-UIjS27gmb2CExzSY .node .label,#mermaid-svg-UIjS27gmb2CExzSY .image-shape .label,#mermaid-svg-UIjS27gmb2CExzSY .icon-shape .label{text-align:center;}#mermaid-svg-UIjS27gmb2CExzSY .node.clickable{cursor:pointer;}#mermaid-svg-UIjS27gmb2CExzSY .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-UIjS27gmb2CExzSY .arrowheadPath{fill:#333333;}#mermaid-svg-UIjS27gmb2CExzSY .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-UIjS27gmb2CExzSY .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-UIjS27gmb2CExzSY .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-UIjS27gmb2CExzSY .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-UIjS27gmb2CExzSY .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-UIjS27gmb2CExzSY .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-UIjS27gmb2CExzSY .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-UIjS27gmb2CExzSY .cluster text{fill:#333;}#mermaid-svg-UIjS27gmb2CExzSY .cluster span{color:#333;}#mermaid-svg-UIjS27gmb2CExzSY div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-UIjS27gmb2CExzSY .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-UIjS27gmb2CExzSY rect.text{fill:none;stroke-width:0;}#mermaid-svg-UIjS27gmb2CExzSY .icon-shape,#mermaid-svg-UIjS27gmb2CExzSY .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-UIjS27gmb2CExzSY .icon-shape p,#mermaid-svg-UIjS27gmb2CExzSY .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-UIjS27gmb2CExzSY .icon-shape .label rect,#mermaid-svg-UIjS27gmb2CExzSY .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-UIjS27gmb2CExzSY .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-UIjS27gmb2CExzSY .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-UIjS27gmb2CExzSY :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

kati 转换

Soong 转换

blueprint 插件

ninja 执行

Android.mk

.ninja 文件