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

# 分割套件 (splitpkg.exe)

> 分割套件 (splitpkg.exe)

從主要套件建置子集套件。

| 欄 1 |
| - |
| splitpkg command \[/?] |

| 選項 | 說明 |
| - | - |
| command | 指定要執行的命令。支援的命令為 split、validate 和 list。 |
| /? | 顯示說明文字。若要顯示特定命令的說明，請使用 SPLITPKG \<command> /? |

<a id="ID4EIB" />

## 命令

* [split 命令](#ID4EOB)
* [validate 命令](#ID4END)
* [list 命令](#ID4EAE)

<a id="ID4EOB" />

### split 命令

根據子集 XML 檔案，將使用 [makepkg](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 建立的套件分割成一或多個子集套件。

| 欄 1 |
| - |
| splitpkg split \[/v] \[/m] \[/j] \[/?] /f \<subsetfile> /p \<sourcepackage> \[/s \<subsetname>] /pd \<destinationdir> |

| 選項 | 說明 |
| - | - |
| /f | 指定子集 XML 檔案，用於定義如何建立子集套件。 |
| /p | 指定來源套件的路徑。若要製作合輯光碟，可以多次提供此參數。 |
| /s | 指定選擇性的子集名稱。此選項只會產生具有指定名稱的分割套件。可以新增多個 /s 參數。 |
| /pd | 指定所建立之子集套件的目的地路徑。 |
| /v | 啟用將訊息詳細輸出至主控台。 |
| /m | 指定套件允許的大小上限 (以 GB 為單位)。預設為 49 GB。若不限制大小，請傳遞 0 (零) 值。 |
| /j | 工具的所有輸出也會發出 JSON 物件。 |
| /? | 顯示此說明文字。 |

<a id="ID4END" />

### validate 命令

執行驗證步驟，以偵測分割套件時可能發生的問題。接受與 `splitpkg split` 命令相同的參數，但目的地路徑除外，驗證時不需要此路徑。

| 欄 1 |
| - |
| splitpkg validate \[options] /f \<subsetfile> /p \<sourcepackage> \[/s \<subsetname>] |

<a id="ID4EAE" />

### list 命令

針對指定的子集檔案，以 JSON 物件列出子集套件的相關資訊。

| 欄 1 |
| - |
| splitpkg list \[/v] \[/?] /f \<subsetfile> |

| 選項 | 說明 |
| - | - |
| /f | 指定子集 XML 檔案，用於定義如何建立子集套件。 |
| /v | 啟用將訊息詳細輸出至主控台。 |
| /? | 顯示此說明文字。 |

<a id="ID4EDF" />

## 套件結構描述

下列結構描述用於定義如何分割套件。

```
      
<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="Package" xmlns="" xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">

  <!--PACKAGE SCHEMA-->
  <xs:element name="Packages">
    <xs:complexType>
      <xs:choice minOccurs="1" maxOccurs="unbounded">
        <xs:element name="Package">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Include" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:attribute name="ChunkId" type="xs:string"/>
                  <xs:attribute name="Languages" type="xs:string"/>
                  <xs:attribute name="Devices" type="deviceType"/>
                  <xs:attribute name="ContentTypes" type="contentType" />
                  <xs:attribute name="Tags" type="xs:string" />
                  <xs:attribute name="Disc" type="xs:integer" />
                  <xs:attribute name="Features" type="xs:string" />
                </xs:complexType>
              </xs:element>
              <xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:attribute name="ChunkId" type="xs:string"/>
                  <xs:attribute name="Languages" type="xs:string"/>
                  <xs:attribute name="Devices" type="deviceType"/>
                  <xs:attribute name="ContentTypes" type="contentType" />
                  <xs:attribute name="Tags" type="xs:string" />
                  <xs:attribute name="Features" type="xs:string" />
                </xs:complexType>
              </xs:element>
            </xs:sequence>
            <xs:attribute name="Name" type="xs:string" use="required"/>
            <xs:attribute name="Description" type="xs:string" use="optional"/>
            <xs:attribute name="Source" type="xs:string" use="optional"/>
            <xs:attribute name="MaxDiscs" type="xs:string" use="optional"/>
          </xs:complexType>
        </xs:element>
      </xs:choice>
    </xs:complexType>
  </xs:element>

  <xs:simpleType name="deviceType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Xbox-Durango"/>
      <xs:enumeration value="Xbox-Scorpio"/>
      <xs:enumeration value="Xbox-Lockhart"/>
      <xs:enumeration value="Xbox-Anaconda"/>
    </xs:restriction>
  </xs:simpleType>

  <xs:simpleType name="contentType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="SinglePlayer"/>
      <xs:enumeration value="MultiPlayer"/>
    </xs:restriction>
  </xs:simpleType>

</xs:schema>  
```

<a id="ID4EMF" />

## 另請參閱

[部署套件結構描述](/zh-TW/build/core-features/common/packaging/deployment/atoc-deployment-schema)

[建立套件 (makepkg.exe)](/zh-TW/build/core-features/common/packaging/deployment/makepkg)


## Related topics

- [XBOX 環境工具與 API](/zh-TW/tools/tools-console/gc-xbox-tools-and-apis-toc.md)
- [PC 開發的命令列工具](/zh-TW/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [串流安裝工具](/zh-TW/build/core-features/common/packaging/deployment/atoc-deployment-tools.md)
- [部署套件結構描述與串流安裝工具](/zh-TW/build/core-features/common/packaging/deployment/index.md)
- [開發期間的應用程式封裝](/zh-TW/build/core-features/common/packaging/packaging-packaging-during-development.md)