• 移动开发
• 教程

本文以开源仓库 android-developer-roadmap 的日文版文档 README_JP.md 为核心骨架，系统讲解该路线图的设计理念、知识节点组织方式、配套系列文章的学习脉络，并结合仓库中的 Jetpack Compose 源码（MainActivity.kt 等）说明如何在 Android 应用中交互式查看这张路线图。读完本文，你将掌握 Android 开发生态的整体知识地图，了解如何按中央路径循序渐进地学习，并能够复现本仓库"一张图看懂 Android 开发生态"的应用实现。

路线图的定位与核心理念

Android Developer Roadmap 2022 是一份面向 Android 开发者的学习路径指南，它的核心目标不是罗列零散知识点，而是为初学者和进阶开发者提供一条可顺序推进的学习主线。正如 README_JP.md 中所说：沿路线图中央的路径（パス）行走，就能按顺序理解 Android 开发相关的各项概念。

这份路线图有三个值得注意的设计原则：

1. 节点即概念：路线图中的每个节点（ノード）都对应一个具体的概念，涵盖 Android 系统（Androidシステム）、Android SDK 以及业界常用的第三方库（一般的に使用されるライブラリ）。具体术语可查阅 Android Developers Reference 或 GitHub 上的相关资料。
2. 不必全学：文档明确强调"无需从这张路线图学完所有内容"，建议只阅读对自己有帮助的部分。这一点对开发者非常重要——路线图是知识地图而非强制清单，学习深度与顺序完全由个人目标决定。
3. 生态全景视角：路线图的设计目的是帮助学习者"综合性地理解当前的 Android 生态"，理解整个 Android 社区的全貌，以及开发者如何在此基础上持续进阶。

路线图的视觉呈现：单张长图承载完整知识地图

路线图以单张大幅图片呈现，覆盖从入门到进阶的完整知识体系，原文档以<picture>标签同时提供了亮色与深色两套版本：

• 亮色版本：android_developer_roadmap.png
• 深色版本：android_developer_roadmap_dark.png

深色版本通过prefers-color-scheme: dark媒体查询自动切换，确保在夜间浏览环境下依然有良好的可读性。而应用内则提供了一张比例适中的预览图 roadmap_preview.png，作为 App 启动时呈现路线图缩略内容的素材。

由于完整路线图为超长竖图（尺寸约 2215x15388），仓库刻意不把它作为普通插图平铺展示，而是通过专用应用以可缩放的方式呈现，这一点会在下文"源码实现"部分详细展开。

知识节点的领域划分：五大部分串起 Android 生态

虽然 README 只以一张图呈现全部节点，但配合仓库配套的系列文章（詳しい記事シリーズ），可以清晰地看到整张路线图按知识领域被划分为五大部分。这五部分既是系列文章的章节，也对应了路线图中央路径的主要区段：

从这张表可以推断，路线图节点并非随机排布，而是遵循"平台基础 → 应用组件 → 框架与导航 → 架构设计 → 现代 UI 体系"的递进关系。每个节点作为独立概念出现在图上，而系列文章则负责把同一领域的节点串联成完整的知识链条。

配套系列文章：把路线图"读"出来

路线图本身是知识地图，而仓库文档建议的完整学习方式是配合系列文章逐篇研读。README_JP.md 中列出的系列文章（Part 1 至 Part 5）按上述五个领域组织，形成了一条从底层平台到现代 UI 的完整学习路径。

文档同时建议：如果希望在未来文章发布时获得通知，可以关注仓库的 watchers 列表或作者账号。对于自学者而言，这套"路线图 + 系列文章"的组合意味着：先通过地图建立全局认知，再通过文章深入每个领域的具体实现，是最有效率的学习方式。

在 Android 应用中交互式查看路线图：源码实现解析

除了 README 本身，仓库还附带了一个完整的 Android 应用（app模块），用于在手机上以可缩放的方式浏览路线图。这一点与 README 中的路线图图片直接呼应——长图只有配合缩放交互才能获得良好的移动端体验。

入口 Activity：单屏展示路线图

核心实现位于 MainActivity.kt。应用采用 Jetpack Compose 声明式 UI，入口MainActivity继承ComponentActivity，通过setContent挂载 UI：

setContent { AndroidDeveloperRoadmapTheme { Surface(color = MaterialTheme.colors.background) { AndroidRoadmap() } } } @Composable private fun AndroidRoadmap() { ZoomableAsyncImage( modifier = Modifier.fillMaxSize(), model = "https://user-images.githubusercontent.com/24237865/144350753-...png", contentDescription = null ) }

关键点在于：

