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

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

查看智改工坊产品介绍 →
同一个应用名,在不同语言环境下会走不同的资源目录
同一个应用名,在不同语言环境下会走不同的资源目录

改应用名是一件很容易“看起来做完了”的事。默认资源里的 app_name 换成新名字,打包、签名、装到自己的中文手机上,桌面变了,设置里也变了,于是交付。过了两天,出海团队的同事发来一张截图:英文系统下,桌面是旧中文名,设置里是新英文名,点进应用,标题是英文,关于页却还是中文。再过一天,台湾仓库的同事说,他们那边的名字跟上一版一模一样。

你打开包检查,发现 values-en 里确实有 app_name,values-zh-rTW 里也确实有名字,看起来都改了。问题在于,“改了”与“改全了”是两件事:英文目录里改的是 application 用的那个键,桌面读的是另一个键;繁体目录里那个键还留着上一版的值;香港设备则根本没进繁体目录,落到了简体兜底。每一个键都独立回退,每一个位置都可能读到不同的键,任何一个没对齐,就会在某个语言环境下露出来。

这篇文章只讲多语言改名里的资源回退:一个应用名在 values、values-en、values-zh-rTW 这些目录里怎么被选中,缺键时怎么回退,默认语言应该怎么定,切完系统语言后哪些位置不会跟着变,以及怎么用一套可执行的检查把漏改找出来。工具用 安卓修改大师电脑版,它导入 APK 时会用 aapt 解析应用名、包名、版本、最低与目标 SDK 和启动页,改完自动回编、对齐、签名,再装到设备上拉起,正好可以边切语言边对照。

回退不是一个文件,而是一个键一个键地找

先纠正一个很常见的误解:很多人以为 Android 在多语言时会“整份文件回退”。也就是说,如果 values-en 存在,就整份用英文;如果不存在,就整份用默认。真实情况不是这样。资源系统是按“每一条资源”独立选择的,一个字符串、一张图、一个颜色,各自去找自己最匹配的配置。

举个具体的例子。默认 values/strings.xml 里有十个键,values-en/strings.xml 里只翻译了七个,漏了应用名、关于页标题、快捷方式短标签。英文设备启动应用时,系统会把英文目录里有的七个键按英文取,剩下三个键在英文目录里找不到,就各自回退到默认目录。于是界面上大部分是英文,应用名却是中文,关于页标题也是中文。用户看到的是“半汉半英”,代码里其实没有一处写错,只是三个键没翻译。

键默认 valuesvalues-en英文设备实际显示
app_name巡检宝Inspect ProInspect Pro
app_name_launcher巡检宝缺失巡检宝(回退默认)
about_title关于巡检宝缺失关于巡检宝(回退默认)
shortcut_short巡检缺失巡检(回退默认)
item_count%d 项待检%d items%d items
login_button登录Sign inSign in

这张表就是“按关键字回退”的样子。它解释了两件事。第一,漏一个键不会让整页变成中文,只会让那一条变成中文,所以很容易被“整体看起来是英文”掩盖。第二,回退是按语言环境动态发生的,你在中文系统上测试,永远看不到这些缺失;只有切到英文,系统才会去英文目录找,找不到才回退。

这也意味着,“英文目录存在”不等于“英文完整”。判断完整性不能看目录在不在,要看键齐不齐。一个只翻译了三分之一的 values-en,在英文设备上会显示成三分英文、七分中文的混合界面,而且混合的比例会随着页面不同而变化,因为每个页面用到的键不一样。

缺哪个键,就只有那一条回退到默认语言
缺哪个键,就只有那一条回退到默认语言

资源表里的“配置”是什么

要理解回退,得先知道编译后的资源长什么样。APK 里的字符串不是以 XML 文件形式存放的,而是被编译进 resources.arsc 这张二进制资源表。表里每一条资源都有一个名字和一串配置:默认配置一份,en 一份,zh-rTW 一份。系统在取资源时,把当前设备的语言、地区、屏幕密度等打包成一个配置,去表里找匹配度最高的那一条。

匹配是逐条进行的。app_name 会在默认配置和 en 配置之间选,login_button 也会独立选一次。两条资源之间没有“绑定关系”,不会因为 app_name 选了英文,login_button 就必须跟着选英文。所以同一个界面上出现两种语言,在资源系统看来是完全正常的:每条资源都选了自己最匹配的那份。

这也解释了为什么“把默认语言改成英文”有时能立刻让界面顺眼:默认配置是所有语言的兜底,改成英文之后,任何没有对应翻译的语言环境都会看到英文,而不是中文。代价是中文设备如果缺少 values-zh,也会看到英文。默认语言的选择,本质上是在选“没翻译时给用户看什么”。

resources.arsc 是编译产物,不是手改的文件。只改解码目录里的 XML 而不重新编译,表不会变;直接把 XML 塞回 APK,运行时也不会读。正确路径是改 res/values*/ 下的源文件,重新编译资源、重新打包、对齐、签名。安卓修改大师电脑版的打包链路就是这条:回编生成新的资源表,对齐,签名,再校验签名是否真的写上。

