Compartilhar via


Split package (splitpkg.exe)

Builds subset packages from a master package.

splitpkg command [/?]

Option

Description

commandSpecifies the command to be performed. Supported commands are split, validate, and list.
/?Shows Help text. To show Help for a specific command, use SPLITPKG <command> /?

Commands

split command

Splits a package created with makepkg into one or more subset packages, according to a subset XML file.

splitpkg split [/v] [/m] [/j] [/?] /f <subsetfile> /p <sourcepackage> [/s <subsetname>] /pd <destinationdir>

Option

Description

/fSpecifies a subset XML file for defining how the subset packages are to be created.
/pSpecifies the path to the source package. For producing a compilation disc, this parameter can be provided more than once.
/sSpecifies an optional subset name. This option will produce only split packages that have the specified name. Multiple /s parameters can be added.
/pdSpecifies the destination path for the created subset packages.
/vEnables verbose output of messages to the console.
/mSpecifies the maximum allowable size for a package, in GB. Default is 49 GB. For no restriction on size, pass a value of 0 (zero).
/jAll output from the tools will also emit a JSON object.
/?Shows this Help text.

validate command

Runs the validation steps for detecting potential issues with splitting of a package. Takes the same parameters as those taken by the splitpkg split command, with the exception of a destination path, which isn't required for validation.

splitpkg validate [options] /f <subsetfile> /p <sourcepackage> [/s <subsetname>]

list command

For the specified subset file, lists the subset package-related information as JSON objects.

splitpkg list [/v] [/?] /f <subsetfile>

Option

Description

/fSpecifies a subset XML file for defining how the subset packages are to be created.
/vEnables verbose output of messages to the console.
/?Shows this Help text.

Package schema

The following schema is used to define how the package is to be split.

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

See also

Deployment package schema

Make package (makepkg.exe)