Tencent Cloud

Recent Pages

Android

最后更新时间：2024-05-20 15:02:11

功能描述
Android 端 TUIKit 默认自带 英语、简体中文 和 阿拉伯语 语言包，作为界面展示语言。
根据此文档指引，您可以使用默认语言包，也可自定义语言翻译表述和增加其他语言包。
说明：
TUIKit 从 7.5.4852 版本开始，新增 RTL 语言（文字方向从右到左的语言，比如阿拉伯语、希伯来语等）支持，当应用内语言为 RTL 语言时，TUIKit 会自动切换到 RTL 样式；同时内置语言新增了阿拉伯语。
英文
阿拉伯语
简体中文
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
﻿
使用自带语言
如果您的 App 需要的语言仅包括 英语、 阿拉伯语 和 简体中文，请参考本部分。
跟随系统语言
直接使用 TUIKit 即可，无需额外步骤。组件内部语言会跟随系统语言。
指定显示的语言
如果您需要指定 TUIKit 界面的语言，需要在 Appliction 初始化时调用以下代码进行设置，例如设置为中文：
public class MyApplication extends Application {
    @Override
    protected void onCreate() {
        super.onCreate();
        TUIThemeManager.getInstance().changeLanguage(this, TUIThemeManager.LANGUAGE_ZH_CN);
    }
﻿
    /**
    * The available language options are enumerated as follows:
    * TUIThemeManager.LANGUAGE_EN        ---- English
    * TUIThemeManager.LANGUAGE_ZH_CN     ---- Simplified Chinese
    * TUIThemeManager.LANGUAGE_AR        ---- Arabic
    */
}
注意
调用 changeLanguage 方法并不会自动刷新 UI，需要获取字符串之后重新设置到控件上才能生效。
动态修改语言
您可以参考 TUIKitDemo 的 LanguageSelectActivity.java 文件中的代码。也可以使用如下方法切换语言，例如切换为中文：
TUIThemeManager.getInstance().changeLanguage(context, TUIThemeManager.LANGUAGE_ZH_CN);
System.exit(0);
Intent intent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
context.startActivity(intent);
使用 WebView 之后发现语言切换失败处理方法
使用 WebView 之后导致语言切换失败是 Android 7 及以后版本的 bug，原因是 WebView 初始化时会修改 App 的语言为手机系统语言。需要在 TUIThemeManager.java 的 setThemeInternal 方法中调用以下代码解决此问题：
setWebViewLanguage(appContext);
添加之后：
private void setThemeInternal(Context context) {
    if (context == null) {
        return;
    }
﻿
    Context appContext = context.getApplicationContext();
    if (!isInit) {
        isInit = true;
        if (appContext instanceof Application) {
            ((Application) appContext).registerActivityLifecycleCallbacks(new ThemeAndLanguageCallback());
        }
﻿
        /**
        * add code here  begin
        */
        setWebViewLanguage(appContext);
        /**
        * add code here  end
        */
        Locale defaultLocale = getLocale(appContext);
        SPUtils spUtils = SPUtils.getInstance(SP_THEME_AND_LANGUAGE_NAME);
        currentLanguage = spUtils.getString(SP_KEY_LANGUAGE, defaultLocale.getLanguage());
        currentThemeID = spUtils.getInt(SP_KEY_THEME, THEME_LIGHT);
﻿
        // The language only needs to be initialized once
        applyLanguage(appContext);
    }
    // The theme needs to be updated multiple times
    applyTheme(appContext);
}
使用更多语言/自定义翻译表述
如果您的 App 需要支持更多语言，或更改部分词条的翻译，请参考本部分。
本章节以 TUIGroup 组件添加韩语语言包为例，讲解新增语言包和自定义翻译的流程。
新增语言资源文件
在 Android Studio 中的 TUIGroup 组件目录下，右键菜单中新增 Android Resource File：
﻿
输入文件名 strings，由 Locale 维度创建资源目录：
﻿
语言选择为韩语（"ko: Korean"），地区选为"KR: South Korea" ，点击确定，这样就创建好了韩语资源文件 values-ko-rKR/strings.xml。
﻿
个性化自定义翻译
上一步已经创建好了韩语资源文件 values-ko-rKR/strings.xml，现在把 values/strings.xml 文件中的内容复制到 values-ko-rKR/strings.xml，用韩语替换对应的英文，如图所示：
﻿
不同语言资源文件中语言的 name 是相同的，具体内容可以自定义翻译。
跟随系统语言
直接使用 TUIKit 即可，将手机默认语言设置为韩语后启动 App ，App 语言可以自动显示为韩语。
指定显示的语言
如果您需要指定 TUIKit 界面的语言为韩语，应该先在 Appliction 初始化时向语言管理器中添加韩语，然后再设置 TUIKit 界面的语言为韩语：
public class MyApplication extends Application {
    @Override
    protected void onCreate() {
        super.onCreate();
        // Add Korean
        TUIThemeManager.addLanguage("ko-rKR", Locale.KOREA);
        // Change the application language to Korean.
        TUIThemeManager.getInstance().changeLanguage(this, "ko-rKR");
    }
}
效果如图所示：
﻿
﻿
﻿
﻿