ANDROID APK EDITOR · 智改工坊
安卓修改大师智改工坊
只需说话,就能让应用变成你想要的样子。把反编译、改代码、回编、对齐、签名这条长链路,收进一句中文需求里。
查看智改工坊产品介绍 →
设计稿是结果,资源值才是能被工程复用的规则设计师把稿件发过来,旁边标着三行字:主色 #0F766E,卡片圆角 16,正文 15 号字。看上去都是很具体的数字,真正落到 Android 工程里,却很容易变成另一回事:颜色写成了 #0F766E80,以为是在做半透明,结果 Android 把前两位当成了透明度;圆角写了 16,却没写单位,或者把设计稿的 16 像素直接当成 16dp;字号写了 15,用的却是 dp,用户把系统字体调大之后,文字纹丝不动。最后装到手机上,功能都对,气质不对。
问题不在设计,也不在开发,而在“翻译”。设计语言是一套有名字、有层级、有状态的值;Android 资源是另一套有单位、有限定符、有继承关系的值。两者之间需要一层映射:哪些值是原始色板,哪些值是语义角色,哪些值是组件样式,哪些值要跟随深色模式变化。这一层映射做好了,换一次品牌色只需要改几个资源;做不好,每次改设计都要在几十个布局文件里做查找替换。
这篇文章只讲“翻译”。不铺开讲布局怎么写,也不讲复杂的动画,只讨论颜色、圆角、字号、选择器和深色模式这五件事,怎样从设计稿上的标注,变成 colors、dimens、样式资源、drawable 里的具体值。文章以 安卓修改大师电脑版 为例,但里面的资源命名和换算方法,对任何 Android 项目都适用。
设计语言不是截图,是一组可命名的值
很多人把设计语言理解成一张视觉稿:主色、辅助色、圆角、字号、间距,看上去都在图里。但图是结果,不是规则。真正的设计语言至少包含四层:原始色板、语义角色、组件样式、状态变体。四层分开,资源才不会越写越乱。
设计稿给的是结果,资源给的是规则;中间那层翻译,才是设计语言真正落地的地方。
| 层级 | 设计稿里的表达 | Android 里的落点 | 例子 |
|---|
| 原始色板 | 品牌色 500、600、100 | colors 里的基础色 | brand_500、brand_600 |
| 语义角色 | 主色、背景、正文、次要文字 | 按用途命名的颜色 | color_primary、surface、text_secondary |
| 组件样式 | 主按钮、卡片、输入框 | 样式资源或 drawable | Widget.App.Button.Primary |
| 状态变体 | 按下、禁用、选中、聚焦 | 选择器、颜色状态列表 | bg_btn_primary、text_btn_primary |
最容易被跳过的是第二层。设计师给的是“品牌绿”,开发直接把它命名为 green_500,然后在布局里到处引用。短期没问题,等到深色模式要换一套绿色,或者品牌升级要换成蓝绿,麻烦就来了:green_500 这个名字已经和实际颜色脱节,谁也不知道它到底是“品牌色”还是“某个绿色的备用色”。更好的做法是同时保留两层:brand_500 记录色板原值,color_primary 记录它在界面里的角色。组件只引用 color_primary,换品牌时改 color_primary 的指向,色板可以保留。
语义命名还有一个直接好处:深色模式。浅色主题下,surface 是白色,text_primary 是深灰;深色主题下,surface 变成深灰,text_primary 变成浅灰。名字不变,值变。布局文件里不需要写“如果是深色就用另一个颜色”,只需要引用同一个语义名。Android 的 values-night 限定符会自动挑选对应的值,前提是你的颜色是按角色命名的,而不是按颜色本身命名的。
先有 token 表,再有 colors、dimens 和样式这张 token 表不需要很复杂,一张三列的表就够:名字、浅色值、深色值。比如 color_primary 浅色 #0F766E、深色 #5EEAD4;surface 浅色 #FFFFFF、深色 #121417;text_primary 浅色 #1A1C1E、深色 #E6E8EB;radius_card 14dp;text_body 15sp。表定下来,后面的工作就变成“把布局里的硬编码替换成引用”,而不是每看到一个颜色就临时决定。
命名还有一条实用规则:颜色名不要带具体色相,除非它真的是色板。green_500 适合放在色板层,color_success 适合放在语义层;组件里引用 color_success,不要引用 green_500。因为“成功”不一定永远是绿色,品牌升级时可能换成蓝绿,深色模式下也可能换成更亮的青。语义名让值可以变,色相名会把值和含义绑死。圆角、间距、字号也一样:radius_card 比 corner_8 更能表达用途,space_section 比 margin_24 更能适应改版。
还有一点容易被忽略:token 表要写“用途”,不能只写值。#0F766E 是主色还是强调色?用在按钮背景还是文字?同一份绿,放在白字背景上和放在浅色卡片上,对比度完全不同。表里加一列“用在哪”,后面替换时就不会把“按钮背景色”误用到“正文文字色”上。设计语言的价值,一半在值,一半在“这个值该用在哪”的约束。
颜色:Android 的 8 位色值和你以为的不一样
颜色是设计稿和 Android 资源之间最容易出错的一项。六位色值 #RRGGBB 两边都一样,问题通常出在八位色值。Web 生态里常见的写法是 #RRGGBBAA,把透明度放在最后;Android 的 XML 颜色资源用的是 #AARRGGBB,把透明度放在最前。两种写法长得像,含义完全不同。
举个例子:你想要 50% 透明度的白色。Android 应该写 #80FFFFFF:80 是 alpha,约等于 50%,后面六个 F 是白色。如果你从网页样式里抄了 #FFFFFF80,Android 会把 FF 当成 alpha,也就是完全不透明,后面的 FF FF 80 变成一种偏黄的浅色。界面上不会报错,只会出现一块“说不清哪里不对”的浅黄。这个坑非常常见,尤其是在把设计稿的 Web 版本和 Android 版本对照着做的时候。
八位色值口诀
Android 的八位色值是 AARRGGBB,透明度在最前面;看到颜色发黄、发灰,先检查前两位。
#FFFFFF:不透明白色,正常。#80FFFFFF:50% 透明白色,正常半透明。#FFFFFF80:不透明浅黄,最常见的误写。#00000000:完全透明。#FF000000:不透明黑色。
颜色资源写在 res/values/colors.xml 里,用 @color/名字 引用。名字建议按语义来:color_primary、color_primary_pressed、color_on_primary、surface、surface_variant、text_primary、text_secondary、divider、danger。如果品牌有完整的色阶,可以再保留 brand_50 到 brand_900 作为原始色板,但组件不要直接引用色阶,而是引用语义色。这样换品牌时,只需要把语义色指向新的色阶。
<resources>
<color name="brand_500">#0F766E</color>
<color name="brand_600">#0B5F58</color>
<color name="color_primary">@color/brand_500</color>
<color name="color_primary_pressed">@color/brand_600</color>
<color name="color_on_primary">#FFFFFF</color>
<color name="surface">#FFFFFF</color>
<color name="text_primary">#1A1C1E</color>
<color name="text_secondary">#5B6670</color>
<color name="divider">#E3E8EC</color>
</resources>
透明度还有两种写法:直接写进八位色值,或者用 android:alpha。两者会相乘。比如颜色本身是 50% 透明,父布局又设了 android:alpha="0.5",最终看起来只有 25% 的不透明度。很多人调不出设计稿的效果,就是因为透明度被叠加了两次。我的建议是:静态的半透明颜色直接写进色值,比如遮罩用 #66000000;需要动画或整体淡入淡出的,再用 android:alpha,并且不要在父子层级重复设置。
着色是另一个常用能力。图标本身是单色时,不必为每个颜色准备一套图片,可以用 android:tint 或 backgroundTint 着色。按钮背景、ImageView、TextView 的 drawable 都支持 tint。tint 也支持颜色状态列表,按下时变深、禁用时变灰。要注意的是,tint 会覆盖原图的颜色,如果原图是彩色插画,着色会把它变成单色;只对单色图标使用。
颜色状态列表不只用于文字,也可以用于按钮背景、图标、分割线。把选择器写在 res/color/ 下,然后在布局里用 android:tint="@color/icon_tint" 或 app:backgroundTint="@color/button_bg_tint" 引用。这样按钮在按下、禁用、选中时,颜色会自动切换,不需要在代码里监听状态。对于复选框和开关,buttonTint、thumbTint、trackTint 都可以接收颜色状态列表;改主题色时,把这些控件的 tint 一起改,才不会出现“主按钮是品牌绿、开关还是系统蓝”的割裂感。
颜色还有一个常见问题:同一个颜色在不同背景上看起来不一样。设计稿里的 #0F766E 放在白底上很稳,放在浅灰卡片上可能显得脏;#F59E0B 放在白底上很亮,放在深色背景上可能刺眼。解决办法不是每次都调色,而是给颜色定义“容器色”和“内容色”:color_primary_container 是浅色底,color_on_primary_container 是放在它上面的文字色。按钮、标签、提示条都用这一对,换背景时一起换,对比度才不会失控。
颜色还要考虑对比度。正文文字和背景的对比度建议至少达到 4.5:1,大字号可以放宽到 3:1。品牌色上放白字,要先确认白色和品牌色的对比度够不够;如果不够,就用深色文字,或者把品牌色调深一档。不要因为“设计稿上看着还行”就跳过这一步,不同屏幕、不同亮度下,对比度不足的文字会非常难读。
圆角:设计稿的 16 到 shape 里的 16dp
圆角的第一个问题是单位。设计稿上写“16”,可能是 16 像素,也可能是 16 点;Android 里应该写 16dp。dp 是密度无关像素,在 mdpi 屏幕上 1dp 等于 1px,在 hdpi 上是 1.5px,在 xhdpi 上是 2px,在 xxhdpi 上是 3px,在 xxxhdpi 上是 4px。同样是 16dp,在不同密度上占的物理尺寸接近,视觉比例才一致。如果你把设计稿的 16px 直接写成 16px,在高密度屏幕上会小得几乎看不见。
| 半径 | mdpi | hdpi | xhdpi | xxhdpi | xxxhdpi |
|---|
| 8dp | 8px | 12px | 16px | 24px | 32px |
| 12dp | 12px | 18px | 24px | 36px | 48px |
| 16dp | 16px | 24px | 32px | 48px | 64px |
| 20dp | 20px | 30px | 40px | 60px | 80px |
圆角通常用 shape drawable 实现,写在 res/drawable/ 下。一个带填充、描边和圆角的矩形,大概是这样:
<shape android:shape="rectangle">
<solid android:color="@color/surface" />
<stroke android:width="1dp" android:color="@color/divider" />
<corners android:radius="16dp" />
<padding android:left="16dp" android:top="12dp"
android:right="16dp" android:bottom="12dp" />
</shape>
如果只有某几个角需要圆角,可以用 topLeftRadius、topRightRadius、bottomLeftRadius、bottomRightRadius 分别设置。比如底部弹窗只圆上面两个角,顶部导航卡片只圆下面两个角。四个角分别设置时,注意不要同时写 android:radius,否则可能被覆盖或产生意料之外的结果;要么全用单角属性,要么只用统一半径。
圆角超过高度的一半时,形状会变成胶囊。比如一个 48dp 高的按钮,圆角设 24dp 就是完整的胶囊;设 16dp 则是圆角矩形。想要胶囊按钮,不一定要写一个很大的数,写高度的一半更稳;写 999dp 虽然也能画出胶囊,但在不同高度下语义不清楚。更好的做法是定义 radius_pill,值取常见按钮高度的一半,或者直接用 radius_pill 表达“全圆角”的意图。
圆角不是画上去的,是 shape 的 corners 算出来的圆角还会影响子视图的裁剪。给父容器设置了圆角背景,子视图默认不会跟着变圆,尤其是图片、视频、地图这类会超出边界的控件。解决办法是给父容器加 android:clipToOutline="true",并确保背景是一个能提供 outline 的 drawable;shape 背景通常可以。这样图片就会被裁成圆角。如果没有生效,检查父容器是不是有背景、背景是不是 shape、clipToOutline 是不是加在了正确的层级上。
阴影是另一个容易混淆的点。shape 本身不画阴影,android:elevation 才会让系统绘制阴影。圆角卡片想要有浮起感,通常是“shape 背景 + elevation”,而不是在 shape 里找 shadow 属性。如果设计稿的阴影很特殊,elevation 做不出来,可以用 layer-list 叠加一层半透明的 shape 模拟,或者用 9-patch 图片。9-patch 适合复杂阴影和纹理,但它的 1 像素边框很容易被破坏,改图时要特别小心。
| 方案 | 适合 | 不适合 | 注意事项 |
|---|
| shape drawable | 纯色、描边、圆角、渐变 | 复杂阴影、纹理、异形 | 单位用 dp,圆角别超过高度一半 |
| 9-patch 图片 | 复杂阴影、气泡、带内容区的背景 | 纯色圆角这种简单形状 | 四边 1 像素黑线不能坏 |
| vector drawable | 图标、简单插画 | 照片、复杂渐变 | 路径要简洁,tint 方便换色 |
| layer-list | 多层叠加、简单阴影 | 复杂动画 | 层叠顺序从下往上 |
选型的原则是“能用 shape 就不用图片”。shape 体积小、可着色、随主题变;9-patch 和 PNG 是位图,改颜色要重新出图,深色模式还要准备另一套。只有形状复杂到 shape 画不出来,或者阴影/纹理必须用位图时,才用图片。这个原则对改包尤其重要:资源越少、引用越清晰,AI 改起来越不容易漏,回编也越稳。
圆角也要有 token。建议定义 radius_sm 4dp、radius_md 8dp、radius_lg 12dp、radius_xl 16dp、radius_card 20dp、radius_pill 100dp 这样一组值,布局里只引用 token,不写具体数字。设计稿从 8 改成 12,只改一个 dimen,所有卡片一起变;如果每个布局都写 8dp,就要改几十处,还容易漏。
字号与间距:sp、dp 与字体缩放
字号的第一条规则是:文字用 sp,布局用 dp。sp 和 dp 在默认字体缩放下数值一样,但 sp 会跟随系统的字体大小设置。用户把字体调大,sp 的文字会变大,dp 的间距和控件高度不变。这是 Android 的无障碍设计:视力不好的用户可以放大文字,布局应该尽量容纳,而不是把文字截断。
反过来说,不要用 sp 设置内边距、按钮高度、图标尺寸。字体放大时,这些值也跟着变,布局会被撑得很大,甚至超出屏幕。也不要用 dp 设置正文文字,那样用户调大字体时文字不变,等于剥夺了无障碍能力。正确的组合是:textSize 用 sp,layout_height、padding、margin 用 dp,行高用 sp 或与字号联动的值。
| 用途 | 单位 | 例子 | 原因 |
|---|
| 正文、标题、按钮文字 | sp | 15sp、20sp | 跟随系统字体缩放 |
| 控件高度、间距、圆角 | dp | 48dp、16dp、14dp | 不随字体缩放 |
| 描边宽度 | dp | 1dp | 保持视觉粗细 |
| 行高 | sp 或联动值 | 24sp | 跟随字号,避免拥挤 |
字号不要太多。一个应用通常五到六档就够:展示 28sp、标题 22sp、小标题 18sp、正文 15sp、辅助 13sp、说明 12sp。每档配一个行高,比如 28/36、22/30、18/26、15/24、13/20、12/18。字重也要克制,正文 400,标题 600 或 700,按钮 600。字号和字重一多,界面就会显得没有层次,反而不像一套设计。
<resources>
<dimen name="text_display">28sp</dimen>
<dimen name="text_title">22sp</dimen>
<dimen name="text_subtitle">18sp</dimen>
<dimen name="text_body">15sp</dimen>
<dimen name="text_caption">12sp</dimen>
<dimen name="space_xs">4dp</dimen>
<dimen name="space_sm">8dp</dimen>
<dimen name="space_md">16dp</dimen>
<dimen name="space_lg">24dp</dimen>
<dimen name="radius_md">14dp</dimen>
</resources>
行高在 Android 里可以用 android:lineHeight(API 28 及以上)设置,低版本用 android:lineSpacingExtra 或 android:lineSpacingMultiplier。lineHeight 用 sp 更符合字体缩放;lineSpacingExtra 是固定增量,用 dp 时不会跟着字体缩放,字体调大后行距可能显得太紧。如果应用要兼容低版本,可以两者都配:高版本用 lineHeight,低版本用 lineSpacingMultiplier 作为兜底。
间距建议用 4dp 或 8dp 的网格。4、8、12、16、24、32 这组值足够覆盖大多数场景。按钮的最小触控高度建议 48dp,可点击图标的触控区域也尽量做到 48dp,即使视觉上只有 24dp。卡片内边距常用 16dp 或 20dp,页面左右边距常用 16dp,表单一类的内容可以用 24dp。间距用 token 管理,不要每个页面临时写一个数字。
设计稿到 sp 的换算,关键看设计稿的基准。如果设计稿是按 1 倍尺寸做的,标注 15 号字就写 15sp;如果设计稿是 2 倍图,标注 30 像素,就写 15sp;如果是 3 倍图,标注 45 像素,还是写 15sp。不要用屏幕密度去换算文字,sp 本身就是密度无关的。唯一需要调整的是设计稿宽度和目标设备宽度的差异:比如设计稿按 375 宽度做,目标设备常见 360dp,可以按 0.96 的比例微调,但通常不需要,直接用设计标注的数值更稳。
字体文件也有讲究。自定义字体放在 res/font/ 下,通过 android:fontFamily="@font/xxx" 引用。字体文件会增加包体积,尤其是中文字体,一个字重就可能几 MB。内部应用如果只需要区分粗细,可以优先用系统字体 sans-serif、sans-serif-medium、sans-serif-bold,不一定非要嵌入自定义字体。如果品牌必须用特定字体,建议只嵌入需要的字重,并且确认授权允许在应用里使用。
字体放大后的布局,要靠“可伸缩”而不是“刚好塞下”。具体做法有几条:文本容器的高度尽量用 wrap_content 或 minHeight,不要写死一个刚好容纳 15sp 的 40dp;列表项用 layout_height="wrap_content",内部用 padding 控制留白;横向排列的按钮和标签,用 layout_weight 或 wrap_content,不要平均分配固定宽度;长文本用 maxLines 加 ellipsize,但关键信息不要截断,宁可换行。把系统字体调到 2.0 倍再看一遍,如果页面还能用,说明布局是健康的;如果文字叠在一起、按钮被挤出屏幕,说明前面的固定值太多。
选择器:让按钮在五种状态下都不出错
一个按钮不只有“正常”一种状态。它还有按下、聚焦、禁用、选中,有时还有加载中。设计稿通常只画正常态和按下态,剩下的状态要靠开发补齐。如果只做了一张背景图,按钮在禁用时仍然像可点的,用户就会反复点;如果按下时没有反馈,用户会怀疑没点上。选择器就是用来解决这些状态的。
drawable 选择器写在 res/drawable/ 下,每个 item 对应一个状态,顺序很重要:先写特殊状态,最后写默认状态。因为系统是从上往下匹配,第一个匹配上的就生效。如果把默认状态写在最前面,后面的按下、禁用永远不会生效。正确的顺序通常是:禁用、按下、聚焦、选中、默认。
<selector>
<item android:state_enabled="false">
<shape android:shape="rectangle">
<solid android:color="@color/color_primary_disabled" />
<corners android:radius="@dimen/radius_md" />
</shape>
</item>
<item android:state_pressed="true">
<shape android:shape="rectangle">
<solid android:color="@color/color_primary_pressed" />
<corners android:radius="@dimen/radius_md" />
</shape>
</item>
<item>
<shape android:shape="rectangle">
<solid android:color="@color/color_primary" />
<corners android:radius="@dimen/radius_md" />
</shape>
</item>
</selector>
文字颜色也可以用选择器,放在 res/color/ 下,item 里用 android:color 而不是 android:drawable。这一点很容易搞混:drawable 选择器放 res/drawable/,颜色选择器放 res/color/,两者语法相似,但用途不同。把颜色选择器放进 drawable 目录,或者把 drawable 选择器放进 color 目录,编译时可能不报错,运行时却拿不到想要的效果。
<selector>
<item android:state_enabled="false" android:color="@color/text_disabled" />
<item android:state_pressed="true" android:color="@color/text_on_primary_pressed" />
<item android:color="@color/text_on_primary" />
</selector>
水波纹是另一种状态反馈。Android 5.0 之后可以用 <ripple> 包裹一个 mask,让点击的水波纹限制在圆角范围内:
<ripple android:color="@color/ripple">
<item android:id="@android:id/mask">
<shape android:shape="rectangle">
<solid android:color="#FFFFFF" />
<corners android:radius="@dimen/radius_md" />
</shape>
</item>
</ripple>
水波纹的颜色可以用主题里的 ?attr/colorControlHighlight,这样浅色和深色主题会自动适配。如果自己写死一个半透明白,深色模式下可能看不见;写死一个半透明黑,浅色模式下又显得脏。能用主题属性就用主题属性,少写死颜色。
正常、按下、禁用都要有,按钮才像真的能点复选框、开关、单选按钮也有状态颜色,可以用 buttonTint、thumbTint、trackTint 配合颜色选择器。很多应用只改了主色,却忘了这些控件的选中颜色,结果页面整体是品牌绿,开关还是系统蓝。检查的时候,把开关打开、关闭、禁用各看一遍,把复选框选中、未选中、禁用各看一遍,确认颜色都跟着主题走。
深色模式:不是把白色换成黑色
深色模式最常见的错误,是把浅色主题的颜色直接反相:白底变黑底,黑字变白字,品牌色原样保留。这样做的结果通常很刺眼:纯黑背景上的纯白文字对比过强,长时间阅读容易疲劳;品牌色在深色背景上可能对比不足;卡片和背景融为一体,层次全没了。
正确的做法是建立一套深色语义值。背景不用纯黑,用深灰,比如 #121417;卡片比背景亮一档,比如 #1A1D21;再高一层的浮层用 #22262B。正文不用纯白,用 #E6E8EB;次要文字用 #A8B0B8;分割线用 #2C3238。品牌色在深色模式下通常需要提亮或降低饱和度,比如 #0F766E 可以提亮成 #5EEAD4 作为强调色,但大面积背景仍然用深色,不要整屏铺亮绿。
surface:浅色 #FFFFFF,深色 #121417,用作页面背景。surface_card:浅色 #FFFFFF,深色 #1A1D21,用作卡片背景。surface_float:浅色 #FFFFFF,深色 #22262B,用作弹窗和浮层。text_primary:浅色 #1A1C1E,深色 #E6E8EB,用作正文。text_secondary:浅色 #5B6670,深色 #A8B0B8,用作辅助文字。divider:浅色 #E3E8EC,深色 #2C3238,用作分割线。color_primary:浅色 #0F766E,深色 #5EEAD4,用作强调和按钮。
这些值写在 res/values-night/colors.xml 里,名字和浅色完全一样,只改值。系统切到深色模式时,会自动加载 values-night 下的资源。前提是应用的主题支持深色模式:如果主题是 Theme.AppCompat.DayNight 或 Theme.Material3.DayNight 这一类,系统会跟着切换;如果应用把主题固定成浅色,或者代码里强制了浅色模式,values-night 可能不会生效。改包时要先看主题的 parent,再决定是补 values-night,还是同时调整主题。
深色模式下的阴影几乎看不见,层次主要靠表面颜色和描边。浅色主题里用 elevation 做浮起感,深色主题里可以给卡片加一层比背景亮一点的表面色,再加一条很淡的描边。不要指望阴影在深色背景上还能撑起层次;如果设计稿给了阴影,深色版本通常要换成“更亮的表面 + 更明显的边界”。
状态栏和导航栏也要跟着变。浅色主题下,状态栏背景是浅色,图标应该是深色;深色主题下,状态栏背景是深色,图标应该是浅色。Android 用 android:windowLightStatusBar 控制状态栏图标是深色还是浅色,用 android:windowLightNavigationBar 控制导航栏。改包时如果只改了页面颜色,忘了状态栏,就会出现“白底白图标”或者“黑底黑图标”,看起来像系统坏了。
图片和图标也要检查。如果图标是 PNG,且颜色是写死的深灰,深色模式下可能看不清;可以换成单色矢量图,用 android:tint="?attr/colorOnSurface" 着色,或者准备 drawable-night 版本。如果图片是照片或插画,不要强行反相,保持原样,给它一个合适的背景和边框即可。深色模式不是把所有东西都变黑,而是保持信息层级和可读性。
深色模式靠表面层级,不是简单反相测试深色模式,最直接的方法是用系统开关,或者用命令切换:adb shell cmd uimode night yes 打开,adb shell cmd uimode night no 关闭。切换后不要只看首页,要把弹窗、列表、空状态、错误提示、输入框、禁用按钮都看一遍。很多深色模式的问题,不在主页面,而在那些“平时不出现”的状态里。
还有一个近年的变量:系统动态取色。Android 12 之后,部分系统会根据壁纸生成一套主题色,应用如果启用了动态取色,品牌色可能被系统色替换。对内部工具来说,这通常不是问题,甚至能带来更统一的外观;但对品牌识别要求高的应用,就要明确是否启用。启用动态取色后,语义 token 仍然是有效的,只是 color_primary 的值来自系统,不由设计稿决定。改包时如果发现“明明改了主色,按钮却还是系统色”,先检查主题里有没有开动态取色;如果没有把握,关掉动态取色,用固定品牌色更可控。
从设计稿到 values:一条可复用的翻译流程
把设计稿翻译成资源,可以按六步走。第一步,盘点现有资源:res/values/colors.xml、dimens.xml、样式资源、res/drawable/ 下的 shape、res/color/ 下的选择器,看看哪些是硬编码,哪些已经用了引用。第二步,整理 token 表:颜色、圆角、间距、字号、行高,各有哪些角色,浅色和深色分别是什么值。第三步,把布局里的硬编码替换成 @color/...、@dimen/...,替换时可以先保留旧名字作为别名,避免一次性改太多导致编译失败。第四步,抽出组件样式:主按钮、次按钮、卡片、输入框、标题、正文,各写一个样式,布局里只引用样式。第五步,补 values-night。第六步,验收:搜索残留的十六进制颜色,切换深浅色,调大字体,检查按钮状态。
换算规则可以总结成一张小表:
换算规则可以压缩成四句话。第一句:六位色值 #RRGGBB 直接对应,八位色值要把透明度从末尾移到最前,#RRGGBBAA 写成 #AARRGGBB。第二句:设计稿按 1 倍尺寸做时,圆角、字号、间距的数值可以 1:1 写成 dp 或 sp;按 2 倍尺寸做时,先除以 2,比如 32 圆角写 16dp、30 号字写 15sp。第三句:文字用 sp,布局用 dp,描边按 1dp 处理,行高用 sp 跟随字号。第四句:设计稿宽度和目标设备宽度不一致时,按比例微调后取整到 2dp 或 1sp,不要为了“精确”写出 15.7sp 这种值。
举个例子:1 倍稿标 16 圆角、15 号字,写 16dp、15sp;2 倍稿标 32 圆角、30 号字,也写 16dp、15sp。先确认设计稿的基准,再决定是 1:1 还是除以 2。
组件样式建议写在 res/values/ 下的样式资源里,很多项目会放在 themes.xml 中。一个主按钮的样式大概是这样:
<style name="Widget.App.Button.Primary" parent="Widget.AppCompat.Button">
<item name="android:background">@drawable/bg_btn_primary</item>
<item name="android:textColor">@color/text_btn_primary</item>
<item name="android:textSize">@dimen/text_body</item>
<item name="android:minHeight">48dp</item>
<item name="android:paddingLeft">20dp</item>
<item name="android:paddingRight">20dp</item>
<item name="android:textAllCaps">false</item>
</style>
样式的作用是把“组件长什么样”从布局里抽出来。布局只负责“放在哪里、多大”,样式负责“颜色、字号、圆角、内边距”。这样改设计时,先改 token,再改样式,最后才看布局;大部分改动不需要碰布局文件。对于改包来说,这也降低了风险:AI 只需要改几个资源和样式,不需要大面积重写布局,回编失败的几率更小。
资源限定符是“同一套名字、不同设备取不同值”的机制。除了 values-night,常用的还有 values-sw600dp(平板等大屏)、values-land(横屏)、values-zh(中文)、values-xxhdpi(高密度图片)。它们的优先级不是简单的“越具体越优先”,而是按限定符顺序匹配;同名资源在不同目录里,系统会挑最匹配的那一份。实际使用时,不要把所有值都复制到每个目录,只覆盖需要变化的那些。比如手机页面边距 16dp,平板可以放到 values-sw600dp 里改成 24dp;手机字号 15sp,平板可以改成 16sp;其他值继续用默认目录,避免维护多套重复资源。
values:默认目录,放基础颜色、尺寸、字号。values-night:系统深色模式,放深色背景、文字、品牌色。values-sw600dp:最小宽度 600dp 以上的平板,放大边距、调整双栏尺寸。values-land:横屏,调整横屏间距和导航高度。values-zh:中文环境,主要用于中文字符串,不要在这里复制整套颜色。drawable-night:深色模式下使用的图标和插画。
限定符用得好,能让一套设计适配多种设备;用得不好,会让资源目录变成迷宫。我的建议是:颜色和字号优先用 values 加 values-night;平板和横屏只在确实需要时加,并且只覆盖差异项;不要在 values-zh 里复制一整套颜色,语言限定符应该主要用于字符串。每增加一个限定符目录,就多一份要维护的资源,改包时也多一处可能漏掉的地方。
安卓修改大师电脑版的流程正好适合这种“资源层翻译”:拖入 APK,aapt 解析包信息,apktool 反编译出 res/ 和 AndroidManifest.xml,你在需求里写清“把 color_primary 改成 #0F766E,radius_md 改成 14dp,正文改成 15sp,补一套 values-night”,再把 token 表作为附件上传,每个附件写清用途。工具把需求、附件说明和固定环境说明一起发给 AI,AI 改完资源后,工具自动回编、对齐、签名、校验,产物落在 build\signed.apk,全过程写进 pack.log。
实例一:工单助手的品牌升级
第一个例子是自家的“工单助手”。这是一个内部使用的维修工单应用,包名 com.company.workorder,原来版本 2.6.0,versionCode 26,签名用团队 JKS。那次品牌升级的目标很明确:主色从蓝色 #1E88E5 换成青绿色 #0F766E,辅助色改成琥珀色 #F59E0B,卡片圆角从 8dp 改成 14dp,正文从 14sp 改成 15sp,同时补一套深色模式。
以前的改法是“查找替换”。设计师给了新色值,开发在布局文件里全局搜索 #1E88E5,替换成 #0F766E;圆角只改了按钮,卡片忘了;字号只改了正文,辅助文字还是 13sp;深色模式则是把 colors.xml 复制一份到 values-night,把白色改成黑色。结果 QA 一测,问题一大堆:有的页面按钮变了、卡片没变;有的图片背景还是浅蓝;深色模式下状态栏图标看不见;字体调到 1.3 倍后,两个页面的按钮文字被截断。返工了两轮,最后还是靠人肉一个个页面对照。
现在的做法是先做 token 表,再改资源。token 表里定下:color_primary 浅色 #0F766E、深色 #5EEAD4;color_secondary 浅色 #F59E0B、深色 #FBBF24;surface 浅色 #FFFFFF、深色 #121417;surface_card 浅色 #FFFFFF、深色 #1A1D21;text_primary 浅色 #1A1C1E、深色 #E6E8EB;radius_md 14dp;text_body 15sp;text_caption 12sp。然后把布局里的硬编码颜色替换成语义引用,把按钮、卡片、输入框抽成样式,再补 values-night。
改包时,把 token 表整理成一份 CSV 作为附件,需求写清“只改资源,不动包名、签名和业务代码;主色、辅助色、圆角、字号按附件表替换;补 values-night;版本升到 2.7.0,versionCode 27”。工具反编译后,AI 按附件表改 colors.xml、dimens.xml、样式资源和 drawable;回编、对齐、签名、校验由工具完成。产物保存后,按上一篇文章的命名规范改成带版本、渠道、签名、日期的文件名,归档。
改完怎么验证?第一,搜索残留:在 res/ 里搜索 #1E88E5 和 #FFFFFF,确认该替换的都替换了;第二,看浅色和深色两套截图,逐页对比卡片、按钮、文字、分割线;第三,把系统字体调到 1.3 倍和 2.0 倍,检查按钮文字、列表项、空状态有没有被截断;第四,检查按钮的按下、禁用、聚焦状态,确认颜色都跟着 token 走;第五,看状态栏和导航栏图标在深浅色下是否清楚;第六,覆盖安装旧版,确认 versionCode 27、签名一致、旧数据还在。
这次升级最明显的变化,不是某个页面变好看了,而是“以后改品牌只需要改几个值”。主色再调整,只改 color_primary;圆角再调整,只改 radius_md;深色模式要微调,只改 values-night。设计语言从一张图,变成了工程里可以引用的资源。
实例二:课程表应用的节日换肤
第二个例子是自家的“课程表”应用。这是一个给内部培训学校使用的课程安排工具,包名 com.company.timetable,版本 4.2.0,versionCode 42,签名用公司 JKS。每年春节前,运营都会要求换一套节日皮肤:主色改成中国红,辅助色改成金色,卡片背景改成暖白色,按钮和标签也要跟着变。节后还要换回常规配色。
以前的换肤方式是换图片。设计师做了二十多张背景图、按钮图、标签图,开发把 res/drawable 里的 PNG 一张张替换掉;有些页面没有对应的图,就直接在布局里写死红色;深色模式没有做,春节版在深色系统下变成了“红底黑字 + 白卡片”,非常刺眼。节后恢复更麻烦:图片要换回去,布局里的硬编码要再改一遍,漏一处就会留下一点红。那一年,节后第三周还有用户截图问“为什么这里还是红色的”。
现在的做法是把节日皮肤也当成一套 token。春节版定义:color_primary #B91C1C,color_secondary #D9A441,surface #FFF8F0,surface_card #FFFFFF,text_primary #3A1D1D,text_secondary #7A5A4A;radius_md 16dp;text_title 20sp;按钮和卡片用 shape drawable,不再用 PNG。深色模式也补一套:surface #1A1111,surface_card #241818,text_primary #F3E7E2,color_primary #F87171。这些值整理成一张表,作为附件上传,需求写清“按表替换颜色、圆角、字号,drawable 改成 shape,补 values-night,包名和签名不动,versionCode 43”。
这里有一个资源限定符的限制需要说明:Android 没有“春节”这种自定义限定符,不能靠 values-festival 自动切换。节日皮肤要么做成独立的构建变体或项目,要么在应用里做主题切换。内部应用最简单的做法是建两个项目:课程表-春节版-202601 和 课程表-常规版-202601,包名和签名相同,春节版 versionCode 43,常规版节后出 44。这样春节版可以覆盖常规版 42 安装,节后常规版 44 又可以覆盖春节版 43,数据不丢,回滚也有路。
改完怎么验证?第一,看八个主要页面:首页、课程列表、课程详情、教师列表、通知、我的、登录、空状态,确认红色和金色只出现在该出现的地方,没有大面积铺红;第二,看深色模式,确认暖白卡片变成深色表面,文字对比度够;第三,看按钮的按下、禁用状态,确认红色按钮在禁用时不会仍然像可点;第四,把字体调到 1.3 倍,检查课程标题和教师名字有没有被截断;第五,看状态栏图标,红色背景上要用浅色图标;第六,节后安装常规版 44,确认能覆盖春节版 43,颜色恢复,数据还在。
这次换肤的收益不只是“好看”。以前换一次皮肤要改图片、改布局、改颜色,节后还要再改回来;现在只改一组 token 和两个 drawable,AI 按表替换,工具回编签名,人工只需要验收。设计语言变成了可切换的参数,节日运营不再是一次“伤筋动骨”的改版。
十个常见坑与排查顺序
第一个坑:八位色值顺序写反。Android 是 #AARRGGBB,不是 #RRGGBBAA。看到颜色“发黄”“发灰”“透明度不对”,先检查八位色值的前两位。
第二个坑:透明度叠加。颜色本身带 alpha,父布局又设了 android:alpha,最终透明度是相乘的结果。排查时先看颜色值,再看父级 alpha,再看有没有多层遮罩。
第三个坑:px 和 dp/sp 混用。布局里的 16 应该是 16dp,文字 15 应该是 15sp。看到高密度屏幕上圆角特别小、文字特别小,先查单位。
第四个坑:圆角超过高度的一半。按钮高度 40dp,圆角写 30dp,画出来是胶囊,不是圆角矩形。想要圆角矩形,半径不要超过高度的一半;想要胶囊,直接用高度的一半。
第五个坑:选择器顺序写反。默认状态写在最前面,按下和禁用永远不生效。排查时把默认项移到最后,特殊状态放前面。
第六个坑:选择器放错目录。drawable 选择器放 res/drawable/,颜色选择器放 res/color/。放错目录可能编译通过,运行时却拿不到状态。
第七个坑:只改颜色,不改图片和状态栏。深色模式下图标还是深灰、状态栏还是白底白图标。排查时把 drawable、mipmap、状态栏、导航栏都过一遍。
第八个坑:布局里残留硬编码。colors.xml 改了,布局里还有 #FFFFFF、#1E88E5。排查时在 res/layout 里搜索 #,把所有十六进制字面量找出来。
第九个坑:用 shape 做阴影。shape 没有阴影属性,浮起感要靠 elevation 或 layer-list。看到卡片“有圆角但没层次”,先查 elevation。
第十个坑:固定高度配大字体。按钮高度写死 40dp,字体调到 1.3 倍后文字被截断。排查时把字体调到 2.0 倍,看所有固定高度的文本容器。
排查顺序建议从“值”到“样式”再到“页面”:先确认 token 值对不对,再确认样式有没有引用 token,最后才看具体页面。反过来,一上来就改页面,很容易把同一个问题在不同页面重复修十遍。验收时最好留一台装着旧版本的设备,先覆盖安装看升级是否正常,再卸载重装看首次启动是否正常;两条路径都走一遍,才能发现“旧数据迁移”和“新资源缺失”这两类不同的问题。
一页验收清单
把上面的内容压缩成一张表,改完设计资源后可以照着打勾:
| 检查项 | 怎么查 | 通过标准 |
|---|
| 颜色值 | 搜索布局里的 # | 没有残留硬编码,全部引用 @color |
| 八位色值 | 抽查半透明颜色 | 前两位是 alpha,不是后两位 |
| 圆角 | 对比设计稿与截图 | 卡片、按钮、弹窗圆角一致 |
| 字号 | 查 textSize | 全部用 sp,档位不超过六档 |
| 间距 | 查 padding/margin | 使用 4/8dp 网格 token |
| 选择器 | 点击、禁用、聚焦 | 每个状态都有可见反馈 |
| 深色模式 | 系统切换深浅色 | 背景、卡片、文字、图标都正常 |
| 字体缩放 | 系统字体 1.3 倍、2.0 倍 | 文字不截断,布局不重叠 |
| 状态栏 | 深浅色各看一次 | 图标与背景对比清楚 |
| 版本与签名 | aapt、apksigner | 版本递增,签名一致 |
三个容易被忽略的细节
第一个细节是对比度要真的算,不要靠眼睛猜。品牌色上的白字,看起来可能很清楚,但在强光下或者低亮度屏幕上,对比度可能不够。可以用在线的对比度计算器,把前景色和背景色的相对亮度算出来;正文目标 4.5:1,大字号目标 3:1。如果不够,优先调文字的深浅,而不是调品牌色本身;品牌色是识别资产,文字色是功能色,动功能色代价更小。
第二个细节是图标和图片不要写死颜色。很多应用的图标是 PNG,颜色直接画在像素里;换主题色时,图标不会跟着变,深色模式下还可能看不清。能换成 vector 的尽量换,用 android:tint 着色;不能换的,至少准备 drawable-night 版本,或者在图标外面加一个中性色背景,保证对比度。图片也是同理:照片不要反相,插画不要硬调色,保持原样,用边框和背景把它和主题隔开。
第三个细节是保留原始资源。改包之前,项目目录里的 source.apk 是原始包;改完之后,res/ 里的旧资源、旧颜色、旧样式最好也在版本控制或归档里留一份。品牌升级不是一次性的,下一次可能还要回滚,或者要在旧版基础上做渠道包。安卓修改大师电脑版每个项目都会保留 source.apk 和 pack.log,这是最基本的兜底;如果团队有自己的资源仓库,把改前的 colors.xml、dimens.xml、关键 drawable 也存一份,回滚时不用靠记忆重建。
这张表不需要每次全做,但只要是“换肤、品牌升级、深色模式”这类改动,至少要把颜色、圆角、字号、选择器、深色模式、字体缩放这六项走一遍。前四项决定“像不像设计稿”,后两项决定“能不能用”。
写在最后
设计语言落到 Android,不是把设计稿上的数字抄进 XML,而是把“颜色、圆角、字号、状态”翻译成一套有名字、有层级、有单位的资源。颜色要分色板和语义,八位色值要把 alpha 放前面;圆角要用 dp 和 shape,超过一半就变胶囊;字号要用 sp,布局要用 dp;选择器要把特殊状态放前面;深色模式要用 values-night 和表面层级,而不是简单反相。这些规则不复杂,难的是每次都按规则做。
如果只记三句话,可以记这三句。第一句:先定 token,再写资源,最后才改页面;token 是设计语言和工程之间的合同。第二句:颜色看 alpha 位置,圆角看单位,字号看 sp,状态看选择器顺序;四个地方对,界面就八九不离十。第三句:深色模式不是反色,是另一套语义值;浅色和深色共用名字,只换值。
必须说清楚边界:本文所有改包与资源替换方法,只适用于自有版权、内部使用或已获得明确授权的应用。反编译、回编、签名是用来学习、研究、企业内测和自有应用维护的技术,不是用来破解他人付费应用、去除授权校验或绕过安全机制的工具。改设计资源之前,先确认你有权利改这个包。
“以前改品牌色,最怕布局里藏着的硬编码。现在先把 token 表定好,颜色、圆角、字号都走引用,改一次品牌只动几个文件,验收也快。”
—— 沈工 · 企业 Android 开发
“我不写代码,但我能看懂 token 表。把浅色和深色的值一起给开发,比只给一张视觉稿清楚多了,来回改的次数明显少了。”
—— 苏设计师 · UI 设计师
“八位色值的顺序坑过我一次,半透明白色变成了浅黄,查了半天。后来所有颜色都按 AARRGGBB 写,再也没犯过。”
—— 小纪 · 独立开发者
“节日换肤以前要等设计出图、开发换图,节后还要再改回来。现在给一张颜色表,当天就能出包,节后换回常规版也很快。”
—— 唐姐 · 运营主管
“我最开始只会改 colors,后来才知道圆角、字号、选择器、深色模式都在资源里。按 token 改,比一个页面一个页面抠稳得多。”
—— 老马 · 安卓逆向爱好者
安卓修改大师智改工坊 的入口在这里:https://www.apkeditor.cn/ai-version.aspx。官网是 www.apkeditor.cn。它可以把反编译、改资源、回编、对齐、签名、校验收进一句中文需求里,但 token 表怎么定、颜色怎么命名、深色模式怎么验收,仍然需要人来把关;工具负责把改动落进资源,设计语言负责让改动有章法。
只需说话,就能让应用变成你想要的样子。把设计稿翻译成资源值,把资源值命名成 token,把 token 交给工具去执行;你负责说清“要什么”,工具负责把它变成能安装的包。下一次设计师再发来一行 #0F766E、16 圆角、15 号字,你就不用再猜了。
DOWNLOAD
安卓修改大师智能修改安卓版
手机、平板直接安装,导入 APK 后说一句话,自动反编译、修改、回编、对齐、签名;也能把网址打包成应用,成品可装、可存、可分享。
立即下载安卓版 / 查看详情 →官网 www.apkeditor.cn · 请仅修改自有版权或已获授权的应用