Skip to main content
All docs
V25.2
  • VCL Reports/Dashboards App Deployment

    • 2 minutes to read

    ExpressDashboards and ExpressReports components use the WebView2 Runtime as a dependency. To build and deploy an application that includes any of these components, you must ship a native and architecture-specific WebView2Loader.dll file with a built executable file using post-build events available as part of the RAD Studio IDE toolchain.

    Prerequisites

    Ensure that your development environment meets ExpressDashboards and ExpressReports prerequisites:

    1. Microsoft Windows 10 or newer.
    2. Embarcadero RAD Studio IDE 12.3 or newer (Community Edition IDEs are not supported).
    3. DevExpress VCL v25.2.x installed with the VCL Subscription+ (or a compatible license).
    4. The EdgeView2 SDK package installed from the GetIt package manager.

    Post-Build Events for WebView2 Loader DLL Deployment

    To automatically place a 32 or 64-bit WebView2Loader.dll file into the target build folder, you must:

    1. Open the Project Options dialog (select the ProjectOptions… item in the RAD Studio menu or press Ctrl + Shift + F11).
    2. Select BuildBuild Events in the tree view pane on the left and select the following option in the Target combo box:

      'All Configurations - All Platforms'

      VCL Shared Libraries: Project Options — Select the Target Platform

    3. Copy the following command line:

      copy /Y "$(BDS)\Redist\$(Platform)\WebView2Loader.dll" $(OUTPUTDIR)
      
    4. Paste the DLL deployment command line into the Commands box:

      VCL Shared Libraries: Paste the DLL Deployment Command Line

    5. Click the Save button to apply pending changes and close the Project Options dialog.

    6. Build the project. Confirm that the configured post-build event is trusted in the following dialog:

      VCL Reports: The "Trust this Project" Dialog

    All build operations in the current RAD Studio project now ensure that the platform-specific WebView2Loader.dll file version is available in the target build folder (for both Debug and Release configurations).

    Important

    Make certain that you distribute the copied WebView2Loader.dll file in the same folder as the built executable file.

    See Also