备注
资产解析
AssetResolver库为应用提供了一种无缝资产解析手段,可以根据设备系统限定符对资产进行排序。应用可以包含资产,这些资产是可用于图像和文本等内容的文件。AssetResolver支持图像、原始文件和文本定义文件。 资产必须位于应用程序的assets目录中,并且必须遵照以下目录结构。
getString()和getNumber()方法中使用这些文件。
配置限定符
AssetResolver的方法会根据系统当前的配置限定符来进行资产解析。这些值定义了某些设备属性,例如区域设置、用户界面模式等。 例如,区域设置限定符可以采用诸如en-US、es-AR或es-SP之类的值。此限定符直接影响系统会解析哪些资产。在如下资源目录结构中,文件strings.puff.json在多个目录中均有定义: 每种区域语言各一份,另有一份置于text中作为默认资源。
en-GB),那么它也必须定义对该区域设置的默认限定符(在本例中为en)的支持。建议定义一个默认资产文件,这样,即使资产解析失败,系统也始终能够匹配到一个资产。
若区域语言的系统配置限定符为es-AR,则调用AssetResolver API时会选用文件assets/text/es-AR/strings.puff.json。如果多个区域设置包含相同的文本资产,则可以使用指向单个资产文件的符号链接来节省设备存储空间。
注意: 解析各处的资产时,仅支持将区域设置作为配置限定符。
访问控制
AssetResolver方法没有设置访问控制。AssetResolver方法仅在应用的设备文件系统子集内执行。此外,其他应用无法明确解析来自另一个应用的资产,从而确保了应用间的隔离。开始使用
将以下库依赖项添加到package.json文件的dependencies部分。
用法
AssetConfiguration类型
某些API会接收AssetConfiguration对象。此对象用于指定在解析资产时应使用哪些限定符。目前支持区域设置。检索国际化字符串值
要检索国际化字符串值,可使用getString()方法。此方法会接收当前所查询字符串的标识符和一个可选配置对象,该对象会指定资产解析中要使用哪些限定符。
失败时,此方法会抛出错误,并在错误消息中说明错误情况。
检索国际化数字值
要检索国际化数字值,可使用getNumber()方法。和getString()类似,此方法会接受一个字符串,该字符串是所查询版本号值的标识符。此外,此方法还会接收一个可选配置对象,该对象会指定资产解析中应使用哪些限定符。
如果执行中出现问题,此方法会引发错误。
API参考
类
- AssetResolver — 提供应用资产解析所需各种API的类。
类型别名
- AssetConfiguration — 在各种API中用作输入的类型,用于选择单个限定符的值
- NumberResult — 错误字段中适用于数字的内部类型。
- StringResult — 错误字段中适用于StringValue的内部类型。
- StringValue — 表示AssetResolver对字符串值的表示方式的类型:

