面向 Android 原生应用开发的 Material Design 3 知识库,重点为 Google 官方设计规范与 Jetpack Compose 实现。本仓库是个人整理,不是 Google 官方发布的资料包。
让 AI(或人)在写 Android UI 时不靠记忆编造规范:尺寸从哪来、颜色用哪个角色、API 是不是还实验性、版本号是多少——每条都要能追到官方来源。
- 阅读
AI-INSTRUCTIONS.md,将其设为云端 AI 项目指令。 - 从
00-Metadata/sources.yaml进入官方资料。 - 按下表查对应层,不要跳层。
- 通过
接入教程.md上传 GitHub 并接入 ChatGPT / Claude / Gemini。 - 更新时记录检查日期、官方来源、版本状态和变化。
| 目录 | 状态 | 说明 |
|---|---|---|
00-Metadata/ |
✅ 可用 | 来源索引、版本快照、术语表、站点覆盖映射(375 页)、博客索引 |
01-Foundations/ |
✅ 可用 | 15 篇基础系统:色彩 / 字体 / 形状 / 层级 / 动效 / 间距 / 图标 / 布局 / 交互状态 / 内容设计 / 无障碍 / 令牌 / 原则 / 手表 / XR |
02-Components/ |
✅ 可用 | 34 篇;官方 36 个组件全覆盖(含 Expressive 新增:Split Button / FAB Menu / Loading Indicator / Button Group) |
03-Android-Compose/ |
✅ 可用 | 9 篇实现指南 + 平台对照,代码为主 |
04-Official-Samples/ |
✅ 索引 | 官方示例的 pinned commit + 结构索引(不镜像源码,上游约 106MB) |
05-Design-Tokens/ |
✅ 可用 | 字阶、形状有值;颜色只存角色 |
| 06-Figma-Resources/ | ✅ 可用 | 官方 specs 测量图 19 张 + android-compose 示例归档(P0–P2、31 tests、APK),见 android-compose/README.md |
| 07-Development-Rules/ | ✅ 可用 | 决策规则、编码规则、评审清单 |
| 08-Original-Sources/ | ✅ 可用 | 官方链接汇总 |
| 09-Sample-Apps/ | ✅ 可用 | 1 个完整示例应用「时序」MD3Clock:5 页、Expressive 全量落点,源码可独立构建;安装包见 Release |
| 你要做的事 | 先看 |
|---|---|
| 做一个新界面 | 07/android-ui-rules.md → 01/design-principles.md |
| 写 Compose 代码 | 07/compose-coding-rules.md → 03/components-api.md |
| 评审一个界面 | 07/ui-review-checklist.md |
| 定主题配色 | 01/color-system.md → 03/color-scheme.md |
| 处理键盘 / 系统栏 | 03/window-insets.md |
| 适配平板 / 折叠屏 | 03/adaptive-layout.md → 01/layout.md |
| 定间距 / 字号 | 01/spacing.md → 01/typography.md |
| 写文案 / 通知文本 | 01/content-design.md |
| 处理 hover / 按下 / 禁用 | 01/interaction-states.md |
| 表盘 / XR 形态 | 01/watches.md / 01/xr.md |
| 查版本号 / API 状态 | 00/version-tracking.md → 00/sources.yaml |
| 想看规范落成代码长什么样 | 09-Sample-Apps/MD3Clock/README.md(组件 → 章节映射表) |
- 设计规范以 Material Design 官方网站为准。
- Android API、依赖版本和弃用状态以 Android Developers / AndroidX Release Notes 为准。
- 官方示例项目是实现参考,不自动等同于最新规范。
- 次级来源(周报、博客转述)只用于定位变更,不作为结论依据。
- 本仓库不镜像 Google 官网全部内容;网页规范需定期复核。
Material Design 官网是 Angular 应用,正文需 JS 渲染——直接 curl 只能拿到标题。本库 2026-11-16 用 headless Chrome + CDP 把 sitemap 里全部 375 个页面渲染后取正文(约 219 万字符),逐页对照写入,覆盖映射见 00-Metadata/site-map.md。
本库中所有数值型结论都标注了核验日期与核验方式;未能在官方页面目视确认的,都写明了「
尚未核实的部分集中在 00-Metadata/version-tracking.md 的「待核验清单」。Expressive 组件按用户约定跟进官方 Maven 最新版本、不等 stable(执行口径见 version-tracking.md 的 2026-11-16 追加节)。