Before you begin
Before deploying a Windows application, there are a few settings that can be helpful.
- On report files, in the Properties window, change the Copy to Output Directory property to Copy always.
- For ActiveReports references, change the Copy Local property to True. This puts all of the needed reference assemblies into the Release folder when you build your project.
It is also good to be sure that all of the references you need for your reports are included. Here is a table listing features and required DLLs.
Features and References
These assemblies are added automatically when you add controls to forms or report controls to code-based section reports, but Visual Studio does not do this with XML-based (RPX and RDLX) reports.
| Feature |
Required Assembly |
Export:
Excel, Html, Image/Tiff, Pdf, Word/Rtf, Text/Xml |
GrapeCity.ActiveReports.Export.*.v12.dll
(replace * with Excel, Html, Image, Pdf, Word, or Xml) |
| Chart report control |
GrapeCity.ActiveReports.Chart.v12.dll |
| Calendar report control |
GrapeCity.ActiveReports.Calendar.v12.dll |
| Sparkline or Bullet report control |
GrapeCity.ActiveReports.Dashboard.v12.dll |
| Viewer control (or printing without the Viewer control) |
GrapeCity.ActiveReports.Viewer.Win.v12.dll |
| Designer, Toolbox, or ReportExplorer control |
GrapeCity.ActiveReports.Design.Win.v12.dll |
| Working with Open report from server dialog |
GrapeCity.ActiveReports.ArsClient.v12.dll
Newtonsoft.Json.dll |
|
Preview remote reports from using code
|
Newtonsoft.Json.dll
For more information, see http://www.newtonsoft.com/json for obtaining the assembly. |
XCopy Deployment
- Open your project in Visual Studio, and set the Solution Configuration to Release.
- From the Build menu, select Build Solution.
- In Windows Explorer, navigate to the project's bin directory, and copy the files from the Release folder into a zip file.
- Distribute the zip file.
MSI Installer Deployment
To create an installer project
- Open an existing ActiveReports project or create a new one.
- From the Visual Studio Build menu, select Build YourActiveReportsProjectName to build your report project.
- From the File menu, select Add, then New Project to open the Add New Project dialog.
- In the Add New Project dialog under Project Types, expand the Other Project Types node and select Setup and Deployment.
- Under Visual Studio Installer, select Setup Project, rename the file and click OK. The ProductName that you enter determines the name that is displayed for the application in folder names and in the Programs and Features control panel item.
- In the File System editor that appears, under File System on Target Machine, select the Application Folder.
Note: To show the File System editor at any time, drop down the View menu and select Editor, then File System.
- From the Visual Studio Action menu, select Add, then Project Output.
- In the Add Project Output Group dialog that appears, choose your ActiveReports project name from the drop-down list.
- In the list, select Primary Output and click OK. This adds all of the existing assembly dependencies to your project.
- If you want to add other ActiveReports DLLs to the installer (e.g. if you use OleObjects on reports, you need to include the Interop.dll or Interop64.dll for 64-bit machines), in the Solution Explorer, right-click the installer project name, select Add, then Assembly.
- In the Select Component dialog that appears, select any components that you want to add and click the OK button.
- From the Visual Studio Build menu, select Build YourInstallerProjectName to build your Installer project.
To deploy the installer application
- Select the Installer project in the Solution Explorer.
- From the Visual Studio Project menu, click Install.
- The Installer application runs and installs the project on your computer. The distributable exe and msi setup files appear in your installer project Debug folder.
See Also