PowerServer 2025 Help
Cloud app launcher

To create and customize the launcher:

1. In the PowerServer project painter, select the Deploy > Advanced tab. Click the Configuration button. The Cloud App Launcher Profiles window appears.

2. Click the New button to add a new launcher profile. (You can also click the Delete icon after the profile to remove it.)

   
   
   

   In the New Launcher Profile window, create the profile with the following settings:

   • The name for the new launcher profile.

   • The location to save the launcher profile on the local machine.

   • The version of the launcher (Standard or Public). If you are not sure which version to select, refer to the previous section About cloud app launcher for their differences.

   • On the General tab:

     • The description and product name that will be shown in the Properties page of the launcher EXE file (view more)

     • The title, title bar logo (ICO format), main heading, main image, update image, and loading image that will be shown during the launcher installation progress (view more)

     
     
     

   • On the Advanced Options tab:

     • The install location of the application on the client. The path in the App path field will be used as the default installation path. If you want to allow the user to select where to install the application during the installation process, you can select "Allow the user to change the path".

     • The install location of the cloud app launcher on the client. The path in the Install path field will be used as the default installation path. If you want to allow the user to select where to install the cloud app launcher during the installation process, you can select "Allow the user to change the install path".

       • If "standard version" is selected, you can specify whether to allow the user to change the installation path of launcher. However, the standard version should not be installed to the same location as the public version.

       • If "public version" is selected, you should not allow the user to change the installation path of launcher.

     If the end user has no sufficient rights to install to the default or specified path for the application or the cloud app launcher, they will be prompted to select an appropriate path before they can proceed with the installation process.

     
     
     

   • On the Signing tab, select whether to digitally sign the launcher executable file (CloudAppLauncher_Installer.exe).

     For more information, refer to Signing.

     After the executable file is generated and before it is uploaded to the server, PowerBuilder will sign the executable file using your own signing scripts or using the SignTool settings you specified.

     Note

     If you want to sign your customized Cloud App Launcher using the SignTool utility, ensure that the current Windows OS account that runs the PowerBuilder IDE has permission to access the specified URL of the timestamp server. Otherwise, the signing may fail.

     
     
     

To import or export the launcher profile:

• In the Cloud App Launcher Profiles window, click the Import or Export button to import or export a launcher profile.

  The launcher profile will be saved in the JSON file format.

To modify the launcher profile:

1. In the Cloud App Launcher Profiles window, select an existing profile on the left, and then modify its settings on the right.

2. Click Apply to save the settings.

3. Click Re-Create to generate the launcher again with the changed settings.

   If you have made any change to the launcher settings, you must click Re-Create to create the launcher again before uploading it to the server.

To upload the launcher:

• See the Upload the cloud app launcher and the runtime files section.