values 是兜底目录,不是“中文目录”

values 这个目录名里没有语言限定符,它的含义是“默认配置”,也就是所有没有更具体匹配时使用的兜底。它不是“中文目录”,也不是“英文目录”,它是什么语言,完全取决于你把什么内容放进去。

国内应用最常见的做法,是把中文放在默认 values 里,再建一个 values-en 放英文。这个结构在国内没问题:中文设备匹配默认,英文设备匹配 values-en。但它有一个隐性前提:所有要支持的语言都必须有完整的目录。一旦某个语言没建目录,或者目录里缺键,用户就会看到中文。日语、韩语、法语、西班牙语设备都会落到默认,看到的都是中文。

默认语言策略适合的场景风险
默认放中文,其他语言各自建目录以国内用户为主,出海语言少任何未覆盖的语言都显示中文
默认放英文,中文放 values-zh面向多语言市场,英文是通用语中文目录缺键时显示英文
默认放英文,中文放 values-zh-rCN需要区分简繁和地区用词地区不匹配时可能落到英文

没有一种策略适合所有产品。判断标准是“谁最可能看到兜底”。如果用户绝大多数是中文用户,默认放中文是合理的;如果应用要出海,默认放英文更稳,因为英文是多数非目标语言用户的共同理解基础。最糟糕的是默认放中文、英文目录只翻译一半,还对外宣称支持英文,用户看到的就是混合界面。

默认语言还会影响一个常被忽略的位置:aapt dump badging 输出的 application-label。这一行是默认配置的应用名,不带语言后缀;后面的 application-label-en、application-label-zh-TW 才是各语言的标签。如果默认是中文,application-label 就是中文;英文设备如果没有英文标签,就会回退到这一行。检查包的时候,先看这一行是什么语言,就能判断兜底会给出什么。

一句话记住默认
values 是“没人匹配时看的那一份”。它的语言决定了所有漏翻语言的第一印象。

默认语言与“应用内语言”不是一回事

Android 13 之后,用户可以在系统设置里给单个应用选语言,这个能力叫“应用单独设置语言”。它改变的是应用进程内的资源选择,不影响桌面启动器显示的标签,因为启动器是用系统语言去解析应用标签的。用户把应用内语言设成英文、系统仍是中文时,桌面显示中文、应用内显示英文,看起来像“没改齐”,其实是预期行为。

应用要支持这个能力,需要在清单里声明 android:localeConfig,指向 res/xml/locales_config.xml。这个文件列出应用支持的语言,系统才会在“应用语言”列表里给出这些选项。没有声明,系统可能不给入口,或者只给一个默认项。改多语言应用时,如果希望用户能单独切语言,这个文件也要跟着语言列表一起维护。

应用内语言的另一个特点是“进程级”。切换之后,系统会重建 Activity,资源重新加载;但静态变量里缓存下来的字符串不会自动更新,通知渠道名也不会因为资源变了而重写。测试时如果只切语言、不重启应用,可能会看到一部分旧文字,这不是资源没改,而是进程里还留着旧值。

限定符的匹配顺序:语言、地区与脚本

Android 的资源目录用限定符描述配置。语言用两个字母的 ISO 639-1 代码,比如 en、zh、ja;地区用 r 加两个字母,比如 rUS、rTW、rHK;脚本用 b+ 加 BCP 47 标签,比如 b+zh+Hant。目录名可以组合,values-zh-rTW 表示中文、台湾地区,values-en-rUS 表示英文、美国。

匹配的原则是“越具体越优先”。设备语言是 zh-TW 时,values-zh-rTW 比 values-zh 具体,优先命中;设备是 zh-CN 时,values-zh-rCN 优先,没有就落到 values-zh;设备是 ja-JP 时,没有 values-ja,就落到默认 values。语言是第一步筛选,地区是在同语言内部进一步细分。

设备语言可用目录通常命中的目录结果
zh-CNvalues、values-zh、values-zh-rTWvalues-zh简体
zh-TWvalues、values-zh、values-zh-rTWvalues-zh-rTW繁体
zh-HKvalues、values-zh、values-zh-rTWvalues-zh简体(地区不匹配,落到语言级)
en-USvalues、values-en、values-en-rUSvalues-en-rUS美式英文
en-GBvalues、values-en、values-en-rUSvalues-en英式英文(或语言级内容)
ja-JPvalues、values-envalues默认语言

这张表里最值得盯的是香港那一行。很多应用只建了 values-zh 和 values-zh-rTW,以为繁体覆盖了所有繁体用户;实际上香港设备在语言级匹配上会落到 values-zh,看到的是简体。要覆盖香港,要么单独建 values-zh-rHK,要么用 values-b+zh+Hant 提供一个脚本级的繁体兜底。前者可以写香港用词,后者覆盖面更广但用词偏通用。

“越具体越优先”还有一个副作用:当你同时有 values-en 和 values-en-rUS 时,美国设备会优先 values-en-rUS,其他英语地区优先 values-en。如果两份内容不一致,同一个应用在不同英语地区的显示就会不同。这不是 bug,是限定符在起作用;维护时要保证两份的键和值同步,或者干脆只保留一份。

