用途:规范 Android 项目中的资源组织,覆盖 strings.xml、drawable、字体、主题、本地化,以及 Compose 中由资源支撑的具体取值(如 MaterialTheme 颜色)。适用需要统一资源定义、避免硬编码 UI 文本与颜色的场景。
主要能力与要求:所有 UI 文本必须定义在 strings.xml,Compose 中使用 stringResource(R.string.*) 引用;使用 format args(%s、%d)而非字符串拼接,数量敏感文本使用 plurals;动态查询用 context.getString(R.string.id, args),数量敏感字符串用 resources.getQuantityString(R.plurals.items, count, count)。共享功能尽量与 iOS 的 Localizable.strings 保持对等。
资源与主题:优先使用 VectorDrawables(.xml)而非光栅图片,以适配 mdpi、hdpi、xhdpi、xxhdpi 等密度。深色模式通过 values-night/ 限定符或 MaterialTheme 令牌支持 Configuration.UI_MODE_NIGHT,禁止在布局或 Composable 中硬编码十六进制颜色。主题颜色应映射到设计令牌(primary、surface、error)以统一换肤。
反模式:UI 中不得做字符串拼接;不得硬编码可见 UI 文本。
限制:资料未提供具体安装命令、平台范围、收费方式或效果数据;优先级标注为 P2(MEDIUM)。