combit List & Label 24 - .NET Online Web Help
Deployment
Programming Introduction > Deployment

To redistribute List & Label to end users no modules need to be registered and no files need to be copied to the system directory. Your application can therefore be installed on the end user's machine by simply copying the modules (xcopy Installation).

Before redistribution you have to enter your personal license key in the LicensingInfo property of the component. This key enables List & Label to determine the feature range that is available in the application according to your edition (, Professional or Enterprise). Your personal license key can be found in the file "PersonalLicense.txt".

 

Deployment

 

Redistribution Assistent

The Redistribution Assistant is available for putting together the redistribution files. In just a few steps, you can put together all the files required for your application and copy them directly to the correct target directory, create a ZIP archive or copy the file paths for further batch processing. The Redistribution Assistant can be found in the List & Label installation directory.

 

NuGet Package Support 

A NuGet package for use in Winforms applications is available, which automatically includes all necessary modules to run List & Label on the target system. The personalized URL to the package server can be retrieved from the "PersonalLicense.txt" file of the installation.

Hint: this package is only available for the Professional and Enterprise Edition. On GitHub you find an introduction to NuGet.

 

xcopy Installation

In the subfolder "Redistributable Files" of your List & Label installation you can find all redistributable files. Usually you will use all files (cm*.dll) and the additional modules (cm*.llx), as well as the assembly that is referenced by your application and at least one set of language files (cm*.lng). For 64-Bit you'll use the files from the x64-subfolder (cx*.dll and cm*.dll).

 

ClickOnce Deployment

In order to enable ClickOnce deployment for your VS project you need to add all dependencies to it. As List & Label also depends on the availability of other files, you need to add these dependencies, too. In order to do so, proceed as follows:

1. Create a folder for the dependencies. Right click the project in solution explorer, choose "Add > New Folder" and call the new folder "LLFiles".

2. Add the dependencies to the project. Right click the "LLFiles" folder and choose "Add > Existing Item...". Now select the List & Label redistributables from the "Redistributable Files" folder. The files are also listed in the "Redist.txt" file in the subfolder "Documentation" of your installation.

3. Select the just added files and set the "Build Action" property to "Content".

4. Finally, you have to set the installation target path for the List & Label files. In order to do so, you need to manually edit the project file (*.csproj/*.vbproj) with a standard ANSI editor (ex. Notepad). Within the "ItemGroup" block, add a "PublishFile" block for each file:

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

...

<ItemGroup>

   <PublishFile Include="LLFiles\cmLL24.dll">

     <Visible>False</Visible>

      <TargetPath>cmLL24.dll</TargetPath>

      <PublishState>Include</PublishState>

      <FileType>File</FileType>

   </PublishFile>

   <PublishFile Include="LLFiles\cmct24.dll">

      <Visible>False</Visible>

      <TargetPath>cmct24.dll</TargetPath>

      <PublishState>Include</PublishState>

      <FileType>File</FileType>

   </PublishFile>

 <!-- Add the additional files here -->

</ItemGroup>

</Project>

After saving and reloading your project you can now ClickOnce deploy your application.

Important: Backup your project file before manually editing it! Please note that Visual Studio re-enables the "ClickOnce Security Settings" with each build of the ClickOnce deployment. If you're using Windows Vista or newer, this leads to an error message whenever trying to debug the application from the IDE or starting the application. In order to debug your application, switch off the "ClickOnce Security Settings" checkbox from the solution's secutity properties. This has to be done every time you build the ClickOnce deployment.