Uninstalling the PowerClient project – PB Docs 2022

To uninstall the PowerClient project from the client
machine:

1. Uninstall the application by selecting the Uninstall shortcut menu from the Windows
   Start | [appname].

   The Uninstall menu and the
   [appname] menu are available only
   when the developer selected to create the start menu shortcut in
   the Startup page > Basic tab of the Project painter for
   PowerClient. If the Uninstall
   menu is not available, you can run the Uninstall.exe file in the application
   folder, for example,
   %AppData%PBAppsApplicationslocalhost_app1Uninstall.exe
   (%AppData%PBApps is configurable when uploading the Cloud App
   Launcher and runtime files).

   Note: If the application
   folder name (which is named after [appname]) on the server has
   been changed manually, the application uninstall program will fail
   to run.

   The uninstall program will automatically remove the
   following:

   • The application shortcuts on the desktop and the Windows
     start menu.

   • The application folder under
     %AppData%PBAppsApplications, for example,
     %AppData%PBAppsApplicationslocalhost_app1.

     The application folder contains all of the application
     files and any external files (such as UI theme files,
     DLLs/OCXs, images/videos, INIs etc.) that are deployed with
     PowerClient. This folder will be automatically deleted during
     the uninstall process.

   However, the uninstall program will NOT automatically remove the
   following:

   • The registration information of DLL/OCX files in the
     Windows registry.

     If you have selected to register the DLL/OCX files
     (using Regsvr32 by default), you will need to remove the
     registry information manually. Follow instructions in step 4
     below.

   • The runtime files under
     %AppData%PBAppsApplicationsRuntime.

     The PowerBuilder Runtime files are used by all deployed
     apps on the client machine. You can manually delete the
     runtime files if they are no longer used.

   • The download folder under %AppData%PBApps, for example,
     %AppData%PBAppsDownload.

     This folder stores the download statistics of the app
     and runtime files. It can be manually deleted.

2. Uninstall the cloud app launcher by uninstalling Cloud App Launcher from Control
   PanelProgramsPrograms and Features.

   If the public version of the cloud app launcher is
   installed, it can only be uninstalled by the administrator.

3. Uninstall the cloud app service by uninstalling Cloud App Launcher Service from Control
   PanelProgramsPrograms and Features.

4. Remove the registry information of DLL/OCX files.

   The registry information of DLL/OCX files (or any other
   files that are installed and registered by your own) will not be
   automatically removed during the application uninstall
   process.

   To clean up the registry information of the DLL/OCX files,
   you can write scripts (a sample shown below) and place them in a
   file named ManualUninstall.cmd,
   place the ManualUninstall.cmd
   file under the same directory as the application target (.pbt)
   file, add ManualUninstall.cmd
   under Files preloaded as compressed
   packages or Files preloaded in
   uncompressed format in the External Files page, and then deploy the
   application.

   The scripts in ManualUninstall.cmd will be automatically
   run when the application uninstall program is run. (If the file
   requires administrator rights to unregister, you should run the
   application uninstall program with administrator rights.)

   You can also add scripts in ManualUninstall.cmd to clean up any other
   files that are installed and registered by your own.

   The following is a sample script for unregistering DLL/OCX
   files that are registered by Regsvr32:

   PowerBuilder

   set Driver=%~d0 set HOMEDIR=%~dp0 %Driver% cd %HOMEDIR% regsvr32 /u .dllname regasm /unregister .AssemblyName

   1 2 3 4 5 6

   set Driver=%~d0 set HOMEDIR=%~dp0 %Driver% cd %HOMEDIR% regsvr32 /u .dllname regasm   /unregister .AssemblyName