前段时间我们团队准备把应用推向海外市场。原本以为只要把代码里写死的中文字符串抽离成资源文件就能搞定。结果海外测试同事反馈,说把系统语言切成阿拉伯语之后,我们的应用不仅文字全变成了乱码,甚至整个界面的排版都左右反转了(因为阿拉伯语是从右向左阅读的)。

这就逼着我们必须从底层重新梳理鸿蒙的资源管理机制。国际化(i18n)绝不是翻译几段文字那么简单,它涉及到了资源限定词、布局方向以及动态语言切换的深水区。
(配图建议:手机设置中的语言选择界面截图)

解析资源限定词目录的层级结构

在鸿蒙的工程目录中,resources 文件夹下可以建立多套语言资源目录。比如 zh_CN 代表简体中文,en_US 代表美式英语,ar_AE 代表阿拉伯语。

json

// resources/zh_CN/element/string.json
{
  "string": [
    { "name": "welcome_text", "value": "欢迎光临" }
  ]
}

// resources/en_US/element/string.json
{
  "string": [
    { "name": "welcome_text", "value": "Welcome" }
  ]
}

在 ArkUI 中,我们必须抛弃所有硬编码的字符串,全部使用 $r 语法去动态读取。当系统语言切换时,鸿蒙底层的资源管理器会自动根据当前的语言环境去匹配对应的 JSON 文件。

typescript

@Entry
@Component
struct WelcomePage {
  build() {
    Column() {
      // 核心动作:通过 $r 动态解析字符串资源
      Text($r('app.string.welcome_text'))
        .fontSize(24)
    }
  }
}

执行结果就是,当用户的手机系统语言是英文时,这里会自动显示 "Welcome"。

处理从右向左(RTL)的镜像布局

阿拉伯语和希伯来语等语言,其阅读习惯是从右向左的。如果你把界面写死了左对齐,在这些国家就显得极其怪异。

ArkUI 在底层通过 Direction 属性自动处理了这种反转。但前提是,你不能用绝对定位去写布局。

typescript

Row() {
  Image($r('app.media.icon_arrow'))
    .width(20)
  Text($r('app.string.next_step'))
    // 警示:不要写死 marginLeft,要使用 marginStart
    .margin({ start: 10 }) 
}
// 开启自动镜像适配
.direction(Direction.Auto)

使用 start 和 end 替代 left 和 right。配合 Direction.Auto,系统会自动将水平方向的间距和排列顺序反转。这是极其优雅的底层实现。

在不重启应用的情况下动态切换语言

有时候,应用内会提供一个“语言设置”功能,允许用户不跟随系统语言,单独设置应用的语言。这在以前极其麻烦,需要重启整个应用。但在鸿蒙 7 中,我们可以通过应用级配置动态刷新。

我们需要监听用户的语言选择事件,并且调用系统的资源管理器重新加载配置。

typescript

import context from '@ohos.app.ability.common';

async function changeAppLanguage(languageTag: string) {
  const appContext = getContext(this) as context.ApplicationContext;
  
  try {
    // 核心警示:强制覆盖当前应用的语言环境
    await appContext.setColorMode(...); // 如果是暗黑模式则是这个
    // 修改语言配置
    appContext.config.setLocale(languageTag);
    
    // 触发 UI 重新渲染(视具体 API 而定,通常系统会自动刷新监听器)
    console.info(`应用语言已切换至:${languageTag}`);
  } catch (err) {
    console.error('语言切换失败', err);
  }
}

不过需要注意的是,由于资源限定词在底层是强缓存的,动态切换语言后,部分已经渲染完毕的复杂组件可能不会立刻刷新文本。最稳妥的工程做法是:在切换语言后,在 UI 线程执行一次 router.replaceUrl 重新加载当前页面栈。

规避资源缺失的降级策略

在翻译过程中,运营团队可能遗漏了某个新加字段的英文翻译。此时如果系统找不到对应的资源,页面可能会直接闪退或显示 undefined。

必须在工程的 resources/base 目录下保留一份兜底的默认语言(通常为中文)。当指定语言找不到时,资源管理器会优雅地降级读取默认目录,保证应用不崩溃。

综合来看,国际化是一项精细的工程。从资源解耦到布局方向适配,再到无感知的动态切换,每一步都考验着开发者对鸿蒙系统底层资源管理机制的理解深度。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