将阿拉伯语列为实验性支持语言 (#4851)

Author: Glavo

HMCL/src/main/java/org/jackhuang/hmcl/util/i18n/I18n.java

@@ -45,11 +45,11 @@ public static SupportedLocale getLocale() {
     }
 
     public static boolean isUpsideDown() {
-        return LocaleUtils.getScript(locale.getLocale()).equals("Qabs");
+        return LocaleUtils.getScript(locale.getDisplayLocale()).equals("Qabs");
     }
 
     public static boolean isUseChinese() {
-        return LocaleUtils.isChinese(locale.getLocale());
+        return LocaleUtils.isChinese(locale.getDisplayLocale());
     }
 
     public static ResourceBundle getResourceBundle() {

HMCL/src/main/java/org/jackhuang/hmcl/util/i18n/SupportedLocale.java

@@ -42,6 +42,10 @@
 public final class SupportedLocale {
     public static final SupportedLocale DEFAULT = new SupportedLocale();
 
+    public static boolean isExperimentalSupported(Locale locale) {
+        return "ar".equals(locale.getLanguage());
+    }
+
     private static final ConcurrentMap<Locale, SupportedLocale> LOCALES = new ConcurrentHashMap<>();
 
     public static List<SupportedLocale> getSupportedLocales() {
@@ -51,7 +55,11 @@ public static List<SupportedLocale> getSupportedLocales() {
         InputStream locales = SupportedLocale.class.getResourceAsStream("/assets/lang/languages.json");
         if (locales != null) {
             try (locales) {
-                list.addAll(JsonUtils.fromNonNullJsonFully(locales, JsonUtils.listTypeOf(SupportedLocale.class)));
+                for (SupportedLocale locale : JsonUtils.fromNonNullJsonFully(locales, JsonUtils.listTypeOf(SupportedLocale.class))) {
+                    if (!isExperimentalSupported(locale.getLocale())) {
+                        list.add(locale);
+                    }
+                }
             } catch (Throwable e) {
                 LOG.warning("Failed to load languages.json", e);
             }
@@ -73,6 +81,7 @@ public static SupportedLocale getLocaleByName(String name) {
     private final boolean isDefault;
     private final String name;
     private final Locale locale;
+    private final Locale displayLocale;
     private final TextDirection textDirection;
 
     private ResourceBundle resourceBundle;
@@ -85,16 +94,23 @@ public static SupportedLocale getLocaleByName(String name) {
         this.name = "def"; // TODO: Change to "default" after updating the Config format
 
         String language = System.getenv("HMCL_LANGUAGE");
-        this.locale = StringUtils.isBlank(language)
-                ? LocaleUtils.SYSTEM_DEFAULT
-                : Locale.forLanguageTag(language);
+        if (StringUtils.isBlank(language)) {
+            this.locale = LocaleUtils.SYSTEM_DEFAULT;
+            this.displayLocale = isExperimentalSupported(this.locale)
+                    ? Locale.ENGLISH
+                    : this.locale;
+        } else {
+            this.locale = Locale.forLanguageTag(language);
+            this.displayLocale = this.locale;
+        }
         this.textDirection = LocaleUtils.getTextDirection(locale);
     }
 
     SupportedLocale(Locale locale) {
         this.isDefault = false;
         this.name = locale.toLanguageTag();
         this.locale = locale;
+        this.displayLocale = locale;
         this.textDirection = LocaleUtils.getTextDirection(locale);
     }
 
@@ -110,6 +126,15 @@ public Locale getLocale() {
         return locale;
     }
 
+    /// Used to represent the text display language of HMCL.
+    ///
+    /// Usually equivalent to [#getLocale()],
+    /// but for [experimentally supported languages][#isExperimentalSupported(Locale)],
+    /// it falls back to ENGLISH by default.
+    public Locale getDisplayLocale() {
+        return displayLocale;
+    }
+
     public TextDirection getTextDirection() {
         return textDirection;
     }
@@ -167,7 +192,7 @@ public String getDisplayName(SupportedLocale inLocale) {
     public ResourceBundle getResourceBundle() {
         ResourceBundle bundle = resourceBundle;
         if (resourceBundle == null)
-            resourceBundle = bundle = ResourceBundle.getBundle("assets.lang.I18N", locale,
+            resourceBundle = bundle = ResourceBundle.getBundle("assets.lang.I18N", displayLocale,
                     DefaultResourceBundleControl.INSTANCE);
 
         return bundle;
@@ -176,15 +201,15 @@ public ResourceBundle getResourceBundle() {
     public ResourceBundle getLocaleNamesBundle() {
         ResourceBundle bundle = localeNamesBundle;
         if (localeNamesBundle == null)
-            localeNamesBundle = bundle = ResourceBundle.getBundle("assets.lang.LocaleNames", locale,
+            localeNamesBundle = bundle = ResourceBundle.getBundle("assets.lang.LocaleNames", displayLocale,
                     DefaultResourceBundleControl.INSTANCE);
 
         return bundle;
     }
 
     public List<Locale> getCandidateLocales() {
         if (candidateLocales == null)
-            candidateLocales = List.copyOf(LocaleUtils.getCandidateLocales(locale));
+            candidateLocales = List.copyOf(LocaleUtils.getCandidateLocales(displayLocale));
         return candidateLocales;
     }
 

HMCL/src/main/java/org/jackhuang/hmcl/util/i18n/translator/Translator.java

@@ -28,19 +28,19 @@
 /// @author Glavo
 public class Translator {
     protected final SupportedLocale supportedLocale;
-    protected final Locale locale;
+    protected final Locale displayLocale;
 
     public Translator(SupportedLocale supportedLocale) {
         this.supportedLocale = supportedLocale;
-        this.locale = supportedLocale.getLocale();
+        this.displayLocale = supportedLocale.getDisplayLocale();
     }
 
     public final SupportedLocale getSupportedLocale() {
         return supportedLocale;
     }
 
-    public final Locale getLocale() {
-        return locale;
+    public final Locale getDisplayLocale() {
+        return displayLocale;
     }
 
     public String getDisplayVersion(RemoteVersion remoteVersion) {