鸿蒙开发笔记：Localization Kit在美颜相机中的多语言适配

开发场景需求
在全球化发布的"拍摄美颜相机"应用中，Localization Kit需要解决：
界面文本动态切换：支持20+语言的UI显示
地域化功能适配：根据不同地区显示特色滤镜
本地化资源管理：日期/数字格式自动转换

// 核心实现与代码示例
// 多语言文本管理
// 资源文件结构：
text

resources/
  ├─ base/
  │   └─ element/string.json (默认英文)
  ├─ zh/
  │   └─ element/string.json (中文)
  ├─ ja/
  │   └─ element/string.json (日文)

// 字符串定义示例：
json

// zh/string.json
{
  "beauty_mode": "美颜模式",
  "filter_vintage": "复古滤镜"
}

// en/string.json 
{
  "beauty_mode": "Beauty Mode",
  "filter_vintage": "Vintage Filter"
}

// 运行时获取文本：
typescript

// 获取本地化字符串
import I18n from '@ohos.i18n';

Text($r('app.string.beauty_mode')) // 方式1：资源引用
  .fontSize(16)
  
// 动态切换语言
function changeLanguage(lang: string) {
  I18n.setSystemLanguage(lang);
  this.updateUI();
}

// 地域化功能适配
// 特色滤镜按地区显示：
typescript

// 根据地区加载不同滤镜
const region = I18n.getSystemRegion();
const regionalFilters = this.getFiltersByRegion(region);

private getFiltersByRegion(region: string): Filter[] {
  switch (region) {
    case 'CN': // 中国特供
      return [...defaultFilters, '中国风', '水墨'];
    case 'JP': // 日本特供
      return [...defaultFilters, '和风', '樱花'];
    default:
      return defaultFilters;
  }
}

// 日期时间格式化：
typescript

// 照片保存时间显示
const date = new Date();
const formattedDate = I18n.getDisplayDate(date, {
  dateStyle: 'long',
  timeStyle: 'short'
});
Text(formattedDate) // 示例："2023年12月31日 下午3:30"(中文)

// 数字/单位本地化
typescript

// 美颜强度百分比显示
const level = 75;
const formattedPercent = I18n.getDisplayPercent(level / 100); 

// 根据不同地区显示不同单位
function getDistanceUnit() {
  return I18n.getSystemRegion() === 'US' ? 'mile' : 'km';
}

// 关键优化策略
// 资源加载优化
typescript

// 预加载语言包
onAppInit() {
  I18n.initI18n();
  I18n.preloadLanguages(['en', 'zh', 'ja']);
}

// 动态切换无闪烁
typescript

// 使用ArkUI状态管理
@State currentLanguage: string = 'en';

build() {
  Column() {
    Text($r(`app.string.${this.currentLanguage}.beauty_mode`))
  }
}

// 回退机制
typescript

// 获取文本带默认值
function getLocalizedText(key: string) {
  try {
    return $r(`app.string.${key}`);
  } catch {
    return defaultTexts[key];
  }
}

// 长文本处理
typescript

// 德语等长语言UI适配
Text($r('app.string.long_desc'))
  .maxLines(3)
  .textOverflow({ overflow: TextOverflow.Ellipsis })

// 特殊语言布局
typescript

// 阿拉伯语RTL适配
Column() {
  Text($r('app.string.title'))
    .direction(
      I18n.isRTL() ? TextDirection.RTL : TextDirection.LTR
    )
}

// 动态内容本地化
typescript

// 用户生成内容翻译
async translateUGC(text: string) {
  if (I18n.getSystemLanguage() !== 'en') {
    return await Translator.translate(text);
  }
  return text;
}