General Tab for MSIX Release
InstallShield 2024 » Releases View
Project:
• | MSIX |
• | MSIX Modification Package |
The General tab has the following settings, primarily for overriding other settings in the resulting releases:
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:
|
||||||||||||||||||||||||||||||
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:
|
||||||||||||||||||||||||||||||
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,
|
||||||||||||||||||||||||||||||
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,
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:
Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:
|
||||||||||||||||||||||||||||||
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:
Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:
|
||||||||||||||||||||||||||||||
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,
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:
By default, the No option is selected. The possible options are:
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, certificate file (EV exported .cer file), or information about the certificate store that contains the certificate. InstallShield provides an option to encrypt and store an EV token password in the project file using the public key certificate (.cer) file. The .cer file is generally created by exporting a public key from the EV Authentication Client tools associated with a USB eToken provider (for example, SafeNet Authentication Client). InstallShield displays additional options to configure the Extended Validation (EV) certificate properties if the .cer file is specified. For more details, see:
After specifying the .pfx file or choosing the certificate from test store, the below will be displayed:
After specifying the certificate file (EV exported .cer file), the below settings will be displayed:
|
||||||||||||||||||||||||||||||
Digital Certificate Information (Continued) |
MSIX, MSIX Modification Package |
Note:Note the following informations while utilizing the settings that appear after specifying the certificate file (EV exported .cer file):
|
||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||
Cryptographic Provider |
MSIX, MSIX Modification Package |
Specify the Cryptographic Service Provider (CSP) name. Note:The Cryptographic Service Provider (CSP) name can be obtained from the Private Key Certificate properties of a user certificate in the EV Vendor authentication Client tool. |
||||||||||||||||||||||||||||||
Container Name |
MSIX, MSIX Modification Package |
Specify the Private key container name associated to the Cryptographic Service Provider (CSP). Note:The Container name can be obtained from the Private Key Certificate properties of a user certificate in the EV Vendor Authentication Client tool. |
||||||||||||||||||||||||||||||
Token Password |
MSIX, MSIX Modification Package |
Specify the EV token password which is encrypted and stored in a project file. Note:Note the following information while specifying an EV token password:
|
||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||
Use 64-Bit Signing |
MSIX, MSIX Modification Package |
Specify whether you want to use the 64-bit signing framework to digitally sign your package. Available options are:
By default, this setting is set to No. |
||||||||||||||||||||||||||||||
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:
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:
|
||||||||||||||||||||||||||||||
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:
Use as few characters as possible. For example, do not use unnecessary leading zeros; instead of entering 14.00.25.1, enter the following:
|