讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Android Strings.xml多语言配置 安卓应用国际化xml写法

冬墨酱_9755

冬墨酱_9755

发布时间:2026-02-23 10:48:11

|

1024人浏览过

|

来源于php中文网

原创

Android多语言需严格遵循BCP 47标准路径(如values-zh-rCN),用AS向导创建;strings.xml中格式字符串用CDATA+getText(),复数需先getQuantityString再String.format;动态换语言须recreate()或AppCompatDelegate.setApplicationLocales()。

android strings.xml多语言配置 安卓应用国际化xml写法

strings.xml 里怎么写多语言字符串才不被系统忽略

Android 只认 res/values-xx/strings.xml 这种路径结构,放错目录等于没写。比如把中文繁体资源放在 res/values-zh-Hant/ 是对的,但写成 res/values-zh-TW/(虽然某些旧设备能 fallback)——在 Android 12+ 上可能直接不加载。

常见错误现象:getString(R.string.xxx) 返回空字符串或默认语言内容,debug 时发现 Configuration.getLocales().get(0) 显示的是 zh-CN,但 app 却没走 values-zh-rCN 目录。

  • 必须用 BCP 47 标准命名:简体中文是 values-zh-rCN,繁体中文是 values-zh-rTW 或 values-zh-rHK;values-zh-Hans 和 values-zh-Hant 是兼容写法,但仅限 Android 7.0+,低版本会 fallback 到 values
  • 不要手动拼接 locale 字符串去创建目录名,用 Android Studio 的 “New → Values resource file” 向导选语言和地区,它会自动生成合规路径
  • 所有语言版本的 strings.xml 必须有完全一致的 name 属性值,缺一个 key,运行时就用默认 values/strings.xml 里的,不会报错也不会警告

带格式的字符串(如 HTML 标签)在多语言中怎么安全转义

直接写 <b>重要</b> 在 strings.xml 里会导致 getText() 渲染出原始标签,而 getString() 又会把 < 当普通文本——这不是 bug,是设计如此。

使用场景:按钮文字含强调词、提示语带换行或颜色标记。

  • 需要保留格式时,统一用 CDATA 包裹:
    <string name="hint"><![CDATA[请<strong>立即</strong>检查 <br/>网络连接]]></string>
    然后在代码里用 getText(R.string.hint)(不是 getString)
  • 如果必须用 getString()(比如传给第三方 SDK),就得手动转义:写成 <b>重要</b>,再用 Html.fromHtml(str, Html.FROM_HTML_MODE_COMPACT) 解析(注意 API 24+ 参数不同)
  • 别在 CDATA 里写未转义的双引号或单引号,否则 XML 解析失败;像 "点击这里" 应写成 "点击这里"

复数字符串(plurals)和带占位符的字符串混用时的坑

<plurals></plurals> 本身不支持 %1$s 这类占位符,硬写进去会导致运行时报 IllegalArgumentException: can't find beginning of tag 或静默 fallback 到 other。

Android Control
Android Control

通过命令行工具(uiautomator、screencap、input、am)控制安卓设备。优先尝试非 root 执行,失败后自动回退至 root...

下载

性能影响:每次调用 getQuantityString() 都要解析整个 <plurals></plurals> 块,如果还嵌套了复杂逻辑,比纯 getString() 慢 2–3 倍(实测 Nexus 5X 上平均高 0.8ms)。

  • 正确做法是先用 getQuantityString(R.plurals.xxx, count) 拿到模板字符串(如 %d 个文件已删除),再用 String.format() 填充变量
  • 如果变量本身也要翻译(比如单位“GB”在不同语言里缩写不同),那就不能依赖 String.format(),得拆成两个 string:一个 plural 模板(不含单位),一个单位字符串(单独定义并翻译)
  • 注意 count 参数必须是非负整数,传负数会强制 fallback 到 other,且不报错

动态切换语言后 strings.xml 不刷新的典型原因

调用 Resources.getSystem().getConfiguration().setLocale() 没用,这是系统资源,不是你 app 的。真正生效要重建 Activity,而且必须确保 Application 或 Activity 没缓存旧的 Resources 实例。

容易踩的坑:以为改了 Configuration 就立刻全局生效,结果 Fragment 里 getString() 还是旧语言。

  • 切语言后必须调用 recreate()(Activity)或 requireActivity().recreate()(Fragment),不能只改 Context 的 Configuration
  • 如果用了 androidx.appcompat:appcompat 1.6.1+,推荐用 AppCompatDelegate.setApplicationLocales(),它会自动处理进程级 locale 设置和 Activity 重建
  • 自定义 View 如果缓存了 context.getString() 结果,切换后不会自动更新,得监听 onConfigurationChanged 并重设文本

最麻烦的其实是资源压缩:AGP 8.0+ 默认开启 shrinkResources true,如果某个语言的 string 只在动态代码里引用(比如通过反射或 JSON 配置加载),R8 可能把它整个删掉——这时候连 values-zh-rCN/strings.xml 文件都进不了 APK。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2315

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3802

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1256

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4419

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7439

2023.08.02

resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.12.20

counta和count的区别
counta和count的区别

Count函数用于计算指定范围内数字的个数,而CountA函数用于计算指定范围内非空单元格的个数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3868

2023.11.20

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1849

2023.07.31

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 45.6万人学习

Java 教程
Java 教程

共578课时 | 198.4万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn