清单 [package] 部分

[package] 部分定义了有关应用的基本详细信息，例如唯一的程序包标识符、应用标题和图标。此部分在每个清单文件中都是必填的。

字段

• id（字符串，必需）： 用于标识应用程序包的唯一标识符。此标识符在亚马逊应用商店中应当是唯一的。按照惯例，此标识符用作程序包中所有其他ID命名空间的前缀。此标识符用于管理应用程序包的生命周期，不得更改该标识符，以确保更新流畅运行。标识符字符串必须遵循以下规则：
  • 允许的字符：大写字母A-Z、小写字母a-z、数字0-9、点.以及下划线_。

  • 使用反向DNS表示法<顶级域名>.<公司名称>.<应用名称>，至少要有2个分段，每个分段以字母开头。

    // 有效的标识符
    id = "com.foo.bar"
    id = "de.fooz"
    
    // 无效的标识符
    id = "a_single_word"
    id = "1numeral.foo"
    

  注意： 如果您在亚马逊应用商店发布了Fire OS应用，请重复使用相同的程序包标识符，以确保Fire OS和Vega应用链接在一起，并让您的客户可以顺畅过渡到新Vega设备。

• title（字符串，必需）： 用户可见的应用名称字符串。支持以下两种类型：

  • 硬编码标题： 标题应简短，以便放入显示图块中，而且不会出现截断。

    // 建议做法
    title = "Foo App"
    
    // 不建议的做法
    title = "Lorem ipsum dolor sit amet, consectetur adipiscing elit"
    

  • 本地化标题： 允许根据语言使用不同的标题。要使用区域设置功能，请遵循以下要求：

    • 标题字符串必须以 @text/<标题资产ID> 这一格式声明，其中 @text是保留关键字，标题资产ID是您定义的非空资源标识符。不允许使用title = @text/。

    • 当标题字符串被定义为本地化标题时，默认的标题字符串必须在程序包根目录下的assets/text文件夹下的puff.json文件中进行定义。

      // 本地化标题示例
      title = "@text/sample_title"
      

      // assets/text/puff.json下的标题资源示例：
      {
          "resources": {
              "sample_title": “要显示的标题内容示例”
          },
          "dir": "ltr"
      }
      

• icon（字符串，必需）： 用作应用图标的图像文件。此图像显示在设置应用中。要添加应用图标，必须将图像文件保存在程序包根目录下的assets/image中。如果未提供，则使用默认的应用图标。
  • 所需格式：@image/<图标文件名称> - 其中@image是保留关键字，而图标文件名称是保存在assets/image下的图像文件的名称。
  • 推荐的分辨率和格式： 512x512，PNG
  • 最大文件大小： 1MB
  • 推荐风格：浅色纯色图标在设置菜单中的视觉效果最佳

---

Last updated: 2025年10月21日