Package Declarations

InstallShield 2022

Project:The Package Declarations view is available in the following project type:

MSIX

This declaration helps you to add package declarations like:

Certificates
Enterprise Data Protection
InProcessServer
Custom Declaration

Certificates

This declaration helps you to declare a package extensibility point of type windows.certificates. The app requires one or more certificates from the specified certificate stores.

Note:You are restricted to create only one instance per Package.

Properties
Certificates

Properties

This view is used to declare and configure package declaration properties of type windows.certificates. Certificates declaration enables the package to install digital certificates, such as trusted root certificates, with the app. These certificates are used during secure connections to the web services over SSL.

The following table describes the settings that are displayed in the Certificates package declarations:

Properties

Declaration

Project Type

Description

Exclusive Trust

MSIX

Either select Yes or No to Indicate whether the certificates for the package are exclusive to the package and determines certificate validation.

Selection Criteria

MSIX

Defines selection criteria for the certificates defined for the package during client authentication.

AutoSelect - Select this option if the certificates are selected automatically.
HardwareOnly - Select this option if the specified certificates are hardware-specific.

Certificates

Declares a package extensibility point of type windows.certificates. Specifies the certificates that are installed in the application specific certificate store.

The following table describes the settings that are displayed in the Certificates package declarations:

Certificates

Declaration

Project Type

Description

Certificates

MSIX

Certificates - Declare one or more number of certificates here.

Enterprise Data Protection

This declaration helps you to declare that the app is safe for auto-encryption and allows it to be managed without device enrollment via Windows Information Protection policy.

Note:You are restricted to create only one instance per Package.

Properties

Properties

Declares that the app is safe for auto-encryption and allows it to be managed without device enrollment via Windows Information Protection policy.

Use this extension only if the app is exclusively for work, and/or you provide a mechanism to restore any non-work personal data the app modifies. All files that the app creates or modifies will be encrypted on behalf of the managing organization, and become inaccessible after a selective wipe occurs, when the protection policy is removed from the device.

Important:Always use enterpriseDataPolicy capability to safely handle both work and personal data when managed with Windows Information Protection.

The following table describes the settings that are displayed in the Enterprise Data Protection package declarations:

Properties

Declaration

Project Type

Description

Protection Mode

MSIX

The mode of data protection:

Auto
Default

InProcessServer

This declaration helps you to declare a package extensibility point of type windows.activatableClass.inProcessServer. The app uses a dynamic link library (DLL) that exposes one or more activatable classes.

Properties
Activatable Class

Properties

Declares a package extensibility point of type windows.activatableClass.inProcessServer. The app uses a dynamic link library (DLL) that exposes one or more activatable classes.

The following table describes the settings that are displayed in the InProcessServer package declarations:.

Properties

Declaration

Project Type

Description

Path

MSIX

The path to the in-process DLL. A string between 1 and 256 characters in length that cannot contain these characters:

<, >, :, %, “, |, ?, or *.

Activatable Class

Declares an activatable runtime class associated with the extensibility point.

The following table describes the settings that are displayed in the InProcessServer package declarations:

Activatable Class

Declaration

Project Type

Description

Class ID

MSIX

The identifier of the runtime class in the operating system.

Threading Model

MSIX

The type of threading model supported by the runtime class. This attribute can have any one of the following values:

Both
Single-threaded Apartments (STA)
Multi-threaded Apartments (MTA)

Activatable Class Attributes

MSIX

Defines one or more activatable class attributes.

Activatable Class Attribute

MSIX

Defines an attribute instance of the class that is stored in the Windows Runtime property store.

Name

MSIX

An attribute name. An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.

Type

MSIX

An attribute type. This attribute can have one of the following values:

string
integer

Value

MSIX

An attribute value. A string between 1 and 255 characters in length.

Custom Declaration

This declaration helps you to define the MSIX extensions that are not coming with out of the box in InstallShield. The Custom Declaration menu provides the options to define the required extension type by specifying its namespace and the content. InstallShield build process considers these customizations while preparing the MSIX manifest file.

Properties

Properties

These settings are for the declaring custom extensions. This option helps to define the extensions that are not provided in built-in extension type.

Properties

Declaration

Project Type

Description

Display Name

MSIX

Specify the Display (Category) Name for a custom declaration.

Namespace

MSIX

Specify the namespace to be added in the package manifest for this custom declaration item.

For example, specify as below to include UAP10 schema in the manifest file: xmlns:uap10='http://schemas.microsoft.com/appx/manifest/uap/windows10/10'

To define multiple namespace declarations, use semicolon as delimiter.

For example:

xmlns:uap10='http://schemas.microsoft.com/appx/manifest/uap/windows10/10';xmlns:desktop6='http://schemas.microsoft.com/appx/manifest/desktop/windows10/6'

XML Content

MSIX

Specify the XML content to be added in the package manifest for the custom declaration. Below is the example to declare installedLocationVirtualization extension:

<uap10:Extension Category="windows.installedLocationVirtualization">

<uap10:InstalledLocationVirtualization>

<uap10:UpdateActions ModifiedItems="keep" DeletedItems="keep" AddedItems="keep" />

</uap10:InstalledLocationVirtualization>

</uap10:Extension>