语言、地区、脚本三层限定符,决定最终读哪一份资源
语言、地区、脚本三层限定符,决定最终读哪一份资源

限定符不是越多越好

有些团队为了“精确”,给每个地区都建一个目录:values-en-rUS、values-en-rGB、values-en-rAU、values-en-rCA。结果是维护成本成倍增加,每改一个文案要改四份,漏一份就出现地区差异。更合理的做法是先问:这些地区的用词真的不同吗?如果只是拼写或个别术语不同,用一份 values-en 加少量覆盖就够了;只有日期格式、货币、法律用语这类确实需要地区化的内容,才值得单独建目录。

反过来,也不能把地区限定符当成“更精确的英文”来用。values-en-rUS 只声明了美国英语这一种配置,它不是一个“英文总目录”。如果只建它,其他英语地区的设备会继续找 values-en,找不到就落到默认;把英文全部押在一个地区目录上,是不稳的。

values-en 与 values-en-rUS:地区限定符的代价

values-en 和 values-en-rUS 只差一个地区后缀,实际行为差别不小。values-en 是语言级配置,所有英语地区都能匹配;values-en-rUS 是语言加地区,只有美国英语是最精确匹配。两者同时存在时,美国设备优先后者,其他英语地区优先前者。

这个机制本身没问题,问题出在“只建一个”的时候。有些包只有一个 values-en-rUS,团队以为“英文就这一个目录”,结果在英式英语设备上,系统会先找 en-GB,找不到,再找语言级 en,还是没有,最后落到默认。默认是中文,英国用户就看到中文;美国用户看到英文。同一份包,在两个英语地区表现完全不同,排查起来非常费劲。

目录组合美国设备英国设备澳洲设备建议
只有 values-en英文英文英文最稳的英文打底
只有 values-en-rUS美式英文回退默认回退默认不要单独使用
values-en + values-en-rUS美式英文通用英文通用英文推荐结构
values-en + values-en-rGB通用英文英式英文通用英文有英式用词差异时使用
英文目录的底线
至少有一个 values-en 作为语言级打底;地区目录只做覆盖,不做唯一来源。

繁体与脚本:zh-rTW、zh-rHK 与 b+zh+Hant

繁体中文是多语言改名里最容易“以为覆盖了、其实没覆盖”的一块。原因在于中文的语言标签只有一个 zh,简体、繁体、台湾、香港、澳门都挂在它下面,而地区限定符只区分地区,不区分字形。目录建得不对,繁体用户就会看到简体,或者看到上一版的名字。

values-zh 是语言级目录,所有中文设备都能匹配,包括台湾、香港、澳门。它里面放的是简体,繁体设备就会显示简体。很多包只建了 values-zh 和 values-zh-rTW,以为“繁体就是台湾”,结果香港设备落到了 values-zh,看到简体;澳门设备同理。要覆盖繁体,至少要有 values-zh-rTW,最好再加 values-zh-rHK,或者用脚本级目录统一兜底。

values-b+zh+Hant 是 BCP 47 形式的脚本限定符,Hant 表示繁体字形。它不绑定具体地区,台湾、香港、澳门的设备都能匹配,适合“只有一份繁体翻译、不区分地区用词”的场景。如果台湾和香港的用词确实不同,再分别建 values-zh-rTW 和 values-zh-rHK 做覆盖。这样结构清楚:脚本级打底,地区级细化。

目录覆盖范围适合的内容常见问题
values-zh所有中文设备简体通用文案繁体设备也命中,显示简体
values-zh-rTW台湾地区台湾用词、繁体香港、澳门不覆盖
values-zh-rHK香港地区香港用词、繁体只覆盖香港
values-b+zh+Hant所有繁体设备通用繁体地区用词不够细
values-zh-rCN中国大陆大陆用词、简体其他中文地区可能落到默认

台湾和香港的用词差异,不只是“繁简转换”。同一个概念,两地可能用不同的词:台湾常说“網路”,香港常说“網絡”;台湾说“計程車”,香港说“的士”;“檔案”和“文件”的取舍也不完全一样。如果只做一份繁体,这些差异只能取其一;如果两地都有用户,最好分开。改应用名时,产品名可以统一,功能名、菜单名、提示语则要按地区调整。

繁体的兜底
只有一份繁体时用 values-b+zh+Hant;台湾、香港用词不同时再加 values-zh-rTW、values-zh-rHK。

application label 与 activity label:两条资源引用都要覆盖

多语言改名改不齐,很大一部分原因是“只改了 application 的 label,没改启动 Activity 的 label”。这两个 label 是两个独立属性,各自引用一个字符串键,各自按语言回退。它们可以在同一个语言目录里指向不同的键,也可以一个有翻译、一个没有。

一份典型的清单是这样:

<application
    android:label="@string/app_name"
    android:icon="@mipmap/ic_launcher">
    <activity
        android:name=".ui.MainActivity"
        android:label="@string/app_name_launcher"
        android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

