优化代码逻辑嵌套

优化 Locale 对象处理逻辑
开放是否跟随系统的语种的 API
修复 Application 语种不同步的问题

Author: getActivity

MultiLanguages.apk

@@ -1,4 +1,4 @@
-# 多语种适配框架
+# 语种切换框架
 
 * 码云地址：[Gitee](https://gitee.com/getActivity/MultiLanguages)
 
@@ -10,34 +10,33 @@
 
 ```groovy
 dependencies {
-    // 国际化框架：https://github.com/getActivity/MultiLanguages
-    implementation 'com.hjq:language:6.0'
+    // 语种切换框架：https://github.com/getActivity/MultiLanguages
+    implementation 'com.hjq:language:6.5'
 }
 ```
 
-#### 初始化框架
-
+#### 初始化框架
+
 * 在 Application 中初始化框架
 
-```java
-public final class XxxApplication extends Application {
-
-    @Override
-    public void onCreate() {
-        super.onCreate();
-        // 初始化多语种框架（自动适配第三方库中 Activity 语种）
-        MultiLanguages.init(this);
-    }
-}
+```java
+public final class XxxApplication extends Application {
 
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        // 初始化语种切换框架（自动适配第三方库中 Activity 语种）
+        MultiLanguages.init(this);
+    }
+}
 ```
 
 * 重写 Application 的 attachBaseContext 方法
 
 ```java
 @Override
 protected void attachBaseContext(Context base) {
-    // 国际化适配（绑定语种）
+    // 绑定语种
     super.attachBaseContext(MultiLanguages.attach(base));
 }
 ```
@@ -47,7 +46,7 @@ protected void attachBaseContext(Context base) {
 ```java
 @Override
 protected void attachBaseContext(Context newBase) {
-    // 国际化适配（绑定语种）
+    // 绑定语种
     super.attachBaseContext(MultiLanguages.attach(newBase));
 }
 ```
@@ -62,15 +61,17 @@ MultiLanguages.setAppLanguage(Context context, Locale locale);
 
 // 获取当前的语种
 MultiLanguages.getAppLanguage();
-```
-
+```
+
 #### 其他 API
 
 ```java
 // 将 App 语种设置为系统语种（返回 true 需要重启 App）
 MultiLanguages.setSystemLanguage(Context context);
 // 获取系统的语种
 MultiLanguages.getSystemLanguage();
+// 是否跟随系统的语种
+MultiLanguages.isSystemLanguage();
 
 // 对比两个语言是否是同一个语种（比如：中文的简体和繁体，英语的美式和英式）
 MultiLanguages.equalsLanguage(Locale locale1, Locale locale2);
@@ -80,30 +81,30 @@ MultiLanguages.equalsCountry(Locale locale1, Locale locale2);
 // 获取某个语种下的 String
 MultiLanguages.getLanguageString(Context context, Locale locale, int stringId);
 // 获取某个语种下的 Resources 对象
-MultiLanguages.getLanguageResources(Context context, Locale locale);
-
-// 更新 Context 的语种
-MultiLanguages.updateAppLanguage(Context context);
-// 更新 Resources 的语种
+MultiLanguages.getLanguageResources(Context context, Locale locale);
+
+// 更新 Context 的语种
+MultiLanguages.updateAppLanguage(Context context);
+// 更新 Resources 的语种
 MultiLanguages.updateAppLanguage(Resources resources);
