# 软件包

## 这个怎么运作

定义游戏中存在哪些包及其依赖项的规则在 `packages{}`块内的 `application.blk`文件中指定。

```{seealso}
有关更多信息，请参阅
[application.blk](../../assets/all-about-blk/application_blk.md).
```

**Example:**

```text
pkg_dev{                         // 包名称
  PC:b=yes; iOS:b=no; and:b=no;  // 平台
  destSuffix:t="/../content.hq"  // 如果包应该放在 content.hq 中（HQ 版本需要）
  "PC~~dedicatedServer":b=yes    // 专用服务器需要（不需要 HQ 版本，需要标准版本）
  allow_patch:b=false   // 是否允许修补（仅对 pkg_dev 禁用，生产中的所有内容都已修补）
  always_commit:b=true  // 如果 rebuild 提交更改
  dependencies{         // 依赖
    "*" {base:b=yes;}   // 基础包
    pkg_cockpits {base:b=yes;}  // 驾驶舱资产
  }
}
```

`dependencies{}`块表示指定对包 B 的依赖项的包 A 依赖于包 B。但是，包 B 不依赖于包 A。

## 如何添加新包

要添加新包，请在 `application.blk` 中定义新的 `pkg`，修改必要的 `folder.blk` 文件（资产的导出设置），运行 [本地构建](resource_building.md#local-build)，并确保依赖项正确且没有发生错误。

```{seealso}
有关更多信息，请参阅
[folder.blk](../../assets/all-about-blk/folder_blk.md).
```

定义新软件包后，无需重新构建 [vromfs](vromfs.md) 文件。

要使游戏识别包内容，您必须在位于`<engine_root>/<project_name>/develop/gameBase/_pc/settings.blk`的设置文件`settings.blk`中指定它。在`addons{}`和 `addons_no_check{}` 块中添加包路径。

```{seealso}
有关更多信息，请参阅
[settings.blk](../../assets/all-about-blk/config_and_settings_blk.md).
```