设置页、安装器、通知头部读 app_name,桌面启动器和最近任务可能读 app_name_launcher。如果 values-en 里只翻译了 app_name,英文设备上就会出现“设置里是英文名、桌面还是中文名”的分裂。反过来,只翻译 app_name_launcher,桌面变了,设置还是中文。两个键都指向同一个值的时候看不出问题,一旦只改一个,分裂就出现了。

activity-alias 让这件事更复杂。别名有自己的 android:label,可以指向第三个键 app_name_alias;桌面如果走别名入口,读的就是这一份。很多应用用别名做多入口、换装或者内测入口,别名和主 Activity 的 label 各自独立。改名时只改主 Activity,别名入口仍然是旧名;只改别名,设置页仍然是旧名。

显示位置读取的属性多语言缺键时的表现
设置应用信息application 的 label回退默认语言的应用名
桌面图标下启动 Activity 或 alias 的 label回退默认语言的启动名
最近任务任务根 Activity 的 label回退默认语言的启动名
安装器application 的 label回退默认语言的应用名
通知头部application 的 label回退默认语言的应用名
桌面快捷方式shortcutShortLabel回退默认语言的短标签
小组件选择器appwidget-provider 的 label回退默认语言的小组件名

这张表说明,改名不是“改一个位置”,而是“改一组键”。更准确地说,是“把每个键在每个语言目录里都补齐”。只按位置改,会漏掉同一位置在不同语言下的副本;只按语言改,会漏掉同一语言下不同组件的键。两个维度都要过一遍。

aapt dump badging 可以帮你做第一层确认。它会输出 application-label 和带语言后缀的 application-label-xx,还会输出 launchable-activity 及其 label。前者告诉你 application 标签在各语言下的值,后者告诉你启动入口的默认标签。启动入口在各语言下的值,badging 不一定全部列出,需要看资源表或者装机切换语言确认。

application 与 activity 各引一个键,缺一个就分裂
application 与 activity 各引一个键,缺一个就分裂

键的命名也能减少漏改

多语言改名频繁的项目,键名最好成组。比如 app_name、app_name_launcher、app_name_alias 三个键放在一起,改的时候一眼能看到三个;如果分别叫 app_name、launcher_title、alias_label,很容易只改第一个。命名不解决技术问题,但能减少“看不见的遗漏”。

对于确定不翻译的品牌名,可以加 translatable="false",让翻译工具跳过它。但要注意:应用显示名通常是需要翻译的,尤其是出海产品;把 app_name 标成不翻译,英文用户就会看到中文名。translatable="false" 适合那些全球统一的商标、代号、产品系列名,不适合“应用在市场里叫什么”。

切系统语言之后,哪些地方不会变

改完多语言资源,切一下系统语言,是最直接的验证方式。但切完之后,并不是所有位置都会立刻跟着变。有些位置读系统语言,有些位置读应用内语言,有些位置把值缓存了下来,还有些位置根本不走资源系统。

应用内的文字会跟着变。系统语言改变会触发配置变更,Activity 重建,资源重新加载;如果应用没有自己拦截配置变更,界面会重新创建,文字变成新语言。如果应用在清单里声明了 android:configChanges="locale|layoutDirection" 并自己处理,行为就取决于代码有没有重新读资源;处理不好,会出现部分文字不变的情况。

桌面上的应用名通常也会跟着变,但要看启动器的刷新时机。启动器在语言变化后会重新向包管理器查询标签,重新渲染图标下的文字;有的桌面立即刷新,有的等下一次启动。改完语言后如果桌面还是旧语言,先强行停止启动器再回桌面,不要急着怀疑资源。

最近任务的标题不一定变。任务描述在任务创建时生成,语言切换不会重建已经存在的任务;卡片上的标题可能还是切换前的语言。把卡片划掉重新打开应用,或者重启设备,才会用新语言重建。这个位置在多语言测试里经常被误判为“漏翻”。

桌面快捷方式和小组件也不会自动变。它们是启动器数据库里的副本,固定到桌面时复制了当时的标签;应用更新或者系统语言变化,都不会自动改写这份副本。要验证它们的多语言,只能删除后重新添加。

通知渠道的名称和描述是另一类。渠道在创建时把名称和描述写进系统数据库,之后改资源不会自动更新已存在的渠道;应用需要在升级后重新创建同名渠道,或者删除旧渠道再建。通知本身的语言则取决于发通知时进程的资源配置,切语言后重新发一条,才会用新语言。

位置是否跟随系统语言需要额外动作
应用内界面是重新进入页面或让 Activity 重建
桌面应用名通常是重启启动器或等待刷新
最近任务标题不一定划掉任务重开
桌面快捷方式否删除后重新固定
小组件否移除后重新添加
通知渠道名否重新创建渠道
已发出的通知否重新发一条
硬编码文案否只能改代码或资源引用

应用单独设置语言带来的新变量

