1# 应用偏好语言 2 3## 功能介绍 4 5对于多语言用户，通常会将系统语言设置为一种语言（如中文），将特定应用的语言设置为另一种语言（如英语）。应用界面加载资源时，显示应用设置的语言。开发过程中，设置应用国际化特性区域为偏好语言，确保应用界面的国际化特性和加载的资源一致。当前，应用仅支持设置一种语言。 6 7## 开发步骤 8 9接口具体使用方法和说明请参考[getAppPreferredLanguage](../reference/apis-localization-kit/js-apis-i18n.md#getapppreferredlanguage9)的API文档。 10 111. 导入模块。 12 ```ts 13 import { i18n } from '@kit.LocalizationKit'; 14 import { BusinessError } from '@kit.BasicServicesKit'; 15 ``` 16 172. 需要获取应用偏好语言。 18 ```ts 19 let appPreferredLanguage: string = i18n.System.getAppPreferredLanguage(); // 获取应用偏好语言 20 ``` 21 223. 设置应用偏好语言。将应用偏好语言设置为目标语言后，应用界面会切换为目标语言。这仅影响应用本身，不影响系统语言设置。 23 ```ts 24 try { 25 i18n.System.setAppPreferredLanguage('zh-Hans'); // 设置应用偏好语言为zh-Hans 26 } catch (error) { 27 let err: BusinessError = error as BusinessError; 28 console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`); 29 } 30 ``` 31 324. 清除应用偏好语言。将应用偏好语言设置为"default"后，该应用的界面会跟随系统语言变化，该特性将在应用重新启动后生效。 33 ```ts 34 try { 35 i18n.System.setAppPreferredLanguage('default'); // 清除应用偏好语言 36 } catch(error) { 37 let err: BusinessError = error as BusinessError; 38 console.error(`call System.setAppPreferredLanguage failed, error code: ${err.code}, message: ${err.message}.`); 39 } 40 ```