Before you start the installation, verify that your system complies with the LuciadCPillar Hardware and software requirements.
Installing LuciadCPillar for C# development
To install LuciadCPillar and compile the C# samples:
-
Extract the
LuciadCPillar_Pro-Windows.zip
archive. -
Extract the
LuciadCPillar_Pro_Documentation.zip
archive. -
Extract the
LuciadCPillar_Pro_Data.zip
archive. -
Copy your LuciadCPillar license file, named
luciadcpillar_development.txt
, into the folderlicenses
. -
Open the x64 Native Tools Command Prompt that came installed with the Visual Studio version you are working in.
-
Go to the extracted folder.
-
Go to the folder
csharp
:>cd csharp
-
Create a folder
build
, and step into that folder:>mkdir build >cd build
-
Generate the Visual Studio solution.
-
Make sure that the environment variable PATH includes the directory containing
nuget.exe
. Alternatively, you can specify it on thecmake
command line by adding the parameter-DCMAKE_PROGRAM_PATH=c:\directory\containing\nuget
. See the next step for a command line example. -
Use CMake to generate the Visual Studio solution with the generator related to your Visual Studio version. These are some examples of
cmake
commands:>cmake ../ -G "Visual Studio 16 2019" -A x64 -DCMAKE_PROGRAM_PATH="C:\directory\containing\nuget"
or
>cmake ../ -G "Visual Studio 17 2022" -A x64 -DCMAKE_PROGRAM_PATH="C:\directory\containing\nuget"
-
-
Open the generated solution file
csharp/build/AllSamplesCSharp.sln
with Visual Studio. -
Select
ALL_BUILD
in the Solution Explorer underCMakePredefinedTargets
, go to Build > Configuration Manager, and select the desired Active solution configuration. -
Right-click
ALL_BUILD
in the Solution Explorer, and click Build to build all samples. -
Select the sample you want to run. For instance, to select csharp_sample_wpf:
-
Right click on csharp_sample_wpf in the Solution Explorer.
-
Select Set as StartUp Project.
-
-
Run the application, by clicking the Start button for example.
Using NuGet
A LuciadCPillar release includes a NuGet package, Luciad.CPillar.SDK
, in the csharp/packages
folder, that you can publish
to a private package feed. After publishing, you can include LuciadCPillar in your project just like any other package.
The supplied NuGet package just contains the LuciadCPillar API. If you want to use the integration code or sample code in your project, you can also turn the samples into NuGet Packages:
-
Install the samples as described in Installing LuciadCPillar for C# development. Select the Release configuration to build them.
-
Go to the sample directory in
csharp/build/samples
and run the following command:>nuget pack <nuspec file name>
The sample directory now has a NuGet package, which you can add to your local feed.
For your convenience, there is a batch script, |
Troubleshooting
See troubleshooting for commonly encountered problems.