android-frame/frame/locale/CLAUDE.md

Locale 模块

模块概述

Locale 模块提供多语言本地化支持功能，包括动态语言切换、文本资源管理、区域设置和RTL布局支持等功能。

主要功能

1. 多语言支持

• 动态语言切换: 应用内实时切换语言
• 资源自动适配: 根据语言自动加载对应资源
• 系统语言检测: 自动检测并适配系统语言
• 自定义语言包: 支持加载远程语言资源

2. 区域设置

• 地区适配: 支持不同地区的格式差异
• 货币格式: 自动适配当地货币格式
• 日期时间: 本地化的日期时间显示
• 数字格式: 数字和小数点格式本地化

3. RTL 布局支持

• 右到左布局: 支持阿拉伯语等RTL语言
• 镜像布局: 自动镜像UI布局方向
• 文本对齐: RTL语言的文本对齐处理

4. 文本处理

• 复数形式: 支持不同语言的复数规则
• 性别变化: 支持语言的性别变化形式
• 文本插值: 动态文本内容填充
• 格式化: 本地化的文本格式化

核心接口

interface LocaleService {
    fun setLocale(locale: Locale)
    fun getCurrentLocale(): Locale
    fun getSupportedLocales(): List<Locale>
    fun getString(resId: Int, vararg args: Any): String
    fun isRTL(): Boolean
}

使用方式

// 设置语言
LocaleService.setLocale(Locale.ENGLISH)
LocaleService.setLocale(Locale.CHINESE)

// 获取本地化字符串
val text = LocaleService.getString(R.string.hello_world, userName)

// 检查是否为RTL语言
if (LocaleService.isRTL()) {
    // 调整RTL布局
}

// 获取支持的语言列表
val supportedLocales = LocaleService.getSupportedLocales()

配置示例

<!-- 多语言资源配置 -->
<!-- values/strings.xml -->
<string name="hello">Hello</string>

<!-- values-zh/strings.xml -->
<string name="hello">你好</string>

<!-- values-ar/strings.xml -->
<string name="hello">مرحبا</string>

构建配置

implementation "com.wenext.android:frame-locale:6.0.0"