清单 [[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日