General Tab for MSIX Release

InstallShield 2022 » Releases View

Project:The General tab is available in the following project types:

MSIX
MSIX Modification Package

The General tab has the following settings, primarily for overriding other settings in the resulting releases:

General Tab for MSIX Release

Setting

Project Type

Description

General

MSIX, MSIX Modification Package

Use the Settings view on the General tab to specify core settings that impact the build process such as including desktop extensions or server extensions and signing details.

Release Location

MSIX, MSIX Modification Package

Enter the path to the top-level directory where your release will start to be built, or click the ellipsis button (...) to browse to the location.

Package Architectures

MSIX, MSIX Modification Package

Describes the architecture of the code contained in the package. A package that includes executable code must include this attribute.

The available codes are given below:

x86 
x64 
ARM 
ARM64 
Neutral 

Distribution Method

MSIX, MSIX Modification Package

Choose a distribution method for your MSIX package. This setting directs which set of warnings are issued for potential problems related to Windows Store policies or requirements related to sideloading. Available drop-down options are:

Direct Distribution (Sideload)— Distribute a MSIX package without having it downloaded from the Windows Store. Sideloaded apps have not been certified by the Windows Store. A common example of a sideloaded app is one that is distributed to an enterprise environment and is internal to a company only. If a package will be sideloaded, you will typically need to sign it, unless your customer wishes to sign it themselves.
Windows Store— Distribute a MSIX package through the Windows Store. When this option is selected, additional warnings will be issued for items that are known to be rejected by Windows Store policy despite the build being valid in a sideloading scenario. If a package will be distributed through the Windows Store, it is subject to additional policies that limit its contents. This type of app doesn't need to be signed before it is uploaded to Microsoft because Microsoft signs the package.

Include Universal Extensions

MSIX, MSIX Modification Package

Choose whether to include Universal device extensions as part of the core UWP app package format. If you want to enable your apps to start leveraging Universal Windows Platform (UWP) APIs, you should enable Universal extensions.

If you select,

No— The warnings are issued for any such items that cannot be represented.
Yes— The additional subsettings can be configured as needed to specify a minimum Windows version and maximum tested Windows version supported by the included apps and Universal extensions.

Include Desktop Extensions

MSIX, MSIX Modification Package

Choose whether to include "full trust" apps and other Desktop Bridge extensions as part of the core UWP app package format. If you want to enable your desktop apps to start leveraging Universal Windows Platform (UWP) APIs, you should enable desktop extensions.

If you select,

No— The warnings are issued for any such items that cannot be represented.
Yes— The additional subsettings can be configured as needed to specify a minimum Windows version and maximum tested Windows version supported by the included apps and desktop extensions.

Important:When using InstallShield to create a UWP app package, choose to include either desktop extensions or server extensions, but not both. Although a UWP app package can contain both desktop and server extensions, targeting one set over the other is a more likely scenario.

Minimum Version

MSIX, MSIX Modification Package

Optionally, specify the app's minimum supported Windows version number. If you leave this blank, the minimum version number of Windows 10 Anniversary Update is assumed.

The version must contain only numbers and it requires four parts using the following format (with values in each part ranging from 0 to 65535): majorversion.minorversion.buildnumber.revisionnumbe, such as:

1.0.0.60325

Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:

14.0.25.1

Tested Version

MSIX, MSIX Modification Package

Optionally, specify the app's maximum supported tested Windows version number. If you leave this blank, this setting defaults to match the Minimum Version (or the minimum version number of Windows 10 Anniversary Update if nothing is specified for Minimum Version).

The version must contain only numbers and it requires four parts using the following format (with values in each part ranging from 0 to 65535): majorversion.minorversion.buildnumber.revisionnumber such as:

1.0.0.60325

Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:

14.0.25.1

Include Server Extensions

MSIX, MSIX Modification Package

Choose whether to include Windows Server extensions as part of the core UWP app package format, thus creating a Windows Server App. If you want to target Windows Server Nano's installation package format and deploy a service, WMI provider, event source, or performance counter, you should enable server extensions.

If you select,

No— The warnings are issued for any such items that cannot be represented.
Yes— The additional subsettings can be configured as needed to specify a minimum Windows Server operating system and maximum tested Windows Server operating system supported by the included apps.

Important:When using InstallShield to create a UWP app package, choose to include either desktop extensions or server extensions, but not both. Although a UWP app package can contain both desktop and server extensions, targeting one set over the other is a more likely scenario.

Include MSIX Core Extensions

MSIX, MSIX Modification Package

The MSIX Core enables the installation of MSIX apps on previous versions of Windows, provided the apps are already built to work on those versions of Windows.

The MSIX Core is built for the following Windows versions that do not currently support MSIX:

Windows 7 SP1 - 6.1.7601.0
Windows 8.1 Update 1 - 6.3.9600.0
Windows 10 2015 LTSB (1507) - 10.0.10240.0
Windows 10 2016 LTSB (1607) - 10.0.14393.0
Windows Server 2008 R2 - 6.1.7601.0
Windows Server 2012 - 6.2.9200.0
Windows Server 2012 R2 - 6.3.9600.0
Windows Server 2016 - 10.0.14393.0

By default, the No option is selected. The possible options are:

No - When you select this option, the MSIX Core entry will not be added to the manifest file.
Yes - When you select this option, the MSIX Core entry will be added to the manifest file along with the specified minimum Windows version and maximum tested Windows version.

Tip:The MSIX Core package needs MSIX pre-requisite to be installed on the older package.

Minimum Version

MSIX, MSIX Modification Package

Optionally, specify the app's minimum supported Windows version number. If you leave this blank, the minimum version number of Windows 7 SP1 Update (6.1.7601.0) is assumed.

