LabVIEW 2012 Third Party Licensing & Activation Toolkit Help
»View Product Info
This task is the final step in the procedure for applying licensing to a development add-on.
After you create and license an add-on, prepare the add-on for distribution to users. Consider one of the following methods for distributing an add-on:
- Use the JKI VI Package Manager (VIPM) Professional or Enterprise edition software to bundle add-on files in a JKI VI Package file, a single file users can access to install the add-on with LabVIEW.
||Note Refer to the JKI website for more information about the VIPM software. Refer to the VIPM software documentation for information about using the VIPM software to bundle and share add-ons.
- In LabVIEW, use the Application Builder to create an Installer build specification and build an installer. The rest of this topic contains instructions for building an installer for a development add-on.
Whichever process you use to build an installer, make sure to install the correct files in the correct locations, as described in the steps below. LabVIEW uses these locations to find the files necessary to activate an add-on when a user wants to use the add-on.
Building an Installer in LabVIEW
Complete the steps in the following sections to build an installer using the Application Builder Installer build specification.
Prepare the Files Required to Build an Installer
- Create a LabVIEW project (.lvproj) and add the following files to the project:
- The library (.lvlib) file from step 1 that contains the add-on files.
- The license (.lf) file you created and applied to the library file.
- Create a VI that uses the System Exec VI to call RegisterAddon.exe, located in the LabVIEWInstallDir\resource\Partners directory, with the following command line:
RegisterAddon.exe -- -s -l path_to_lvlib
where l is a lowercase L, and path_to_lvlib is the path to the LabVIEW library relative to the LabVIEW installation directory.
- Save the new VI in the project.
- In the Project Explorer window, build an executable from the VI you create to call RegisterAddon.exe.
In the next section, you configure the installer to automatically run this executable and call RegisterAddon.exe. RegisterAddon.exe adds information about the add-on to the system registry of the computer on which you install the add-on. This ensures that LabVIEW prompts users to activate the add-on after they install the add-on.
Refer to the 07 Sample Toolkit Project example in the labview\examples\addonlicensing directory to see an example before you build an installer.
Configure the Installer Build Specification
- Open the LabVIEW project that contains the add-on (.lvlib) that you want to distribute.
- In the Project Explorer window, right-click Build Specifications and select New»Installer from the shortcut menu to display the Installer Properties dialog box.
||Note You also can open the 07 Sample Toolkit Project example in the labview\examples\addonlicensing directory and adapt the files and installer build specification in the .lvproj file.
- Select the Destinations category at the left of the dialog box, and if necessary, add the following new destinations:
- [LabVIEW X]»resource»Partners, where X is the LabVIEW version number.
- [Public App Data]»National Instruments»Partners»company name»Licenses, where company name is the same value you specified when you licensed the add-on.
- The directory in which you want to install the add-on files. If an existing destination is sufficient, proceed to the next step.
- Add the executable you created in the previous section to the [LabVIEW X]\resource\Partners destination.
- Select the Source Files category and add the license file (.lf) to the [Public App Data]»National Instruments»Partners»company name»Licenses destination.
- Select the Source File Settings category and, one at a time, select each of the license files you want to install and place a checkmark in the Unlock checkbox for each of the files, if necessary. This setting ensures that the license files work as expected when installed on a computer running Windows 7 or Windows Vista.
- Select the Additional Installers category and place a checkmark in the NI Third Party Add-on Activation Libraries checkbox in the National Instruments Installers to Include listbox.
- Select the Advanced category and place a checkmark in the Run executable at end of installation checkbox. The Select Target File dialog box appears.
- Select the executable that you created to call RegisterAddon.exe.
- Place a checkmark in the Require the LabVIEW x [32-bit or 64-bit] development system or later checkbox.
- (Optional) Configure other options in the installer to meet the needs of the add-on.
- Click the Build button to exit the dialog box and build the installer for the add-on.
You can distribute this installer to users. When the installer runs, it installs the add-on, and then runs the executable you create in the previous section to register the add-on.
Licensing a Development Add-on Workflow