To prevent the Cloud App Launcher from being used to run unauthorized applications or malicious software, PowerBuilder 2025 has made the following improvements to the download and execution of the launcher:
-
The launcher now only allows the download and execution of applications and executable (app.exe) that carry the "appeon" flag, ensuring the authenticity and integrity of the content being downloaded.
-
At startup, the launcher retrieves a list of permitted URLs (including Web API URL, launcher URL, and runtime URL) from the apprun.json file and only allows access to and downloading from these specified URLs.
Due to these changes, applications deployed in PowerBuilder 2025 can only be run through Cloud App Launcher V3. Cloud App Launcher V3 can coexist with Cloud App Launcher V2, but please note the following:
-
Cloud App Launcher V2 supports applications deployed in PowerBuilder 2022, 2022 R2, or 2022 R3.
-
Cloud App Launcher V3 supports applications deployed in PowerBuilder 2025 or later.
Cloud App Launcher upgrade paths
To upgrade the launcher and application to PowerBuilder 2025 or later, the way for end users to complete the upgrade varies depending on the version upgraded from:
|
Upgrade path |
First launch after upgrading to PowerBuilder 2025 or later |
Result |
|---|---|---|
|
From PowerBuilder 2022 R3 Build 3391 or later |
Launch the application from the desktop shortcut. |
The Cloud App Launcher is automatically upgraded from V2 to V3, and the application starts normally. |
|
From a version earlier than PowerBuilder 2022 R3 Build 3391 |
Launch the application from a web browser the first time. |
The launcher is upgraded to V3 only when the application is first launched from a web browser. After that, the application can be started from the desktop shortcut or the Start menu. If the application is launched from the desktop shortcut on the first run, the error Failed to parse the configuration file is displayed. |
Tip
If your application is being upgraded from a version earlier than PowerBuilder 2022 R3 Build 3391, you can avoid the initial browser launch by performing the upgrade in two stages:
-
1. First upgrade to PowerBuilder 2022 R3 Build 3391.
-
2. Then upgrade from 3391 to PowerBuilder 2025 or later.
With this upgrade path, end users can launch the application directly from the desktop shortcut after upgrading, without first launching it from a web browser.


