Project 中心化依赖（Gradle）

仓库布局契约（路径唯一来源）

本 Skill 内凡出现依赖配置路径，均以下列符号展开；将来若抽成 project-gradle-* 或 fork 改目录，只改本表一行即可。

常用文件（由契约展开）

{DEPS_ROOT}/config.gradle 首部依次 apply 了 config_kotlin.gradle（ext.deps_kotlin）、config_androidx.gradle（ext.deps_androidx）、config_libs.gradle（ext.deps_lib），再定义 ext.deps（仅 build / dev）；根工程 build.gradle 只需 apply config.gradle 即可加载全部 ext.deps*。任何新依赖必须先查是否已存在，禁止重复定义同一坐标。

升级已有 GAV 版本、多源校验写回 → Read project-gradle-third-party-version-upgrade/SKILL.md（沿用同一 DEPS_ROOT / DEPS_MANIFEST）。

0. 官方 Android 库检索（新增依赖前建议查阅）

写入 {DEPS_ROOT}/config_androidx.gradle（deps_androidx）/ config_kotlin.gradle（deps_kotlin）的 官方坐标 前，优先在下列站点核对 artifact 名、稳定版号、分组语义：

{DEPS_ROOT}/config_androidx.gradle / config_kotlin.gradle 内 「Android 官方库」 区块注释已收录上表部分链接；查版本号以中文版总览页为准，与文件中各条目旁的 mvnrepository.com 链接交叉核对。

第三方 / 非官方库不在此页检索 → 使用 mvnrepository.com 或库方 GitHub，并写入 {DEPS_ROOT}/config_libs.gradle。

1. 查找是否已存在

按优先级在 {DEPS_ROOT} 下四个坐标文件全文检索（建议对 artifact 名、group、已有 key 各搜一次）：

若已存在：跳到 第 4 步，只在本模块或 {DEPS_MANIFEST}/*.gradle 中增加 api / implementation / kapt 引用，不要再写一条相同 GAV 的配置。

2. 不存在时：决定写入哪个文件、哪个分组

2.1 写入官方坐标文件（deps / deps_kotlin / deps_androidx）

在同时满足「官方」且语义属于下列范围时使用：

• {DEPS_ROOT}/config_kotlin.gradle（deps_kotlin，顶层平铺 map）：org.jetbrains.kotlin、org.jetbrains.kotlinx、org.jetbrains.dokka；与 Kotlin/JetBrains 生态强相关、且现有 deps_kotlin 里同类条目并列的 AndroidX KTX（若团队惯例放在 deps_kotlin 而非纯 deps_androidx，与文件内现有条目保持一致）。
• {DEPS_ROOT}/config_androidx.gradle（deps_androidx，顶层平铺 map）：androidx.* Jetpack/AndroidX 构件；com.google.android.material:material 等与官方文档并列的 Material 组件（本仓库当前放在 deps_androidx）；com.google.dagger:hilt-android* 等本文件已有先例的官方栈。
• {DEPS_ROOT}/config.gradle（deps）→ build 分组：Gradle 插件类坐标（与现有 kotlin_gradle_plugin 等并列）。
• {DEPS_ROOT}/config.gradle（deps）→ dev 分组：仅 io.github.afkt Dev 系列，勿把外部库塞入。

CameraX（androidx.camera:*）属于 AndroidX 官方 → 新增键应放在 config_androidx.gradle 的 deps_androidx（除非仓库后续另有约定；以文件内同类 androidx.* 为准）。

2.2 写入 {DEPS_ROOT}/config_libs.gradle（deps_lib）

• 非 Google/JetBrains/AndroidX 官方发布、或 group 为第三方域名（如 com.squareup、com.github.*、io.github.* 等）→ 放入 deps_lib。
• 在现有子分组中选语义最接近的一个（如网络 common、图片 image_widget、路由 router）。不要把明显不属于该分组的库硬塞进去。
• 若确实没有合适分组：在 deps_lib 顶层新增一个子 map 键（命名风格与现有一致：小写 + 下划线，如 camera_kit），并在该块顶部用与全文件一致的 区块注释（// ===...=== + 简短中文说明）。

2.3 与 {DEPS_ROOT}/versions.gradle 的关系

config.gradle / config_kotlin.gradle / config_androidx.gradle / config_libs.gradle 首行均 apply from: versions.gradle（相对 {DEPS_ROOT}）。若版本需多处复用或与 Kotlin 版本对齐，可像 kotlin-gradle-plugin 那样使用 ${versions.xxx}；否则可直接写死版本号（与现有条目风格一致）。

3. 新增条目时的注释与 key 命名

参考 {DEPS_ROOT} 下两文件中已有行：

• 可选：// https://mvnrepository.com/artifact/...
• 一行中文说明 + 官方文档或 GitHub 链接（与邻近条目同级）。
• key：全小写 + 下划线，语义清晰（如 camerax_camera2、camerax_lifecycle）；同一库多模块多个 key 时保持前缀一致。

4. 在业务侧引用（DEPS_MANIFEST）

• Android 库 / 示例里与官方坐标相关的清单：照 {DEPS_MANIFEST}/deps_android.gradle —— api deps_kotlin.<key>、api deps_androidx.<key>，需要处理器时用 kapt（与模块现有写法一致）。
• 示例工程、第三方 lib 聚合清单：照 {DEPS_MANIFEST}/deps_project.gradle —— api deps_lib.<子分组>.<key>，并保留分组标题注释与简短中文/GitHub 说明。

具体模块若直接写依赖而不走 deps_kotlin/deps_androidx/deps_lib，仍应使用同一字符串（如 api deps_androidx.camerax），避免复制一份硬编码 GAV。

5. 自检清单

• 官方 AndroidX/Kotlin 坐标已在 AndroidX 版本总览（中文） 核对稳定版号与 artifact 名。
• 已在 {DEPS_ROOT}/config.gradle、config_kotlin.gradle、config_androidx.gradle 与 config_libs.gradle 中确认无重复坐标。
• 官方/非官方归属与文件分组、注释风格与邻居一致。
• 若在 deps / deps_kotlin / deps_androidx / deps_lib 新增 key，已在 {DEPS_MANIFEST}/deps_*.gradle 或目标模块 build.gradle 中增加引用行。
• 需要注解处理器时同时声明 kapt 行（若该模块已使用 kapt）。