ANDROID APK EDITOR · 智改工坊
安卓修改大师智改工坊

只需说话,就能让应用变成你想要的样子。把反编译、改代码、回编、对齐、签名这条长链路,收进一句中文需求里。

查看智改工坊产品介绍 →
设计稿是结果,资源值才是能被工程复用的规则
设计稿是结果,资源值才是能被工程复用的规则

设计师把稿件发过来,旁边标着三行字:主色 #0F766E,卡片圆角 16,正文 15 号字。看上去都是很具体的数字,真正落到 Android 工程里,却很容易变成另一回事:颜色写成了 #0F766E80,以为是在做半透明,结果 Android 把前两位当成了透明度;圆角写了 16,却没写单位,或者把设计稿的 16 像素直接当成 16dp;字号写了 15,用的却是 dp,用户把系统字体调大之后,文字纹丝不动。最后装到手机上,功能都对,气质不对。

问题不在设计,也不在开发,而在“翻译”。设计语言是一套有名字、有层级、有状态的值;Android 资源是另一套有单位、有限定符、有继承关系的值。两者之间需要一层映射:哪些值是原始色板,哪些值是语义角色,哪些值是组件样式,哪些值要跟随深色模式变化。这一层映射做好了,换一次品牌色只需要改几个资源;做不好,每次改设计都要在几十个布局文件里做查找替换。

这篇文章只讲“翻译”。不铺开讲布局怎么写,也不讲复杂的动画,只讨论颜色、圆角、字号、选择器和深色模式这五件事,怎样从设计稿上的标注,变成 colors、dimens、样式资源、drawable 里的具体值。文章以 安卓修改大师电脑版 为例,但里面的资源命名和换算方法,对任何 Android 项目都适用。

设计语言不是截图,是一组可命名的值

很多人把设计语言理解成一张视觉稿:主色、辅助色、圆角、字号、间距,看上去都在图里。但图是结果,不是规则。真正的设计语言至少包含四层:原始色板、语义角色、组件样式、状态变体。四层分开,资源才不会越写越乱。

设计稿给的是结果,资源给的是规则;中间那层翻译,才是设计语言真正落地的地方。
层级设计稿里的表达Android 里的落点例子
原始色板品牌色 500、600、100colors 里的基础色brand_500、brand_600
语义角色主色、背景、正文、次要文字按用途命名的颜色color_primary、surface、text_secondary
组件样式主按钮、卡片、输入框样式资源或 drawableWidget.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 表,再有 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,在高密度屏幕上会小得几乎看不见。

半径mdpihdpixhdpixxhdpixxxhdpi
8dp8px12px16px24px32px
12dp12px18px24px36px48px
16dp16px24px32px48px64px
20dp20px30px40px60px80px

圆角通常用 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 算出来的
圆角不是画上去的,是 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 或与字号联动的值。

用途单位例子原因
正文、标题、按钮文字sp15sp、20sp跟随系统字体缩放
控件高度、间距、圆角dp48dp、16dp、14dp不随字体缩放
描边宽度dp1dp保持视觉粗细
行高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 · 请仅修改自有版权或已获授权的应用