ActiveReports 16 .NET Edition
ActiveReports 16 User Guide / Welcome to ActiveReports 16 / Install ActiveReports
In This Topic
    Install ActiveReports
    In This Topic

    This topic elaborates the steps to install ActiveReports 16, lists the files that are installed, and about Visual Studio Integration.

    Installing using Web Installer

    You can download the installer from here and then follow the steps.

    1. Double-click the installer.
    2. In the Welcome screen that appears, click the Accept End User License Agreement checkbox and click Next.
    3. In the screen that appears, select the release version to install from the drop-down list. If you want to change the default installation path, click Change in the Installation Directory area. Also, select the corresponding checkboxes for Visual Studio Templates installation and GrapeCity Customer Experience Program. After you select all necessary options, click Next.
    4. Once the installation finishes, a screen notifying of the successful installation appears. Select Exit to close the window and complete the installation process, or select Manage Licenses to continue with activating the license. See License Your ActiveReports for information on licensing.

    Installing using Offline Installer

    The complete setup of ActiveReports 16 can be installed using the offline file. For offline installation, please download our full installer from this link: ActiveReports-v16.1.2.msi

    1. Double-click the .msi file or right-click the file and select Install.
    2. On the End-User License Agreement screen that appears, go through the terms in the License Agreement.
      • If you want to continue with the default installation settings, select the check box to accept the license agreement and click Install to continue with the installation.
      • If you want to change the default installation path and the way product features are installed, do the following:

        1. Select Advanced and click Change.

        2. Specify the path for the installation and click OK.

        3. Click Next and select how controls, features, and samples are installed and integrated with Visual Studio versions.

        4. Select Install.

    3. On the User Account Control screen, select Yes to allow ActiveReports software installation on your PC.
    4. Once the installation finishes, a screen notifying the completion of the installation appears. Select Activate now check box and click Finish to close the window and complete the installation process.
    5. Click Yes on the User Account Control screen to continue with activating the license. See License Your ActiveReports for information on licensing.

    Installed Files

    You can verify the installation via installer by following the steps below:

    1. Open Visual Studio.
    2. From the Visual Studio Help menu, select About Microsoft Visual Studio and verify that ActiveReports 16 appears in the installed products list.

    When you run the installer (ActiveReports-v16.x.x.0.msi), you get necessary utilities such as standalone designer and viewer applications, import tool, and license manager, along with NuGet packages, localization resources, etc. If you use all of the default settings, files are installed in the following folders:

    C:\ProgramData\Microsoft\Windows\Start Menu\Programs\GrapeCity

    File (or Folder) Description
    ActiveReports 16 (folder) Shortcut to the folder containing stand-alone applications and Samples folder. See the next table for further details.
    GrapeCity License Manager Shortcut to the License Manager application.

    C:\ProgramData\Microsoft\Windows\Start Menu\Programs\GrapeCity\ActiveReports 16

    File (or Folder) Description
    ActiveReports 16 Designer Shortcut to the stand-alone designer application.
    ActiveReports 16 Import Shortcut to the ActiveReports Import wizard application.
    ActiveReports 16 Theme Editor Shortcut to the ActiveReports Theme Editor application.
    ActiveReports 16 User Guide(CHM) Shortcut to the Compiled HTML help file for ActiveReports.
    ActiveReports 16 User Guide(PDF) Shortcut to the PDF help file for ActiveReports.
    ActiveReports 16 User Guide(Web) Shortcut to the Online help file for ActiveReports.
    ActiveReports 16 Viewer Shortcut to the stand-alone ActiveReports Viewer application.

    C:\Program Files\GrapeCity\ActiveReports 16 (C:\Program Files (x86)\GrapeCity\ActiveReports 16 on a 64-bit Windows operating system)

    Folder Description
    Deployment Includes templates for WPF.
    Icons Includes associated Icons image files.
    Localization Includes Resource and DOS batch files for localizing ActiveReports components.
    NuGet Contains NuGet packages. See Available Packages for more information.
    Tools Includes all ActiveReports application, XML configuration files, and localization resources for designer and import tool in Chinese environment.
    VisualStudio Includes Microsoft Visual Studio application extension and bootstrapper application.
    GrapeCity.ActiveReports.config XML configuration file.


    File or Application Description
    gclm.exe License Manager setup file.
    gclm.exe.config License Manager setup XML configuration file.

    C:\Program Files\GrapeCity\ActiveReports 16\Tools (C:\Program Files (x86)\GrapeCity\ActiveReports 16\Tools on a 64-bit Windows operating system)

    File or Application Description
    zh-CN folder Includes resource files for the Chinese environment.
    GrapeCity.ActiveReports.Designer.exe Stand-alone designer setup file.
    GrapeCity.ActiveReports.Designer.exe.config Stand-alone designer setup XML configuration file.
    GrapeCity.ActiveReports.Designer.VisualElementsManifest.xml Stand-alone designer's .VisualElementsManifest xml file.
    GrapeCity.ActiveReports.Imports.exe ActiveReports Import application setup file.
    GrapeCity.ActiveReports.Imports.exe.config ActiveReports Import application setup XML configuration file.
    GrapeCity.ActiveReports.Imports.Win.exe ActiveReports Import wizard setup file.
    GrapeCity.ActiveReports.Imports.Win.exe.config ActiveReports Import wizard setup XML configuration file.
    GrapeCity.ActiveReports.SpreadBuilder.dll GrapeCity Excel API library for BIFF7 (Windows only), BIFF8, and OpenXML formats.
    GrapeCity.ActiveReports.ThemeEditor.exe ActiveReports Theme Editor setup file.
    GrapeCity.ActiveReports.ThemeEditor.exe.config ActiveReports Theme Editor setup XML configuration file.
    GrapeCity.ActiveReports.Viewer.exe Stand-Alone ActiveReports Viewer setup file.
    GrapeCity.ActiveReports.Viewer.exe.config Stand-Alone ActiveReports Viewer setup XML configuration file.
    GrapeCity.ActiveReports.WpfViewer.exe Stand-Alone ActiveReports WPF Viewer setup file.
    GrapeCity.ActiveReports.WpfViewer.exe.config Stand-Alone ActiveReports WPF Viewer setup XML configuration file.
    GrapeCity.ActiveReports.Chart.dll Chart control assembly file.
    GrapeCity.ActiveReports.Core.DataProviders.dll Data Providers assembly.
    GrapeCity.ActiveReports.Core.Drawing.Gc.dll Drawing Gc assembly file.
    GrapeCity.ActiveReports.Core.Drawing.Gdi.dll Drawing Gdi assembly file.
    GrapeCity.ActiveReports.Export.Excel.dll Excel Export assembly file.
    GrapeCity.ActiveReports.Core.Export.Excel.Page.dll Excel Export (for Page report) assembly file.
    GrapeCity.ActiveReports.Export.Html.dll HTML Export assembly file.
    GrapeCity.ActiveReports.Core.Export.Html.Page.dll HTML Export (for Page report) assembly file.
    GrapeCity.ActiveReports.Export.Image.dll Image Export assembly file.
    GrapeCity.ActiveReports.Core.Export.Image.Page.dll Image Export (for Page report) assembly file.
    GrapeCity.ActiveReports.Export.Pdf.dll HTML Export assembly file.
    GrapeCity.ActiveReports.Core.Export.Pdf.Page.dll HTML Export (for Page report) assembly file.
    GrapeCity.ActiveReports.Core.Export.Svg.Page.dll Svg Export assembly file.
    GrapeCity.ActiveReports.Core.Export.Text.Page.dll Text Export  (for Page report) assembly file.
    GrapeCity.ActiveReports.Core.Export.Pdf.Section ActiveReports RDF document PDF rendering implementation assembly file.
    GrapeCity.ActiveReports.Core.Export.Tiff.Section ActiveReports RDF document TIFF rendering implementation assembly file.
    GrapeCity.ActiveReports.Export.Word.dll Word Export assembly file.


    Word Export (for Page report) assembly file.
    DocumentFormat.OpenXml.dll OpenXML assembly file.
    Gcef.Data.DataEngine.dll Gcef's DataEngine assembly file.
    Gcef.Data.ExpressionInfo.dll Gcef's ExpressionInfo assembly file.
    Gcef.Data.VBFunctionLib.dll Gcef's VBFunctionLib assembly file.
    GrapeCity.ActiveReports.Design.Win.dll Windows Designer assembly file.
    GrapeCity.ActiveReports.Document.dll Document assembly file.
    GrapeCity.ActiveReports.Export.Rdf.dll RDF Export assembly file.
    GrapeCity.ActiveReports.Export.Xml.dll XML Export assembly file.
    GrapeCity.ActiveReports.Interop.dll Native functions assembly file.
    GrapeCity.ActiveReports.Core.Rdl.dll RDL assembly file.
    GrapeCity.ActiveReports.Core.Rendering.dll Rendering assembly file.
    GrapeCity.ActiveReports.Core.Scripting.dll Scripting support assembly file.
    GrapeCity.ActiveReports.Core.Svg.dll Svg Rendering Engine assembly file.
    GrapeCity.ActiveReports.dll Run time engine assembly file.
    GrapeCity.ActiveReports.Viewer.Win.dll Windows Viewer assembly file.
    GrapeCity.ActiveReports.Viewer.Wpf.dll WPF Viewer assembly file.
    GrapeCity.DataVisualization.dll Data visualization assembly file.
    GrapeCity.Documents.Common.dll Assembly file used by Documents PDF.
    GrapeCity.Documents.Common.Windows.dll Assembly file required for providing support for font linking specified in the Windows registry and access to native Windows imaging APIs, improving performance and adding some features (e.g. TIFF support)
    GrapeCity.Documents.DX.Windows.dll Assembly file used by GrapeCity.Documents.Common.Windows.dll.
    GrapeCity.Documents.Imaging.dll Assembly file for image handling.
    GrapeCity.Documents.Pdf.dll Documents Pdf assembly file to handle the PDFs.
    System.IO.Compression.dll Compression/decompression assembly file.
    GrapeCity.ActiveReports.Imports.Access.dll Microsoft Access Import assembly file.
    GrapeCity.ActiveReports.Imports.Crystal.dll Crystal Reports Import assembly file.
    GrapeCity.ActiveReports.Imports.Excel.dll Excel Import assembly file.
    GrapeCity.ActiveReports.Imports.RPX.dll RPX Import assembly file.

    Note: Samples and data used in the samples are not included with the installer. You need to download them separately from GitHub.

    Visual Studio Integration

    The ActiveReports installation provides you with following Visual Studio Integrations that help you configure projects and design reports.

    Project Templates

    Create a report layout using built-in sample application templates:

    Item Templates

    Add following item templates to your project:

    Toolbox with Report Controls

    A new ActiveReports 16 tab is automatically added in the toolbox with the controls in sync with the references.

    Integrated Designer

    ActiveReports offers an integrated designer that lets you create report layouts in Visual Studio and edit them at design time, visually, and through code and scripts. Along with the designer, you can use:

    Conversion Tool

    Use the conversion or upgrade tool - Convert to ActiveReports 16 - to easily upgrade to the latest version. This tool is available under the Tools menu option of Visual Studio.

    To Remove Visual Studio Integration

    In case you want to disable or uninstall GrapeCity ActiveReports 16 Visual Studio integration, do the following.

    1. In Visual Studio 2019 and Visual Studio 2022, go to ExtensionsManage Extensions.
      In earlier supported versions of Visual Studio, go to the Tools menu and click Extensions and Updates.
    2. Navigate to GrapeCity ActiveReports 16 and click Disable or Uninstall.

     Extensions and Update window

    In case you want to install the integration again, follow these steps.

    1. Go to the installation folder - C:\Program Files\GrapeCity\ActiveReports 16\VisualStudio (C:\Program Files (x86)\GrapeCity\ActiveReports 16\VisualStudio on a 64-bit Windows operating system).
    2. Run the VSIX as per your Visual Studio Version.


    • It is not possible to install ActiveReports 16 and ActiveReports 13 side-by-side.           
    • It is not possible to use different versions of ActiveReports for .NET within a single Visual Studio project.
    • If you are creating an ActiveReports 16 application in Visual Studio 2017 or Visual Studio 2019 or Visual Studio 2022, and you also have ActiveReports 13 installed in the supported Visual Studio version, then you may get a few errors in the property grid such as 'Object does not match target type' or 'Object reference not set to an instance of Object'. This issue is related to Visual Studio; you just need to restart Visual Studio to resolve the issue. Before restart, save the project, if necessary.
    • When using our Integrated Designer in Visual Studio 2022, you may observe invisible controls in our smart panels or tool windows (such as Report Explorer or Layers List). To solve this issue, navigate to Tools > Options > Environment > General and clear the 'Optimize rendering for screens with different pixel densities' checkbox.

    Customer Experience Program

    When you optionally join the Product Usage Program, your computer automatically transmits information to GrapeCity about the usage of GrapeCity products. This information is used to address issues within GrapeCity products and improve quality/usability.

    The Product Usage Program is strictly optional and you can opt-in or opt-out of the program at any time by executing the Web installer and making the appropriate selection within the installation program. The Product Usage Program does not transmit any personally identifiable information such as your name, address, or phone number. The Product Usage Program only collects information related to GrapeCity controls and libraries. This information includes the usage of GrapeCity controls at design time within Visual Studio. No information is collected from applications/demos you create.

    See Also