清单 [[extras]] 部分
清单 [[extras]] 部分
开放Beta测试文档 作为预发布开放Beta测试的一项内容,亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代,所描述的这些功能可能会发生变化。有关最新功能的信息,请参阅发行说明。
[[extras]]
部分包含键值对,用于描述与程序包或其中的组件相关的自定义元数据。extras是可选的。
[[extras]]
# 为程序包定义的自定义元数据
字段
key
(字符串,必需): 定义可由应用组件用于检索值的键。component-id
(字符串,可选): 定义此键值对应该关联的应用component-id
。通过添加此关联,可以通过IComponent
获得键值对以及组件信息。如果不定义此关联,则将把键值对视为程序包的全局值,并通过IPackage
与程序包信息一起提供。value
可以通过以下两种方式中的任何一种来定义:value
(字符串,必需): 定义字符串值。value
(表,必需):value
表的内容,包括表的任何子表或子数组,构成键值对的值的内容。可以使用内联表语法将子表声明为value.<子表名称>
,也可以使用常规表语法将其声明为[[extras.value.<子表名称>]]
。在生成的值中,此值通过IPackage
或IComponent
转换为[[<子表名称>]]
。该值的读取器应解析字符串中的TOML值。
# 全局键值
[[extras]]
key = "foo"
value = "bar"
# 组件特定键值
[[extras]]
key = "foo2"
value = "bar2"
component-id = "com.foo.bar.interactive"
# 包含内联表格的值
[[extras]]
key = "sample.metadata"
value.mysection = { rev = "1.5", name = "Doe" }
上面的示例生成以下键值对:
"sample.metadata" => "[mysection] name = 'Doe' rev = '1.5'"
Last updated: 2025年9月30日