Android 13 的“应用语言”让用户可以只给某个应用换语言,不影响系统。这个设置改变的是应用进程的资源,桌面标签仍跟随系统语言。测试时要把两种情况分开:系统语言切换,影响桌面、设置、应用内;应用语言切换,只影响应用内。

如果应用声明了 localeConfig,系统会在应用语言列表里列出支持的语言;用户选了之后,应用进程会按这个语言加载资源。此时 values-en、values-zh-rTW 这些目录仍然按同样的规则匹配,只是“当前语言”来自应用设置而不是系统设置。资源回退的逻辑没有变,变的是输入。

这个能力也带来一个新的验收项:用户把应用语言设成英文、系统仍是中文时,桌面显示中文、应用内显示英文,这是正常的;如果交付文档没写清楚,用户会以为是改名失败。测试清单里加一句“应用语言与系统语言不一致时,桌面跟随系统、应用内跟随应用”,能省掉很多解释。

漏改排查:把键集合对齐

多语言改名最可靠的排查方式,不是“再装一次看看”,而是把每个语言目录的键集合列出来,逐个对齐。键集合对上了,剩下的才是值和格式问题;键集合对不上,装机测试只能碰到哪个算哪个。

第一步,把 APK 解码,找到 res/values*/ 下的所有 XML。strings.xml 是主要文件,但不要只看它:arrays.xml 里的字符串数组、plurals.xml 里的数量词、strings_names.xml 这类自定义文件,都可能包含应用名或者菜单名。把所有含 <string>、<string-array>、<plurals> 的文件都列进来。

第二步,为每个语言目录建一张键表。默认 values 一张,values-en 一张,values-zh-rTW 一张,有多少语言建多少张。每张表至少有三列:键名、值、是否 translatable="false"。然后把表横向对比,找出“默认有、英文没有”“英文有、繁体没有”“繁体有、默认没有”的键。

第三步,按“缺键”和“多键”分别处理。缺键意味着该语言会回退到默认,表现是混合语言;多键意味着这个语言有一份默认没有的文案,可能是历史遗留,也可能是默认目录漏了。两种情况都要处理,不能只补缺的。

检查项做法通过标准
字符串键对比各 values 目录的 <string name>键集合一致,translatable=false 除外
字符串数组检查 <string-array> 的 item 数量各语言 item 数量一致
数量词检查 <plurals> 的 quantity各语言覆盖 one/other 等所需数量
清单引用搜 android:label、android:description引用的键在每个语言目录都存在
快捷方式检查 res/xml/shortcuts.xml短标签、长标签都有翻译
小组件检查 appwidget-provider 的 label每个语言目录都有对应值
占位符对比 %1$s、%d 等每个翻译保留同样的占位符
硬编码搜旧名字的字符串smali、assets、raw 里没有残留

第四步,检查清单和资源之外的引用。AndroidManifest.xml 里的 android:label 可能指向某个键,res/xml/shortcuts.xml 里的 shortcutShortLabel 也可能指向某个键;这些键如果在某个语言目录里缺失,就会回退。资源文件内部的交叉引用(一个字符串引用另一个字符串)也要检查,避免改了外层没改内层。

第五步,检查硬编码。旧名字可能出现在 smali 代码、assets 里的 HTML、res/raw 里的配置文件、WebView 加载的本地页面,甚至通知渠道创建时传的字符串。这些位置不走资源系统,改 strings.xml 不会动它们。搜索时不要只搜中文名,英文名、拼音、缩写都可能残留。

aapt dump badging 适合做快速确认:看 application-label 和各语言后缀是否存在,值是否对应。要看得更细,可以用 aapt2 dump resources 把资源表导出来,按字符串键和配置查看每个语言的值。导出的文本很长,但搜索一个键名就能看到它在哪些配置下存在,比逐个装机快。

把每个语言目录的键表横向对齐,漏改会自己浮出来
把每个语言目录的键表横向对齐,漏改会自己浮出来

三类最容易漏的键

第一类是“组件级标签”。application 的 label 大家都记得改,启动 Activity、activity-alias、服务、接收器、提供者的 label 就容易被忘。用户能看到的主要是 Activity 和别名,但服务名会出现在系统的一些列表里,改名时最好一起处理。

第二类是“容器型资源”。字符串数组是一个整体,缺一个 item 不会只回退那一个,而是整个数组回退到默认;数量词也是按 quantity 回退,英文的 one 缺失时可能拿到默认语言的 other。这类资源的漏改,表现往往不是“某个词没翻”,而是“整段变成中文”或者“单复数不对”。

第三类是“运行时才写入系统的文案”。通知渠道名、桌面快捷方式、任务描述、账户类型名,都是在某个时刻被系统记下来的,之后改资源不会自动更新。它们不一定在 strings.xml 的键表里显眼,但对用户可见。改多语言应用时,最好为这类文案单独列一张清单,注明“需要重新创建/重新固定/重新发通知”。

实例一:巡检宝出海,半汉半英的那一版

第一个例子是自家的门店巡检应用“巡检宝”。这个应用在国内用了一年多,默认 values 是完整中文,后来为了海外试点,加了一个 values-en,由外包翻译公司做了一版。现在产品要改名:中文叫“巡检宝”,英文叫“Inspect Pro”,要求桌面、设置、最近任务、关于页、快捷方式都用新名字。

以前的做法是“改两个目录里的 app_name”。默认目录的 app_name 改成“巡检宝”,英文目录的 app_name 改成“Inspect Pro”,打包,装到英文样机。结果桌面还是“巡检宝”,设置里是“Inspect Pro”,最近任务还是“巡检宝”,关于页也是中文,快捷方式还是旧短标签。第一轮改完,团队以为“英文资源没生效”,又改了一遍,还是一样。

查下来是三个漏掉的键。第一,启动 Activity 的 label 指向 app_name_launcher,这个键只在默认目录里有,英文目录没有,所以桌面回退到中文。第二,关于页标题用的是 about_title,英文目录漏了,整页标题回退中文。第三,快捷方式的短标签用的是 shortcut_short,英文目录也没有,固定到桌面的快捷方式显示旧中文。三个键,三个位置,各自回退,表现就是“半汉半英”。

中间还遇到一次编译失败。英文文案里有一句 Inspector's checklist,撇号没有转义,aapt 直接报错,提示撇号前要加反斜杠。改成 Inspector\'s checklist 之后才过。还有一处数量词,中文写 %d 项待检,英文翻译成了 %d items to inspect,但英文的 one 形式没写,数量为 1 时显示成了复数。这两个问题都不是“改名”本身,而是翻译资源进入构建链路时的格式问题。

现在的做法是先把键列全,再让 AI 一次改完。需求写成:把应用显示名统一改为中文“巡检宝”、英文“Inspect Pro”;涉及 app_name、app_name_launcher、about_title、shortcut_short 四个键;默认 values 和 values-en 都要有对应值;item_count 的英文复数要补 one 和 other;保留 %1$s、%d 占位符;不要改包名,不要换签名,versionCode 加一。

附件里放了两份文件:一份三列的翻译对照表,列名是键名、中文、英文;一份是英文样机上桌面、设置、关于页三处的截图,标出期望效果。每份文件的用途说明都写清楚,比如“翻译对照表,用于逐键替换 values 与 values-en 的字符串”。说明不少于十个字,AI 才能判断这份附件该用在哪里。

安卓修改大师电脑版 导入 APK 后先用 aapt 解析出应用名、包名、版本和启动页,把当前的应用名和图标显示出来,改之前就能确认“现在包里叫什么”。需求发出去之后,AI 按对照表改默认和英文资源,回编、对齐、签名;打包日志写在项目目录的 pack.log 里,哪一步失败都能回看。

改完怎么验证?第一步,对产物跑 aapt dump badging,看 application-label 是不是“巡检宝”,application-label-en 是不是“Inspect Pro”。第二步,用 aapt2 dump resources 搜索 app_name_launcher,确认它在默认和 en 两个配置下都有值。第三步,覆盖安装到英文样机,强行停止应用,从桌面点开,看图标下方是不是“Inspect Pro”。第四步,进设置的应用信息页,看顶部名字;打开最近任务,看卡片标题。第五步,进关于页,看标题和版权行;长按桌面图标看快捷方式,必要时删除后重新固定。第六步,把应用语言切到英文、系统语言保持中文,确认应用内是英文、桌面是中文,这是预期行为。

还有一个动作容易被忽略:发一条测试通知,看通知头部的应用名。它读的是 application 的 label,英文环境下应该是“Inspect Pro”。如果这里还是中文,说明 app_name 的英文值没写进去,或者进程里还留着旧资源。取消旧通知、重新发一条,再确认一次。

实例二:盘点助手在台湾与香港的两个旧名字

第二个例子是自家的仓库盘点应用“盘点助手”。这个应用在广东主仓用简体,在台湾仓用繁体,在香港仓也有少量用户。默认 values 是简体,values-zh 是简体的副本,values-zh-rTW 是繁体,但里面的应用名还停留在上一版“盤點助理”;香港没有单独目录。

这次改名,中文简体叫“盘点助手”,繁体叫“盤點助手”,英文叫“Stocktake Assistant”。以前的做法是改默认和英文,繁体目录“看起来已经翻过了”,就没动。结果台湾仓的同事装上新包,桌面还是“盤點助理”,设置里也是旧名;香港仓的同事更奇怪,桌面显示的是简体“盘点助手”。两个地方,两种旧。

台湾的问题很直接:values-zh-rTW 里的 app_name 和 app_name_launcher 没有改。香港的问题在于目录结构:只有 values-zh(简体)和 values-zh-rTW(繁体),香港设备在语言级匹配上落到了 values-zh,看到简体。要覆盖香港,得单独建 values-zh-rHK,或者用 values-b+zh+Hant 做脚本级兜底。

除此之外,还有一处“菜单数组”的漏改。应用的主菜单是一个 <string-array>,里面有“入库、出库、盘点、调拨”四项。繁体目录只翻译了前两项,后两项沿用了简体。这个数组是一个整体资源,不会按 item 回退;但因为前两项是繁体、后两项是简体,用户看到的是中简混排。改的时候要把四项都补齐。

