> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# <Chunk> 元素

> <Chunk> 元素

定义 *chunk*，即应作为一组一起安装的一批文件。

## 语法

```xml theme={null}
<Chunk
  Marker = string
  Id = string 
  Devices = string
  Languages = string
  Tags = string>
</Chunk>  
```

### 属性

#### Marker

表示在布局 XML 文件中直到并包括此 chunk 的所有 chunk 都必须先安装完成，游戏才能启动。`Marker` 属性唯一允许的值是 “Launch”。请注意，无论 ID 是什么，出现在被标记 chunk 之前的所有 chunk 都是启动所必需的。

#### Id

必填。chunk 的标识符。游戏可使用此 ID 查询安装状态，并在运行时更改安装顺序。

#### Devices

声明特定 chunk 中内容所适用的设备类型。

#### Languages

声明 chunk 中内容所适用的语言。

#### Tags

允许你将若干 chunk 标记为相关。这简化了检查运行游戏所需的所有 chunk 是否都已在用户系统上的过程。此属性还用于将 chunk 分组到 Features 中。

最终镜像中 chunk 的顺序遵循布局 xml 文档中所有 chunk 自上而下的顺序。因此，这也是默认的安装顺序。

## 备注

[MakePkg.exe](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/makepkg.md) 会在你的包中扫描某些特定文件，并将它们移动到特殊的 *registration* chunk 中。这些文件包括 *MicrosoftGame.config*、*MicrosoftGame.config* 中引用的所有图像，以及 *Resources.pri*（若存在）。你可以在 *layout.xml* 文件中手动布置这些文件：为包含这些文件的 chunk 指定 `Id` 属性为 “Registration”。

## 元素信息

| 关系 | 元素名称 |
| - | - |
| 父元素 | [Package](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/deployment-element-package.md) |
| 子元素 | [FileGroup](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/deployment-element-filegroup.md) |

## 示例

```xml theme={null}
<Chunk Id="1234" Marker="Launch" Languages="en" Devices="Anaconda" Tags="Campaign1">
  <FileGroup DestinationPath="\Campaign1\Anaconda\en" SourcePath="X:\Campaign1\Anaconda\en" Include="*.*"/>
</Chunk>  
```

## 另请参阅

[部署包架构](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/atoc-deployment-schema.md)


## Related topics

- [部署包架构与流式安装工具](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/index.md)
- [<Package> 元素](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/deployment-element-package.md)
- [<FileGroup> 元素](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/deployment-element-filegroup.md)
- [XPackageChunkAvailabilityCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagechunkavailabilitycallback.md)
- [部署包架构](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/deployment/atoc-deployment-schema.md)