vcl-405773-expresscrossplatformlibrary-vcl-backend-reports-dashboards-app-deployment.md
ExpressDashboards and ExpressReports components use the WebView2 Runtime as a dependency to display content. To build and deploy an application that includes any of these components, you must ship a native and architecture-specific WebView2Loader.dll file[1] with a built executable file using post-build events available as part of the RAD Studio IDE toolchain.
In this topic…
Note
Ensure that your development environment meets ExpressDashboards and ExpressReports prerequisites:
To automatically place a 32 or 64-bit WebView2Loader.dll file into the target build folder, you must:
Open the Project Options dialog (select the Project → Options… item in the RAD Studio menu or press Ctrl + Shift + F11).
Select Build → Build Events in the tree view pane on the left and select the following option in the Target combo box:
Copy the following command line:
Paste the DLL deployment command line into the Commands box:
Click the Save button to apply pending changes and close the Project Options dialog.
Build the project. Confirm that the configured post-build event is trusted in the following 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
Ensure that you distribute the copied WebView2Loader.dll file in the same folder as the built executable file.
Depending on your business needs and desired app functionality, you may need to deploy additional resources and dependencies with the built executable file.
To localize UI elements for ExpressReports and ExpressDashboards, do the following:
Log in to the DevExpress website and use the DevExpress Localization Service to obtain localization resources for all desired languages and components.
Extract all downloaded localization resources from self-extracting archives you downloaded using links contained within the email. Each resource archive contains a json resources folder.
Create a localization subfolder in the directory where your executable app file is located and copy extracted json resources/dxreporting.xx.json files into the folder for each target culture/language.
Tip
Refer to the following help topic for detailed information: Report Viewer and Designer UI Localization.
If you use the following relational database management systems (RDBMS) as data sources for ExpressReports and ExpressDashboards components, you need to deploy corresponding database provider assemblies with the built executable file:
PostgreSQLPostgreSQL is an open-source database management system.MySQLMySQL is an open-source relational database management system developed by the Oracle Corporation.Oracle DatabaseOracle Database is a proprietary multi-model database management system developed by the Oracle Corporation.FirebirdFirebird is an open-source SQL relational database management system.
Download and deploy required assemblies into a dotnet_libraries subfolder according to the steps listed in the following help topic for corresponding database engines: Supported Database Systems.
Tip
VCL Backend implementation has built-in support for Microsoft SQL, Azure SQL, and SQLite database engines.
You can use the TdxBackendDatabaseSQLConnection component to connect TdxDashboard/TdxDashboardControl and TdxReport components to these databases without additional dependencies and extra configuration.
Footnotes
See Also