现在的做法是把语言目录和键一起列清楚。需求写成:应用名简体“盘点助手”、繁体“盤點助手”、英文“Stocktake Assistant”;更新 values、values-zh、values-zh-rTW、values-en 四个目录;新增 values-zh-rHK,内容与繁体一致,香港用词后续再细化;app_name、app_name_launcher、about_title、主菜单数组、日期格式都要覆盖;不要改包名和签名,versionCode 加一。

附件里放了一份按语言分列的对照表,以及台湾、香港两台样机的桌面截图。对照表里,菜单数组按 item 逐行列出,避免“只翻前两项”的情况再次发生。日期格式也单独列了一行:简体用“2026年11月18日”,繁体用“2026/11/18”,英文用“Nov 18, 2026”。这些格式不是应用名,但同属多语言资源,改名时一起检查,能减少下一轮返工。

改完怎么验证?第一步,跑 aapt dump badging,看 application-label、application-label-en、application-label-zh-TW 是否存在且值正确。第二步,装到台湾样机,系统语言设成“中文(繁體,台灣)”,强行停止应用,看桌面、设置、最近任务三处是否都是“盤點助手”。第三步,装到香港样机,系统语言设成“中文(繁體,香港)”,看是否命中新增的 values-zh-rHK,而不是简体。第四步,打开主菜单,确认四项都是繁体,没有中简混排。第五步,看日期显示是否符合该地区的格式。第六步,切到英文,重复桌面、设置、菜单、日期的检查。

两台样机都过一遍,才算真正覆盖。只在简体环境验收,永远发现不了 values-zh-rTW 的旧名字,因为简体设备根本不会去读那个目录。

多语言验收要按语言逐套走,而不是只切一次英文
多语言验收要按语言逐套走,而不是只切一次英文

占位符、转义与 plurals:翻译阶段的编译期坑

多语言改名不只是替换文字,资源文件本身有格式规则。翻译人员给的是纯文本,进入 Android 资源后要经过 XML 解析和 aapt 编译,任何一处格式不对,轻则显示异常,重则编译失败。改名时最常见的三类坑是占位符、转义和数量词。

占位符的规则是“位置必须显式”。一条字符串里如果有多个替换参数,必须写成 %1$s、%2$d 这种带位置序号的形式;写成两个 %s,aapt 会报“Multiple substitutions specified in non-positional format”,要求你加序号或者声明 formatted="false"。翻译时如果把 %1$s 漏掉、把 %d 写成 %s,编译可能过,运行时却会抛格式异常,或者显示成字面量。改名涉及产品名时,经常出现“欢迎使用 %1$s”这类句子,占位符尤其要逐条核对。

转义的规则是“XML 特殊字符要转义”。& 要写成 &amp;,< 要写成 &lt;,> 一般不用转但建议一致处理。英文里的撇号 ' 要写成 \',或者把整条字符串用双引号包起来;不处理的话,aapt 会报“Apostrophe not preceded by \”。字符串开头或结尾有空格时,要用双引号包住,否则空格会被 XML 解析器吃掉。字符串以 @ 或 ? 开头时,也要转义或者加引号,避免被当成资源引用。

数量词的规则是“按语言声明 quantity”。英文有 one 和 other,中文通常只有 other,俄语、阿拉伯语有更复杂的复数形式。<plurals> 里的每个 quantity 都是一条独立资源,缺了某个 quantity,系统会按自己的规则回退;英文缺 one 时,数量为 1 可能显示成 %d items。改名如果碰到“1 项待检”“1 条记录”这类文案,最好把 one 和 other 都补齐,不要只写 other。

问题典型报错或表现处理方式
多个 %s 无序号编译报 Multiple substitutions改成 %1$s、%2$s
撇号未转义编译报 Apostrophe not preceded by \写成 \' 或加双引号
& 未转义编译报实体错误写成 &amp;
首尾空格丢失显示少一个空格整条字符串加双引号
英文缺 one数量 1 显示复数补 <item quantity="one">
数组只翻一半菜单中简混排补齐所有 item
占位符类型不匹配运行时格式异常%d 对整数,%s 对字符串

还有一类问题不在字符串本身,而在“字符串和代码的约定”。代码里用 String.format(getString(R.string.welcome), name),资源里就必须有对应的占位符;代码里按索引取字符串数组,数组的 item 顺序就不能变。改名时如果只改文字、不动结构,通常没事;如果顺手调整了数组顺序或者删了占位符,代码就会出错。改包时把“只改值、不改结构”写进需求,能避免大部分这类问题。

改资源的三条底线
占位符不改、转义要正确、数组和数量词的结构不动。

验收清单、用户评价与收尾

