OptionalBundle

Description

Defines optional bundles relative to the main bundle. Optional bundles contain additional packages that apply to the main app package or bundle.

Element Hierarchy

<Bundle>

<OptionalBundle>

Syntax

<OptionalBundle Name      = A string between 3 and 50 characters in length that consists of alpha-numeric, period, and dash characters.
                Publisher = A string between 1 and 8192 characters in length that fits the regular expression  of a distinguished name : "(CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")(, ((CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")))*". Further, semantic validation ensures that the string is compliant with CertNameToStr Windows API implementation of X.500 rules.
                Version?  = A version string in quad notation, "Major.Minor.Build.Revision".
                FileName? = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. >

    <!-- Child elements -->
    Package{1,10000}
</OptionalBundle>

Key

?   optional (zero or one)
{} specific range of occurrences

Attributes

Attribute	Description	Data type	Required
Name	Describes the contents of the bundle. The Name attribute is case-sensitive.	A string between 3 and 50 characters in length that consists of alpha-numeric, period, and dash characters.	Yes
Publisher	Describes info about the publisher of the bundle.	A string between 1 and 8192 characters in length that fits the regular expression of a distinguished name : "(CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")(, ((CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")))*". Further, semantic validation ensures that the string is compliant with CertNameToStr Windows API implementation of X.500 rules.	Yes
Version	The version number of the bundle.	A version string in quad notation, "Major.Minor.Build.Revision".	No
FileName	The file name of the bundle.	A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.	No

Child Elements

Child Element	Description
Package	Defines one of the app packages or resource packages in the optional bundle.

Remarks

Examples

Requirements

	Value
Namespace	http://schemas.microsoft.com/appx/2016/bundle