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

# <Chunk> 元素

> <Chunk> 元素

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

<a id="syntaxSection" />

## 语法

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

<a id="ID4ET" />

### 属性

#### Marker

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

#### Id

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

#### Devices

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

#### Languages

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

#### Tags

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

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

<a id="remarks" />

## 备注

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

<a id="ID4EXB" />

## 元素信息

| 关系  | 元素名称                                                                                       |
| --- | ------------------------------------------------------------------------------------------ |
| 父元素 | [Package](/build/core-features/common/packaging/deployment/deployment-element-package)     |
| 子元素 | [FileGroup](/build/core-features/common/packaging/deployment/deployment-element-filegroup) |

<a id="ID4EIC" />

## 示例

```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>  
```

## 另请参阅

[部署包架构](/build/core-features/common/packaging/deployment/atoc-deployment-schema)


## Related topics

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