SAP UI5 對多語言的支援特性如下：

> The language codes according to the de facto standard BCP-47, which are used by most browsers for language identification. As of JDK 1.7 they are also supported by the Java locale class.

目前大多數瀏覽器都支援了事實上的標準，BCP-47 裡定義的 language code，用來做語言識別。例子：de, en-US, zh-Hans-CN

> The Java Locale syntax that combines a lower case ISO 639 alpha-2 or alpha-3 language code with an ISO 3166 alpha-2 country code. Both codes are combined with an underscore. An arbitrary sequence of variant identifiers (also separated by underscores) can be appended as a third component.

另一方法，Java Locale 語法，使用 underscore，即下劃線，來連線 ISO 639 alpha-2 (或者alpha-3）以及 ISO 3166 alpha-2 (或者alpha-3）, 前者指代 language code，後者指代 country code. 同時，這兩部分之後，可以再透過下劃線，連線額外的 variant identifier.

例子：de, en_US, zh_TW_Traditional

# The SAP proprietary language codes - SAP 專有語言程式碼

> SAPUI5 applications are often used to connect to ABAP-based SAP application servers. These servers use SAP proprietary language codes for compatibility reasons.

SAP UI5 應用可以用來消費 SAP ABAP 伺服器上暴露出來的 OData 服務，這些伺服器出於相容性原因，使用 SAP 專有的 language code.

> These language codes often match an ISO 639 alpha-2 language code, but not in all cases.

SAP 專有 Language code 通常都和 ISO 639 alpha-2 裡定義的 Language code 一一對應，但並不總是如此。

If the language code for a SAPUI5 application is specified with the traditional URL parameter sap-language, SAPUI5 assumes that it is a SAP proprietary language code and converts it to a BCP-47 language tag.

注意，如果使用者在 SAP UI5 URL 引數，即 sap-language 裡傳入一個 code，SAP UI5 會預設將其視為一個 SAP 專有 Language code，並試圖將其轉換成 BCP-47 對應的 code.

轉換規則如下：
![](https://img-blog.csdnimg.cn/img_convert/ed2283f8d3bdd8de2715b9e722ddfd48.png)

# SAP UI5 執行時語言判定機制

> SAPUI5 has the notion of a current language. It is determined from the following sources of information. The sources are ordered increasingly by priority and the last available user language/locale wins.

SAP UI5 引入了“當前語言”，即執行時語言的概念。SAP UI5 載入的所有國際化文字資源(i18n resouces)，都基於該當前語言載入。SAP UI5 執行時語言，使用下列邏輯來決定。下列規則按照優先順序從低到高的順序羅列出來，即越後面的規則，優先順序越高。

1. Hard-coded UI5 default locale ('en') - 硬編碼的預設 locale

2. Potentially configured browser language (window.navigator.browserLanguage); for Internet Explorer this is the language of the Operating System.

瀏覽器裡設定的語言。如果是IE，window.navigator.browserLanguage 指代作業系統的語言。

3. Potentially configured user language (window.navigator.userLanguage); for Internet Explorer this is the language in the Region settings.

使用者語言設定。在 IE 裡指代 Region Settings裡設定的語言。

注：Jerry 本地測試過，window.navigator.browserLanguage 和 window.navigator.userLanguage 都為空。

![](https://img-blog.csdnimg.cn/img_convert/d292f1a975c640532d11da0ee6c89bfb.png)

4. General language information from the browser

瀏覽器語言設定：window.navigator.language，在我的機器上為：en-US

![](https://img-blog.csdnimg.cn/img_convert/d3bdaa276416c0ef4a8752b8eac42b84.png)

5. 使用 SAP UI5 configuration API 設定語言：sap.ui.getCore().getConfiguration().setLanguage()

![](https://img-blog.csdnimg.cn/img_convert/3a2868404bc86ca76cef81a1b39f949a.png)

6. Locale configured via URL parameters

採用 url 引數 sap-language=ZH 設定的語言，具有最高的優先順序。如下例子所示：

https://gm4:44355/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-language=ZH&sap-client=001#Opportunity-manageOpportunity&/detail/Opportunities(guid'FA163EE5-6C3A-1ED7-B883-0ED9A99A201F')

![](https://img-blog.csdnimg.cn/img_convert/0c424ea1c66b368eceff3b834df64b96.png)

SAP UI5 自動載入 i18n_zh_CN.properties 檔案：

![](https://img-blog.csdnimg.cn/img_convert/2faf945d6bc24b1dcdd522f2b1d53efc.png)

載入該 .properties 檔案，使用的Content-Type為: application/octet-stream; charset=UTF-8

![](https://img-blog.csdnimg.cn/img_convert/36b4e315ba9bcff872260db4de820471.png)

最後載入的 Fiori Launchpad html 裡定義的content 為：text/html; charset=UTF-8

![](https://img-blog.csdnimg.cn/img_convert/008fea53643eb55f726a603d92986b66.png)

SAP UI5 標準應用的多語言支援 - SAP UI5 執行時語言判定機制

相關文章