Files to be included with your application |
|
Important note about installed version
This section of the documentation applies to the full purchased version only: the trial version of the component comes with an internal protection schema against fraudulent uses which will block most functionalities when the component is redistributed outside of the development machine where the trial version was originally installed through the provided setup program.
|
The component's assembly that you need to redistribute with your application depend upon the target .NET platform:
• | for .NET framework 2.0, 3.0 or 3.5 with reference to ActiveDjConsoleNetApi used inside the project |
- ActiveDjConsoleNetApi.dll
• | for .NET framework 4.0 or higher with reference to ActiveDjConsoleNetApiF4 used inside the project |
- ActiveDjConsoleNetApiF4.dll
• | for .NET 5 with reference to ActiveDjConsoleNetApiF5 used inside the project |
- ActiveDjConsoleNetApiF5.dll
• | for .NET 6 with reference to ActiveDjConsoleNetApiF6 used inside the project |
- ActiveDjConsoleNetApiF6.dll
• | for .NET Core 3.1 with reference to ActiveDjConsoleNetApiCore3 used inside the project |
- ActiveDjConsoleNetApiCore3.dll
All of the mentioned assemblies work as wrappers for the multimedia engine whose binary file must be redistributed as well:
• | If compiling for "Any CPU" |
- the x86 version of the multimedia engine DjConsMmsEng.dll
- the x64 version of the multimedia engine DjConsMmsEng64.dll
• | If compiling specifically for x86 |
- the x86 version of the multimedia engine DjConsMmsEng.dll
• | If compiling specifically for x64 |
- the x64 version of the multimedia engine DjConsMmsEng64.dll
You can find redistributable files mentioned above inside the folder in which you installed Active MIDI DJ Console for .NET (default "C:\Program Files\MultiMedia Soft\Active MIDI DJ Console for .NET\Redist").
Important note about the folder chosen for installing our files
In order to avoid the "DLL Hell" problem, it's strongly recommended that you install the mentioned files into the same folder in which you will install the EXE of your container application on the target system and not inside the Windows\System32 or Windows\SysWOW64 folders.
|
How to create a "ClickOnce" setup containing our component using Visual Studio .NET
• | Inside the "Solution Explorer" open "References" |
• | Locate and select the reference to ActiveDjConsoleNetApi |
• | Inside the "Properties" window locate the "Copy Local" property and set it to "True" |
• | Inside the "Solution Explorer" right-click the project name |
• | From the context menu select "Add\Existing Item..." |
• | Inside the "Objects of type" combobox select "Executable files" |
• | Locate the directory where DjConsMmsEng.dll and DjConsMmsEng64.dll are installed (by default should be under "C:\Program Files\MultiMedia Soft\Active MIDI DJ Console for .NET\Redist") |
• | Select DjConsMmsEng.dll and DjConsMmsEng64.dll and press the "Add" button |
• | for both of them change the "Copy to Output Directory" property to "Copy always" |
• | Rebuild the ClickOnce package |