> ## 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.

# <FileGroup> 元素

> <FileGroup> 元素

定义向 *chunk*（应作为一组一起安装的一批文件）添加文件所遵循的规则。

<a id="syntaxSection" />

## 语法

```xml theme={null}
<FileGroup
  SourcePath = string
  DestinationPath = string
  Include = string />  
```

<a id="ID4E3" />

### 属性

#### SourcePath

必填。规则运行所针对的文件来源。路径相对于通过 `/d` 参数传给 [makepkg](/build/core-features/common/packaging/deployment/makepkg) 工具的内容目录。

#### DestinationPath

必填。与规则匹配的文件在所生成镜像文件系统中的目标位置。此属性只应指定目录名，不应包含文件名。

#### Include

必填。用于匹配该源位置下文件的规则。可以使用相对于源位置的路径、标准的 “\*” 和 “?” 通配符，以及/或环境变量。

<a id="remarks" />

## 备注

此元素不是递归的。要包含的每个目录都必须由其自己的 `FileGroup` 元素指定。

<a id="ID4EXC" />

## 元素信息

| 关系  | 元素名称                                                                               |
| --- | ---------------------------------------------------------------------------------- |
| 父元素 | [Chunk](/build/core-features/common/packaging/deployment/deployment-element-chunk) |
| 子元素 | 无                                                                                  |

<a id="ID4EDD" />

## 示例

```xml theme={null}
<FileGroup DestinationPath="\Data\Maps" SourcePath="Y:\Maps\Level1" Include="*.map"/>
<FileGroup DestinationPath="\Data\Maps" SourcePath="Y:\Maps\Level2" Include="*.map"/>
<FileGroup DestinationPath="\Data\Maps" SourcePath="Y:\Maps\Level3" Include="*.map"/>  
```

## 另请参阅

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


## Related topics

- [<Package> 元素](/zh-CN/build/core-features/common/packaging/deployment/deployment-element-package.md)
- [<Chunk> 元素](/zh-CN/build/core-features/common/packaging/deployment/deployment-element-chunk.md)
- [部署包架构](/zh-CN/build/core-features/common/packaging/deployment/atoc-deployment-schema.md)
- [MicrosoftGame.config 元素 - SupportedFileTypes](/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-supportedfiletypes.md)
- [MicrosoftGame.config Element - FileType](/zh-CN/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-filetype.md)