Android 开发者的代码仓库：cw-omnibus 全解析

Android 开发者的代码仓库：cw-omnibus 全解析

做 Android 开发的人，大概率听过 Mark Murphy 这个名字。他在 Stack Overflow 上的声望很高，回答过大量 Android 相关的问题。但他更重要的贡献，是一本叫《The Busy Coder’s Guide to Android Development》的书，以及配套的代码仓库 cw-omnibus。

这个仓库目前有 5320 个 Star，里面放的是书里提到的几百个示例应用的源码。

这个仓库解决什么问题

学 Android 开发，光看书不够，得看代码、跑代码、改代码。cw-omnibus 就是为这个目的存在的。它不是那种放几个 demo 就完事的仓库，而是系统性地覆盖了 Android 开发的方方面面。

从最基础的 UI 控件（Button、CheckBox、ImageView），到进阶的 Fragment、ContentProvider、Service，再到高级主题如 DataBinding、EventBus、Camera 操作，每个知识点都有对应的独立示例项目。

仓库结构

打开仓库，顶层目录按功能模块划分。每个目录下面有多个子目录，对应不同的实现方式或使用场景。

举几个例子：

ActionBar 目录下有 ActionBarDemoNative、HoloColor、MaterialColor、MaterialLogo 等子项目，分别演示原生 ActionBar、Holo 风格配色、Material 风格配色、Logo 显示等不同用法。

Fragment 目录下有 ActionBarNative、Dynamic、Static，分别对应 ActionBar 中使用 Fragment、动态添加 Fragment、静态声明 Fragment 三种模式。

Database 目录下有 FTS（全文搜索）、SQLCipherPassphrase（加密数据库）等实际场景的示例。

这种结构的好处是，你遇到具体问题时，能快速找到对应的参考代码。不用在茫茫代码海里翻找。

怎么用

每个示例项目都是独立的 Android 项目，带有 build.gradle 文件，可以直接导入 Android Studio。

导入后注意检查 compileSdkVersion 和 buildToolsVersion，确保本地 SDK 版本匹配。如果版本不一致，在 SDK Manager 里下载对应版本就行。

仓库里还提供了 stub Gradle wrapper 文件，方便导入。但要注意，导入前检查 gradle-wrapper.properties 文件，确认 Gradle 来源可信。这是个安全细节，很多人会忽略。

如果想用命令行构建，需要本地安装 Gradle 3.3。仓库出于安全考虑，没有内置 gradlew 和对应的 JAR 文件。

书和代码的关系

这个仓库是书的配套代码，不是独立存在的。书会定期更新，代码也跟着更新。仓库里的 git tag 对应书的不同版本，方便你找到和当前书版本匹配的代码。

书本身是付费的，通过 Warescription 订阅获取。订阅者还能参加 office hours 讨论。但代码是 Apache 2.0 协议开源的，免费使用。

适合谁

如果你是 Android 新手，这个仓库能帮你把书上的知识落地。看文字描述和看实际代码，理解深度完全不一样。

如果你是有经验的开发者，这个仓库可以当速查手册用。遇到不熟悉的 API 或功能模块，直接找对应的示例项目，比翻官方文档快。

如果你在做技术培训或团队内部分享，这些示例项目可以直接拿来用，省去自己写 demo 的时间。

一些实际情况

这个仓库维护了很多年，示例数量庞大。但也正因为时间跨度长，有些示例可能用的是较老的 API 或写法。用的时候注意对照当前 Android 版本做适配。

5320 个 Star 说明社区认可度不错。对于一个教学性质的代码仓库来说，这个数字很实在。

总的来说，cw-omnibus 是 Android 开发学习路径上一个可靠的代码参考来源。它不会教你写炫酷的 UI，但会帮你把基础打扎实。

omnibus 是 Android 开发学习路径上一个可靠的代码参考来源。它不会教你写炫酷的 UI，但会帮你把基础打扎实。