Skip to content
Android Multi Languages Adaptation Framework
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

国际化框架

集成步骤

dependencies {
    implementation 'com.hjq:language:3.0'
}

初始化框架

// 在 Application 中初始化
LanguagesManager.init(this);

重写 Application 的 attachBaseContext 方法

@Override
protected void attachBaseContext(Context base) {
    // 国际化适配(绑定语种)
    super.attachBaseContext(LanguagesManager.attach(base));
}

重写基类 BaseActivity 的 attachBaseContext 方法

@Override
protected void attachBaseContext(Context newBase) {
    // 国际化适配(绑定语种)
    super.attachBaseContext(LanguagesManager.attach(newBase));
}

只要是 Context 的子类都需要重写,Service 也雷同,这里不再赘述

语种设置

// 设置当前的语种(返回 true 需要重启 App)
LanguagesManager.setAppLanguage(Context context, Locale locale);

// 获取当前的语种
LanguagesManager.getAppLanguage(Context context);

使用案例

@Override
public void onClick(View v) {
    // 是否需要重启
    boolean restart;
    switch (v.getId()) {
        // 跟随系统
        case R.id.btn_language_auto:
            restart = LanguagesManager.setSystemLanguage(this);
            break;
        // 简体中文
        case R.id.btn_language_cn:
            restart = LanguagesManager.setAppLanguage(this, Locale.CHINA);
            break;
        // 繁体中文
        case R.id.btn_language_tw:
            restart = LanguagesManager.setAppLanguage(this, Locale.TAIWAN);
            break;
        // 英语
        case R.id.btn_language_en:
            restart = LanguagesManager.setAppLanguage(this, Locale.ENGLISH);
            break;
        default:
            restart = false;
            break;
    }

    if (restart) {
        // 我们可以充分运用 Activity 跳转动画,在跳转的时候设置一个渐变的效果
        startActivity(new Intent(this, LanguageActivity.class));
        overridePendingTransition(R.anim.activity_alpha_in, R.anim.activity_alpha_out);
        finish();
    }
}

其他 API

// 将 App 语种设置为系统语种(返回 true 需要重启 App)
LanguagesManager.setSystemLanguage(Context context);
// 获取系统的语种
LanguagesManager.getSystemLanguage();

// 对比两个语言是否是同一个语种(比如:中文的简体和繁体,英语的美式和英式)
LanguagesManager.equalsLanguage(Locale locale1, Locale locale2);
// 对比两个语言是否是同一个地方的(比如:中国大陆用的中文简体,中国台湾用的中文繁体)
LanguagesManager.equalsCountry(Locale locale1, Locale locale2);

// 获取某个语种下的 String
LanguagesManager.getLanguageString(Context context, Locale locale, int stringId);
// 获取某个语种下的 Resources 对象
LanguagesManager.getLanguageResources(Context context, Locale locale);

混淆规则

-keep class com.hjq.language.** {*;}

作者的其他开源项目

Android技术讨论Q群:78797078

如果您觉得我的开源库帮你节省了大量的开发时间,请扫描下方的二维码随意打赏,要是能打赏个 10.24 🐵就太👍了。您的支持将鼓励我继续创作:octocat:

点击查看捐赠列表

License

Copyright 2019 Huang JinQun

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.