• ZoomableAsyncImage来自me.saket.telephoto库（zoomable-image-coil:0.8.0），它同时承担了异步加载（基于 Coil）与手势缩放（双指捏合、平移）两项职责，使超长路线图可以在手机屏幕上自由查看细节。这正是 README 中"路线图图片"能够在移动端落地的实现基础。
• modifier = Modifier.fillMaxSize()让图片填满整个屏幕。
• 图片通过 URL 远程加载，因此在 AndroidManifest.xml 中声明了android.permission.INTERNET权限；MainActivity同时被声明为 LAUNCHER 启动入口。
• 同文件还包含一个@Preview预览函数，便于开发者在 Android Studio 中直接预览 UI。

主题与深色模式支持

UI 主题定义在 ui/theme 目录下：

• Theme.kt 通过isSystemInDarkTheme()自动跟随系统深色模式，分别使用darkColors与lightColors构造MaterialTheme——这与 README 中路线图图片"深色/亮色双版本"的设计思路一致。
• Color.kt 定义了 Material 风格配色（Purple200/Purple500/Purple700/Teal200）以及background800、shimmerHighLight等占位图相关颜色。
• Type.kt 定义了默认字体排版（body1为 16sp 常规字重）。
• themes.xml 在 XML 侧指定了android:statusBarColor为purple_700，与 Compose 主题配色保持一致。

构建配置速览

应用构建配置（app/build.gradle）体现了项目使用的技术栈：

• minSdk 23、targetSdk 34、compileSdk 34，Java/Kotlin 均使用 17 版本；
• buildFeatures { compose true }，Compose 编译器扩展版本与 Kotlin 版本在根 build.gradle 中统一定义（Kotlin 1.9.22、Compose 1.6.1、activity-compose 1.7.2）；
• 图片加载依赖com.github.skydoves:landscapist-coil与landscapist-placeholder，缩放交互依赖me.saket.telephoto:zoomable-image-coil:0.8.0；
• 仓库根目录还配置了 Spotless（ktlint）代码风格检查，统一使用 2 空格缩进，并以 spotless.license.kt 作为版权头模板。

如需在本机运行该应用，可按标准 Android 流程操作：使用 Android Studio 打开仓库根目录，等待 Gradle 同步（Gradle Wrapper 版本为 8.3，见 gradle-wrapper.properties），随后直接运行app模块即可。

从 Android 延伸：Kotlin Multiplatform Developer Roadmap

README 的姊妹项目 Kotlin Multiplatform Developer Roadmap（KMP Developer Roadmap）旨在帮助开发者理解当前的 KMP 生态，同样以"建议学习路径"的方式组织知识。配套内容涵盖：

• 一份完整的 KMP 生态学习路线图仓库；
• 一篇以 KMP Roadmap 为导航工具探索 Kotlin Multiplatform 生态的入门文章；
• 一篇手把手构建第一个 Android + iOS 双端 Kotlin Multiplatform / Compose Multiplatform 应用的实战教程。

这说明作者的路线图方法论是一脉相承的：先给全景地图，再给学习路径，最后落到可运行的示例。Android 开发者若后续向跨平台方向转型，这条 KMP 路线图正是自然衔接的下一站。

参与维护：用 Figma 编辑路线图

由于路线图本身是设计产物，仓库的贡献流程也围绕 Figma 展开。按 CONTRIBUTING.md 的说明，参与维护分为四步：

1. 克隆仓库：git clone到本地；
2. 导入设计源文件：在 Figma 中导入 Android Developer Roadmap 2022.fig，该文件位于figma/目录；
3. 编辑设计元素：双击节点即可编辑，新增节点可通过复制粘贴已有节点完成；
4. 导出变更：需要同时导出两份产物——.fig工程文件（存回figma/目录）与命名必须为android_developer_roadmap.png的路线图图片（存回images/目录）。

从该流程可以推断，images/目录下的路线图 PNG 与figma/目录下的.fig源文件是同步维护的，任何节点变更都必须同时更新两者，保证 README 展示的图片与设计源一致。

项目渊源与开源协议

README 明确说明，本项目受到早期 Android Developer Roadmap 2020 项目的启发，感谢原作者提供的路线图思路与知识。项目本身采用 Apache License 2.0 开源协议（版权归属 Stream.IO, Inc.，Copyright 2021），详见 LICENSE。这意味着你可以自由地学习、使用乃至基于路线图思想二次创作，只要遵守 Apache 2.0 的署名与许可条款。

小结

Android Developer Roadmap 2022 的价值在于：它把庞大而分散的 Android 知识体系压缩进一张可读、可缩放、可维护的路线图中，并以"中央路径 + 领域节点 + 系列文章"三位一体的方式为开发者提供了清晰的学习主线。配合仓库自带的 Jetpack Compose 应用，路线图得以在移动端以缩放交互的方式落地；而 Figma 驱动的贡献流程又保证了知识地图可以随生态演进持续更新。无论你是刚入门的新手，还是寻求查漏补缺的进阶开发者，都可以从这张路线图中选取对自己有用的部分，沿着中央路径稳步前进。

• 移动开发
• 教程