README.md |
---|
If you like or are using this project please give it a star. Thanks!
To use the ExcelDnaPack tool in your build process, download the latest version of the ExcelDnaPack
NuGet package from nuget.org or from the Releases tab on GitHub, expand it to disk and run the executable under tools/ExcelDnaPack.exe
with the arguments documented in the usage section.
ExcelDnaPack is a command-line utility to pack ExcelDna add-ins into a single .xll file.
Usage: ExcelDnaPack.exe dnaPath [/O outputPath] [/Y]
dnaPath The path to the primary .dna file for the ExcelDna add-in.
/Y If the output .xll exists, overwrite without prompting.
/NoCompression no compress (LZMA) of resources
/NoMultiThreading no multi threading to ensure deterministic packing order
/O outPath Output path - default is <dnaPath>-packed.xll.
Example: ExcelDnaPack.exe MyAddins\FirstAddin.dna
The packed add-in file will be created as MyAddins\FirstAddin-packed.xll.
The template add-in host file (the copy of ExcelDna.xll renamed to FirstAddin.xll) is
searched for in the same directory as FirstAddin.dna.
The Excel-Dna integration assembly (ExcelDna.Integration.dll) is searched for
1. in the same directory as the .dna file, and if not found there,
2. in the same directory as the ExcelDnaPack.exe file.
ExcelDnaPack will also pack the configuration file FirstAddin.xll.config if it is
found next to FirstAddin.dna.
Other assemblies are packed if marked with Pack="true" in the .dna file.
Use the Cake.ExcelDnaPack addin for the Cake build automation system that enables you to use ExcelDnaPack for packing Excel-DNA addins into a single .xll file. Cake.ExcelDnaPack targets .NET 5.0, .NET Standard 2.0 and .NET Framework 4.6.1, and runs on Windows.
e.g.
#tool "nuget:?package=ExcelDnaPack&version=1.5.1"
#addin "nuget:?package=Cake.ExcelDnaPack&version=2.0.0"
Task("Pack")
.Does(context =>
{
ExcelDnaPack(@"MyAddins\FirstAddin.dna");
});
RunTarget("Pack");
Make sure the &version=
attribute references the latest versions of ExcelDnaPack and Cake.ExcelDnaPack available on nuget.org.
For more details on how Cake.ExcelDnaPack
works, check its documentation.
Click on the Releases tab on GitHub.
Copyright ยฉ 2021-2023 Excel-DNA Contributors - Provided under the Apache License, Version 2.0.
The ExcelDnaPack tool is Copyright ยฉ 2005-2023 Govert van Drimmelen - Provided under the zLib license. See file LICENSE.txt included in the NuGet package.