• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Globalization Subsystem Changelog
2
3## cl.global.1 Language Sorting Array Change
4
5**Access Level**
6
7System API
8
9**Reason for Change**
10
11The sequence of the language list array returned by the **getLanguageInfoArray** API is incorrect. For example, if the country/region is **CN**, Simplified Chinese (zh-Hans), Tibetan (bo), and Uyghur (ug) should be placed in the front.
12
13**Change Impact**
14
15The sequence of the language list array is changed.
16
17Before:
18
19| Country/Region             | Input Parameter     | Array Sequence  |
20| --------------- | ------- | -------- |
21| CN                    | en,zh-Hans,bo,ug,zh-Hant       |   zh-Hans,en,bo,ug,zh-Hant  |
22| SG                    | bo,en,zh-Hans,ug,zh-Hant |   zh-Hans,en,bo,ug,zh-Hant  |
23| US                    | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
24| HK               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
25| TW               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
26| AU               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
27| NZ               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
28| IN               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
29| GB               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
30| MO               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
31| CA               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
32
33After:
34
35| Country/Region             | Input Parameter     | Array Sequence  |
36| --------------- | ------- | -------- |
37| CN                    | en,zh-Hans,bo,ug,zh-Hant       |   zh-Hans,ug,bo,zh-Hant,en  |
38| SG                    | bo,en,zh-Hans,ug,zh-Hant |   en,zh-Hant,zh-Hans,ug,bo  |
39| US                    | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
40| HK               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,en,zh-Hans,ug,bo  |
41| TW               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,zh-Hans,en,ug,bo  |
42| AU               | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
43| NZ               | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
44| IN               | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
45| GB               | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
46| MO               | zh-Hans,bo,en,ug,zh-Hant       |   zh-Hant,en,zh-Hans,ug,bo  |
47| CA               | zh-Hans,bo,en,ug,zh-Hant       |   en,zh-Hant,zh-Hans,ug,bo  |
48
49**Start API Level**
50
5110
52
53**Change Since**
54
55OpenHarmony SDK 5.1.0.48
56
57**Key API/Component Changes**
58
59i18n.SystemLocaleManager.getLanguageInfoArray
60
61**Adaptation Guide**
62
63Use this API in the language list sorting scenario.
64
65## cl.global.2 Country/Region Sorting Array Change
66
67**Access Level**
68
69System API
70
71**Reason for Change**
72
73The sequence of the country/region list array returned by the **getRegionInfoArray** API is incorrect. For example, if the system language is simplified Chinese, only China is displayed in the front.
74
75**Change Impact**
76
77The sequence of the country/region list returned by the API is changed.
78
79Before:
80
81| System Language             | Input Parameter     | Array Sequence  |
82| --------------- | ------- | -------- |
83| en               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   US,AU,CA,IN,NZ,SG,GB,CN,HK,MO,TW  |
84| zh-Hant          | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   TW,HK,MO,CN,CA,IN,US,GB,NZ,SG,AU  |
85| zh-Hans          | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   SG,CN,MO,HK,AU,CA,US,NZ,IN,GB,TW  |
86| ug               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   US,AU,GB,CN,MO,TW,HK,SG,CA,IN,NZ  |
87| bo               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   CN,TW,HK,MO,CA,NZ,GB,SG,IN,US,AU  |
88
89After:
90
91| System Language             | Input Parameter     | Array Sequence  |
92| --------------- | ------- | -------- |
93| en               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   AU,CA,IN,NZ,SG,GB,US,CN,HK,MO,TW  |
94| zh-Hant          | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   TW,HK,CN,MO,CA,IN,US,GB,NZ,SG,AU  |
95| zh-Hans          | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   CN,AU,CA,US,SG,NZ,IN,GB,MO,TW,HK  |
96| ug               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   CN,US,AU,GB,MO,TW,HK,SG,CA,IN,NZ  |
97| bo               | HK,TW,CN,AU,CA,IN,NZ,SG,GB,US,MO       |   CN,TW,HK,MO,CA,NZ,GB,SG,IN,US,AU  |
98
99**Start API Level**
100
10110
102
103**Change Since**
104
105OpenHarmony SDK 5.1.0.48
106
107**Key API/Component Changes**
108
109i18n.SystemLocaleManager.getRegionInfoArray
110
111**Adaptation Guide**
112
113Use this API in the country/region list sorting scenario.
114
115## cl.global.3 Language and Country/Region Mapping Change
116
117**Access Level**
118
119Public API
120
121**Reason for Change**
122
123The language and country/region matching rule is incorrect. For example, if the country/region is CN (China) and the language list contains zh-Hans (Simplified Chinese) and ug (Uyghur), the recommended language should be zh-Hans or ug. However, when the country/region is set to **CN** and the language is set to **ug**, the **isSuggested** API returns **false**, and the recommended language contains only **zh-Hans**.
124
125**Change Impact**
126
127This change does not require application adaptation.
128
129Before:
130
131| Language             | Country/Region     | Return Value  |
132| --------------- | ------- | -------- |
133| bo                | CN       |   false  |
134| en                | AE,AF,AG,AI,AL,AS,AT,AU,BB,BE,BI,BM,BS,BW,BZ,CA,CC,CH,CK,CM,<br>CX,CY,DE,DG,DK,DM,ER,FI,FJ,FK,FM,GB,GD,GG,GH,GI,GM,GU,GY,HK,<br>IE,IL,IM,IN,IO,IR,JE,JM,KE,KI,KN,KY,LC,LR,LS,MG,MH,MO,MP,MS,<br>MT,MU,MV,MW,MY,NA,NF,NG,NL,NR,NU,NZ,PG,PH,PK,PN,PR,PW,RW,SB,<br>SC,SD,SE,SG,SH,SI,SL,SS,SX,SZ,TC,TJ,TK,TM,TO,TT,TV,TZ,UG,UM,<br>VC,VG,VI,VU,WS,ZA,ZM,ZW       |   false  |
135| ug                | CN       |   false  |
136| zh-Hans                | HK,SG,MO       |   true  |
137
138After:
139
140| Language             | Country/Region     | Return Value  |
141| --------------- | ------- | -------- |
142| bo                | CN       |   true  |
143| en                | AE,AF,AG,AI,AL,AS,AT,AU,BB,BE,BI,BM,BS,BW,BZ,CA,CC,CH,CK,CM,<br>CX,CY,DE,DG,DK,DM,ER,FI,FJ,FK,FM,GB,GD,GG,GH,GI,GM,GU,GY,HK,<br>IE,IL,IM,IN,IO,IR,JE,JM,KE,KI,KN,KY,LC,LR,LS,MG,MH,MO,MP,MS,<br>MT,MU,MV,MW,MY,NA,NF,NG,NL,NR,NU,NZ,PG,PH,PK,PN,PR,PW,RW,SB,<br>SC,SD,SE,SG,SH,SI,SL,SS,SX,SZ,TC,TJ,TK,TM,TO,TT,TV,TZ,UG,UM,<br>VC,VG,VI,VU,WS,ZA,ZM,ZW       |   true  |
144| ug                | CN       |   true  |
145| zh-Hans                | HK,SG,MO       |   false  |
146
147**Start API Level**
148
1499
150
151**Change Since**
152
153OpenHarmony SDK 5.1.0.48
154
155**Key API/Component Changes**
156
157i18n.System.isSuggested
158
159**Adaptation Guide**
160
161No adaptation is required.
162