| VirtualPrinterDriverDeploymentTool Usage Guide |
\Examples\VirtualPrinter\DotNet\VirtualPrinterDriverDeploymentTool\fx |
\Bin\DotNet4\<Win32/x64>\VirtualPrinterDriverDeploymentTool.exe |
VirtualPrinterDriverDeploymentTool Usage Guide
Step 1: Creating the deployment package
- Build and run the project on your development machine. Note, you'll generally want to run the 64-bit version for generating the package
- Click the Create Package button:
- If you're using the latest SDK, it should already default to your SDK's installation path. If not, simply use the Browse button and select the root for your SDK's installation:
- Ensure the architecture you are wanting to deploy is selected. You'll generally want to include both 32-bit and x64 when generating the package, as you can choose which to use during deployment.
- Finally, click the Create Package button:
- You will be prompted for a save file location. For the purposes of demonstration, I've used "C:\temp\Package.zip":
- A few moments after clicking Save you should see a dialog confirming the package was created:
Step 2: Copying files to deployment machine
- Build the project under Release mode, with the architecture you'll be using for deployment, typically x64:
- Once the project is built, go to the output folder (actual path may change based on architecture):
\VirtualPrinterDriverDeploymentTool\bin\x64\Release
- Copy the following files to a your deployment machine:
> VirtualPrinterDriverDeploymentTool.exe
> Package.zip [created in Step 1]
Step 3: Deploying
- Run the VirtualPrinterDriverDeploymentTool.exe as administrator
- Click the Deploy Package button:
- Choose your deployment destination. For the purposes of example, I've changed the path to "(LEADTOOLS Installation folder)":
- Ensure the architecture options are configured properly. If you would like to include the 32-bit driver during a 64-bit installation, that is also available:
- The last option is mainly used for development purposes. By checking this box, it will deploy to a folder structure similar to the full SDK. By not checking this box, it will deploy to a simplified folder structure.
> Structure when not checked:
++ OutputDir\PrinterDriver
++ OutputDir\Virtual Printer
> Structure when checked (integrated deployment):
++ OutputDir\Bin\Common\PrinterDriver
++ OutputDir\Redist\Virtual Printer
- When all options are configured, click the Deploy Package button:
- You will then be prompted to open the ZIP created during Step 1:
- After clicking Open a diagnostic log will appear listing each step of the installation process.
- If you have not installed these drivers before, you will be prompted by a Windows Security dialog. Ensure you click Install. Checking Always trust is optional of course:
- Once everything has been installed, you should see the following success dialog. And as the dialog states, a restart may be required.
- If an error has occurred, ensure you have followed any instructions listed. If you are unable to correct the deployment issue manually, please contact the LEADTOOLS Support department: support@leadtools.com
Step 4: Uninstalling
- Run the VirtualPrinterDriverDeploymentTool.exe as admin:
- Click the Uninstall button:
- Ensure your deployment directory is selected (this will typically be saved from the previous deployment using .NET's application settings):
- Click the Uninstall button:
- You will now see a diagnostic log displaying all uninstallation steps.
- If you had previously integrated your installation, or the path has "LEADTOOLS ##" in the name, it will prompt during uninstallation if you'd like to delete the files. This allows users to test on their development machine without worrying it will delete the required deployment files:
- Once it has uninstalled, you should see the following success message:
- Again, if any errors occur, there will be information in the log. If any assistance is required for an error during uninstallation, please contact the LEADTOOLS support department at support@leadtools.com.
Copyright (c) 1991-2023 LEAD Technologies, Inc.
All Rights Reserved. |