The version must contain only numbers and it requires four parts using the format of majorversion.minorversion.buildnumber.revisionnumber (with values in each part ranging from 0 to 6553).

Tested Version

 

MSIX, MSIX Modification Package

Optionally, specify the app's maximum supported tested Windows version number. If you leave this blank, this setting defaults to match the maxium MSIX core supported version number 10.0.14393.0 (Windows 10 2016 LTSB - 1607).

The version must contain only numbers and it requires four parts using the format of majorversion.minorversion.buildnumber.revisionnumber (with values in each part ranging from 0 to 65535).

Framework Dependencies

MSIX, MSIX Modification Package

Select the retail or debug build of the C++ runtime that matches the one used in your product.

Important:This setting does not cause the dependency packages to be installed in sideloading scenarios. For those scenarios, the dependency may have to be delivered manually. Also, the debug versions of the of the C++ runtime are only useful for internal testing and cannot be uploaded to the Windows Store. For local testing or sideloading, you may also have to deploy the framework package that is included in the Windows 10 SDK.

To customize the Framework Dependencies,

You can use the Msix.xml file, which is installed to the following location:

InstallShield Program Files folder\System

An example is given below:

<VC140 Name="Microsoft.VCLibs.140.00.UWPDesktop" MinVersion="14.0.24217.0" Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US">Microsoft Visual C++ 2015 Runtime</VC140>

Signing

MSIX, MSIX Modification Package

The Signing category is where you specify the digital signature information—including the digital certificate files that a certification authority grated to you—that InstallShield should use to sign your files.

Sign MSIX Package

MSIX, MSIX Modification Package

Specify whether or not you want to sign msix package.

Certificate URL

MSIX, MSIX Modification Package

Type a fully qualified URL - for example, http://www.mydomain.com. This URL is used in your digital signature to link to a site that you would like end users to visit to learn more about your product, organization, or company.

Digital Certificate Information

MSIX, MSIX Modification Package

To specify the digital certificate that you want to use to sign your release, click the ellipsis button (...) in this setting. The Certificate Selection dialog box opens, enabling you to specify either the location of the .pfx file, or information about the certificate store that contains the certificate.

Certificate Thumbprint

MSIX, MSIX Modification Package

This read-only setting displays the certificate thumbprint.

Issued By

MSIX, MSIX Modification Package

This read-only setting displays the certificate's issuer information.

Expiration Date

MSIX, MSIX Modification Package

This read-only setting displays the certificate's expiry date.

Certificate Password

MSIX, MSIX Modification Package

If the .pfx file that you are using has a password, enter it. InstallShield encrypts the password and stores it in your project file (.isl).

At build time, InstallShield uses the password to sign files with a .pfx file. If your certificate is protected by a password but you do not enter it in this setting, signing with a .pfx file fails.

Important:If you configure your project to use a certificate that was imported with password protection into a store, Windows prompts for the password at build time when InstallShield is attempting to sign your project's files. The strong key protection that Windows uses does not permit InstallShield to provide the password to the cryptographic provider.

Signature Description

MSIX, MSIX Modification Package

Specify the signature description that you want to use for files that are specified in the Sign Output Files setting. The description that you specify is displayed on the User Account Control (UAC) box to the right of the “Program Name:” label. The UAC dialog box opens when an end user launches the signed file and elevated privileges are required.

If you leave this setting blank, InstallShield uses the name of the file without its extension as the description to the right of the “Program Name:” label on the UAC dialog box. Note that if you use the Sign Files in Package setting and its subsettings to sign the files in your package, InstallShield does not use this signature description for the UAC dialog box of the files in your package that are signed at build time.

Package Identity Overrides

MSIX, MSIX Modification Package

Use the Package Identity Overrides area on the General tab to uniquely identify a package to Windows. These fields are typically not shown to an end user.

Name

MSIX, MSIX Modification Package

Specify a unique alphanumeric string that identifies your UWP app package to Windows. If this is left blank, InstallShield generates a name based on the Package Name setting in the General Information.

Publisher

MSIX, MSIX Modification Package

To override the actual value of the certificate if one is specified on the General tab, specify the Subject name (name of the owner) of the certificate that will be used to sign the package. For example:

CN=Revenera, O=Revenera, L=Itasca, S=Illinois, C=US

If a package will be distributed through the Windows Store, it doesn't need to be signed before it's uploaded to Microsoft, in which case a signing certificate may be skipped. If a package will be sideloaded, it may or may not need to be signed, depending on how your customers expect to handle the package:

If your customer prefers to sign the package themselves, they may need a specific publisher defined in the Publisher override setting that matches their certificate.
If your customer merely wants to deploy the package, they may expect it to be signed with a trusted Authenticode Certificate. The requirements on this are equivalent to those for a trusted UAC prompt.
Sideloading requires that the Sideloading setting in Windows is enabled. Sideloading is enabled by default in the Windows 10 Anniversary Update.

The following settings on the General tab of the Releases view also influence the built package by controlling whether and how the UWP app package is signed:

Digital Certificate Information
Certificate Password
Sign Output Files

Publisher Display Name

MSIX, MSIX Modification Package

Specify the string that users will recognize as the publisher's name. For example:

Revenera

If your customer prefers to sign the package themselves and If nothing is specified, the Display Name is copied from the Publisher setting in General tab.

Version

MSIX, MSIX Modification Package

Enter a version number for the UWP app package to which the certificate conforms. If nothing is specified, the version number is copied from the Product Version setting in General Information.

The version must contain only numbers and it requires four parts using the following format (with values in each part ranging from 0 to 65535): majorversion.minorversion.buildnumber.revisionnumber, such as:

1.0.0.60325

Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:

14.0.25.1