README.md

ExcelDnaPack - NuGet package

ExcelDnaPack distributed as a NuGet package for use as a tool in build scenarios.

Give a Star! ⭐

If you like or are using this project please give it a star. Thanks!

Getting started 🚀

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 usage

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.

Using ExcelDnaPack with Cake Build

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.

Release History

Click on the Releases tab on GitHub.

augustoproiete / exceldnapack-nuget Goto Github PK

exceldnapack-nuget's Introduction

ExcelDnaPack - NuGet package

Give a Star! ⭐

Getting started 🚀

ExcelDnaPack usage

Using ExcelDnaPack with Cake Build

Release History

License

exceldnapack-nuget's People

Contributors

Stargazers

Watchers

Forkers

exceldnapack-nuget's Issues

Recommend Projects

Recommend Topics

Recommend Org