-```
-
-#### 语种变化监听器
-
-```java
-// 设置语种变化监听器
-MultiLanguages.setOnLanguageListener(new OnLanguageListener() {
-
-    @Override
-    public void onAppLocaleChange(Locale oldLocale, Locale newLocale) {
-        Log.d("MultiLanguages", "监听到应用切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale);
-    }
-
-    @Override
-    public void onSystemLocaleChange(Locale oldLocale, Locale newLocale) {
-        Log.d("MultiLanguages", "监听到系统切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale);
-    }
-});
+```
+
+#### 语种变化监听器
+
+```java
+// 设置语种变化监听器
+MultiLanguages.setOnLanguageListener(new OnLanguageListener() {
+
+    @Override
+    public void onAppLocaleChange(Locale oldLocale, Locale newLocale) {
+        Log.d("MultiLanguages", "监听到应用切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale);
+    }
+
+    @Override
+    public void onSystemLocaleChange(Locale oldLocale, Locale newLocale) {
+        Log.d("MultiLanguages", "监听到系统切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale + "，是否跟随系统：" + MultiLanguages.isSystemLanguage());
+    }
+});
 ```
 
 #### 使用案例
@@ -142,29 +143,29 @@ public void onClick(View v) {
         finish();
     }
 }
-```
-
-#### WebView 导致语种失效的解决方案
-
-* 由于 WebView 初始化会修改 Activity 语种配置，间接导致 Activity 语种会被还原回去，所以需要你手动重写 WebView 对这个问题进行修复
-
-```java
-public final class LanguagesWebView extends WebView {
-
-    public LanguagesWebView(@NonNull Context context) {
-        this(context, null);
-    }
-
-    public LanguagesWebView(@NonNull Context context, @Nullable AttributeSet attrs) {
-        this(context, attrs, 0);
-    }
-
-    public LanguagesWebView(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
-        super(context, attrs, defStyleAttr);
-        // 修复 WebView 初始化时会修改 Activity 语种配置的问题
-        MultiLanguages.updateAppLanguage(context);
-    }
-}
+```
+
+#### WebView 导致语种失效的解决方案
+
+* 由于 WebView 初始化会修改 Activity 语种配置，间接导致 Activity 语种会被还原回去，所以需要你手动重写 WebView 对这个问题进行修复
+
+```java
+public final class LanguagesWebView extends WebView {
+
+    public LanguagesWebView(@NonNull Context context) {
+        this(context, null);
+    }
+
+    public LanguagesWebView(@NonNull Context context, @Nullable AttributeSet attrs) {
+        this(context, attrs, 0);
+    }
+
+    public LanguagesWebView(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        // 修复 WebView 初始化时会修改 Activity 语种配置的问题
+        MultiLanguages.updateAppLanguage(context);
+    }
+}
 ```
 
 #### 其他资源：[语言代码列表大全](https://github.com/championswimmer/android-locales)
@@ -187,12 +188,12 @@ public final class LanguagesWebView extends WebView {
 
 * 日志查看框架：[Logcat](https://github.com/getActivity/Logcat)
 
-#### Android技术讨论Q群：78797078
-
 #### 微信公众号：Android轮子哥
 
 ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/official_ccount.png)
 
+#### Android 技术分享 QQ 群：78797078
+
 #### 如果您觉得我的开源库帮你节省了大量的开发时间，请扫描下方的二维码随意打赏，要是能打赏个 10.24 :monkey_face:就太:thumbsup:了。您的支持将鼓励我继续创作:octocat:
 
 ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/pay_ali.png) ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/pay_wechat.png)
@@ -215,4 +216,4 @@ 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.
-```
+```

README.md

@@ -7,8 +7,8 @@ android {
         applicationId "com.hjq.language.demo"
         minSdkVersion 16
         targetSdkVersion 30
-        versionCode 60
-        versionName "6.0"
+        versionCode 65
+        versionName "6.5"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {
@@ -26,9 +26,9 @@ dependencies {
     implementation 'androidx.appcompat:appcompat:1.2.0'
     implementation 'com.google.android.material:material:1.2.1'
 
-    // 标题栏：https://github.com/getActivity/TitleBar
+    // 标题栏框架：https://github.com/getActivity/TitleBar
     implementation 'com.hjq:titlebar:8.2'
-    // 吐司工具类：https://github.com/getActivity/ToastUtils
+    // 吐司框架：https://github.com/getActivity/ToastUtils
     implementation 'com.hjq:toast:8.8'
     // 内存泄漏捕捉：https://github.com/square/leakcanary
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.5'

app/.gitignore

@@ -17,7 +17,7 @@
         tools:targetApi="q">
 
         <activity
-            android:name=".LanguageActivity">
+            android:name=".MainActivity">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
                 <action android:name="android.intent.action.VIEW" />

app/build.gradle

@@ -35,14 +35,14 @@ public void onAppLocaleChange(Locale oldLocale, Locale newLocale) {
 
             @Override
             public void onSystemLocaleChange(Locale oldLocale, Locale newLocale) {
-                Log.d("MultiLanguages", "监听到系统切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale);
+                Log.d("MultiLanguages", "监听到系统切换了语种，旧语种：" + oldLocale + "，新语种：" + newLocale + "，是否跟随系统：" + MultiLanguages.isSystemLanguage());
             }
         });
     }
 
     @Override
     protected void attachBaseContext(Context newBase) {
-        // 国际化适配（绑定语种）
+        // 绑定语种
         super.attachBaseContext(MultiLanguages.attach(newBase));
     }
 }

app/src/main/AndroidManifest.xml

@@ -16,7 +16,7 @@ public abstract class BaseActivity extends AppCompatActivity {
 
     @Override
     protected void attachBaseContext(Context newBase) {
-        // 国际化适配（绑定语种）
+        // 绑定语种
         super.attachBaseContext(MultiLanguages.attach(newBase));
     }
 }