把前面的内容压缩成一份可以照着勾的清单。改完多语言应用名之后,按语言、按位置各走一遍。

  • 键表检查:默认、英文、繁体、香港四个目录的 app_name、app_name_launcher、about_title 是否齐全。
  • 容器检查:字符串数组的 item 数量是否一致,<plurals> 的 quantity 是否覆盖目标语言所需形式。
  • 清单检查:application、启动 Activity、activity-alias 的 label 是否都指向已翻译的键。
  • 占位符检查:%1$s、%d 是否原样保留,类型是否匹配。
  • 转义检查:撇号、&、<、首尾空格是否处理正确。
  • 静态检查:aapt dump badging 的 application-label-xx 是否齐全,值是否正确。
  • 简体检查:桌面、设置、最近任务、关于页、快捷方式是否都是新名字。
  • 英文检查:切到英文,强行停止应用,重复上述位置;注意桌面跟随系统语言。
  • 繁体检查:台湾、香港分别切一遍,确认没有旧名、没有简体混入。
  • 缓存检查:重启启动器、划掉最近任务、重新发通知之后,显示是否一致。
  • 硬编码检查:smali、assets、raw、WebView 本地页里是否还有旧名字。
  • 应用语言检查:Android 13 单独设置应用语言时,应用内与桌面的语言差异是否符合预期。

这份清单不求一次全做,但求每次改名都做。多语言的问题有很强的滞后性:改的人用中文手机,测的人用英文模拟器,真正出问题的却是台湾仓库那台繁体设备。等到用户截图来问,返工成本已经是当初的几倍。

三个高频问答

问:英文目录明明有 app_name,为什么桌面还是中文?答:桌面读的可能是启动 Activity 或 activity-alias 的 label,不是 application 的 app_name。检查 app_name_launcher、app_name_alias 在英文目录里是否存在;缺了就会回退默认语言。

问:台湾设备显示的还是上一版名字,是不是缓存?答:先看 values-zh-rTW 里的键有没有改。很多包只改了默认和英文,繁体目录留着旧值;这不是缓存,是资源本身没更新。确认资源后再清启动器缓存。

问:香港设备显示简体,怎么修?答:检查有没有 values-zh。语言级目录会接住所有中文设备,包括香港;要显示繁体,需要 values-zh-rHK 或 values-b+zh+Hant 这样的更具体目录。只建 values-zh-rTW 不一定覆盖香港。

“英文版上线前,桌面还是中文名,设置里却是英文,尴尬得不行。查下来是 values-en 漏了 app_name_launcher。现在改名必须过一遍键表,缺哪个键一眼就能看到。”
—— 阿珊 · 出海应用运营
“我们台湾仓和香港仓用的是同一个包,以前只做了一套繁体,香港同事总说看到简体。后来补了 values-zh-rHK,两边终于各看各的。”
—— 老吴 · 企业移动应用运维
“最坑的是字符串数组,只翻了前两项,菜单里中简混排。后来把数组按 item 列进对照表,翻译和验收都按行勾,再没漏过。”
—— 小唐 · 独立开发者
“很多编译错误不是翻译错,是格式错:撇号没转义、占位符没序号、首尾空格没加引号。把这三条写进交付说明,返工少了一大半。”
—— 林姐 · 本地化译者
“多语言回退是按关键字走的,不是整份文件切。理解这一点之后,看到“半汉半英”就知道去缺键的目录找,不会再去怀疑系统。”
—— 老周 · 安卓逆向爱好者

多语言改名这件事,难的从来不是“把中文换成英文”,而是“让每一个键在每一个语言目录里都有正确的值”。values 是兜底,values-en 是语言级覆盖,values-zh-rTW 和 values-zh-rHK 是地区细化,b+zh+Hant 是脚本兜底;application label 和 activity label 各走各的引用;切完语言,桌面、最近任务、快捷方式、通知渠道各有各的缓存。把这些当成一张表,按行填,按列查,就不会在“改了怎么还不变”里打转。

安卓修改大师智改工坊 旗下的 安卓修改大师电脑版 能帮你做的是:把 APK 拖进来,用一句中文说清楚要改哪些键、覆盖哪些语言,附件里放好对照表和截图,让 AI 一次改完默认、英文、繁体资源;改完自动回编、对齐、签名,再用 adb 装到设备上拉起,切语言就能对照。产品介绍在 https://www.apkeditor.cn/ai-version.aspx,官网是 www.apkeditor.cn。

只需说话,就能让应用变成你想要的样子。前提是这句话里说清楚“哪些键、哪些语言”;说全了,一次就能改齐。

最后提醒:本文的改包与多语言资源修改操作,仅适用于自有版权或已获授权的应用,用于学习、研究、企业内测等合法场景;请勿用于冒充他人应用、混淆来源或绕过安全机制。应用名是用户识别产品的第一行字,改自己的名字是维护,改别人的名字是侵权。

DOWNLOAD
安卓修改大师智能修改安卓版

手机、平板直接安装,导入 APK 后说一句话,自动反编译、修改、回编、对齐、签名;也能把网址打包成应用,成品可装、可存、可分享。

立即下载安卓版 / 查看详情 →

官网 www.apkeditor.cn · 请仅修改自有版权或已获授权的应用