android-dimen-dp-sp

# Android：硬编码 dp / sp → `@dimen/dp_*`、`@dimen/sp_*` ## 何时用本 Skill - 用户要把 **XML / Kotlin / Java** 里写死的 **`Ndp` / `Nsp`** 或等价的 dp、sp 数值，改成 **dimen 引用**。 - **不要**去仓库里搜索、推断或校验 `values/dimens.xml` 是否已有对应项：**默认视为已存在**，直接按规则写出 `@dimen/...` 与 `R.dimen....`。 ## 命名规则（核心） 1. **前缀**：物理长度用 `dp_`，文字尺寸用 `sp_`。 2. **有小数时**：`整数部分` + `_` + `小数点后那一位数字`（仅 **一位** 小数参与命名）。 - 小数部分命名里的 `_` **表示小数点**，不是第二个「任意分隔符」。 3. **一位小数的得出方式**（与「12.5555 → dp_12_5」一致）：**截断**到小数点后一位（丢弃第二位及以后），**不**按四舍五入成 12.6。 4. **无小数（整数）时**：`dp_12`、`sp_8`，**不要**写成 `dp_12_0`（除非用户项目已有该风格再跟随项目）。 | 原始数值（dp 或 sp，单位一致即可） | 资源名（dp 示例） | XML 引用 | 代码引用 | | :--- | :--- | :--- | :--- | | 0.5 | `dp_0_5` | `@dimen/dp_0_5` | `R.dimen.dp_0_5` | | 12.5 | `dp_12_5` | `@dimen/dp_12_5` | `R.dimen.dp_12_5` | | 12.5555 | `dp_12_5`（先截断为 12.5） | `@dimen/dp_12_5` | `R.dimen.dp_12_5` | | 12 | `dp_12` | `@dimen/dp_12` | `R.dimen.dp_12` | `sp` 同理：`12.5sp` → `@dimen/sp_12_5`、`R.dimen.sp_12_5`。 ## 从字面量到资源名的算法（给 Agent 执行用） 对某个 **dp 或 sp** 的数值 `v`（只看数字部分）： 1. 若 `v` 为整数（或可视为整数）：资源名为 `dp_<整数>` 或 `sp_<整数>`。 2. 若 `v` 有小数部分：将 `v` **截断**到小数点后一位得到 `v'`，拆成整数部分 `a` 与一位小数数字 `b`（`b` 为 0–9），资源名为 `dp_<a>_<b>` 或 `sp_<a>_<b>`。 - 例：`v = 12.5555` → `v' = 12.5` → `a = 12`, `b = 5` → `dp_12_5`。 - 例：`v = 0.5` → `v' = 0.5` → `dp_0_5`。 ## XML 写法 - 将 `android:padding="12.5dp"`、`tools:layout_margin="8sp"` 等中的 **字面量** 改为 **`@dimen/dp_12_5`**、**`@dimen/sp_8`** 等形式；**不要**在属性值里再保留 `dp`/`sp` 后缀（dimen 条目自身已带单位语义）。 - 若原先是 `tools:` 或 `app:` 等命名空间，只替换尺寸字面量部分，其余属性名与命名空间不变。 ## Kotlin / Java 写法 - 需要 **资源 id** 时：`R.dimen.dp_12_5`、`R.dimen.sp_8` 等，与上述命名一致。 - 取像素时仍按项目惯例使用 `resources.getDimension(R.dimen.dp_12_5)` 等；本 Skill 只规定 **资源名与引用形式**，不规定用 px 还是 dp 的封装工具类。 ## 注意 - **只改 dp/sp 到 dimen 的映射与引用**；不要顺带「优化」无关布局、不要擅自新建 `dimens.xml` 条目（除非用户明确要求创建资源文件）。 - 负值、表达式（如 `10dp+2dp`）若出现，本 Skill 未定义统一资源名：先向用户确认或按项目已有约定处理。