0

0

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

月夜之吻

月夜之吻

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

|

844人浏览过

|

来源于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-rTWvalues-zh-rHKvalues-zh-Hansvalues-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。

Rezi.ai
Rezi.ai

一个使用 AI 自动化创建简历平台

下载

性能影响:每次调用 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,而且必须确保 ApplicationActivity 没缓存旧的 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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

445

2023.08.07

json是什么
json是什么

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

544

2023.08.23

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

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

322

2023.10.13

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

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

81

2025.09.10

string转int
string转int

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

830

2023.08.02

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

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

169

2023.12.20

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

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

199

2023.11.20

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

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

866

2023.07.31

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1030

2026.02.13

热门下载

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

精品课程

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

共162课时 | 18.6万人学习

Java 教程
Java 教程

共578课时 | 70.9万人学习

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

共64课时 | 6.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号