跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
部署与云服务

revit-addin-bundle

Package a versioned Autodesk Revit add-in as an Autodesk App Store bundle with the Nice3point.Revit.Templates ModularPipelines build. USE FOR: setting the bundle vendor metadata and version, and running the build to produce a versioned .bundle with per-Revit-year contents for App Store distribution. DO NOT USE FOR: per-build deploy or publish to a local Revit (use revit-addin-publishing), or launching and debugging (use revit-addin-debugging).

Nice3point · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Nice3point/revit-skills --skill revit-addin-bundle

技能说明


name: revit-addin-bundle description: > Package a versioned Autodesk Revit add-in as an Autodesk App Store bundle with the Nice3point.Revit.Templates ModularPipelines build. USE FOR: setting the bundle vendor metadata and version, and running the build to produce a versioned .bundle with per-Revit-year contents for App Store distribution. DO NOT USE FOR: per-build deploy or publish to a local Revit (use revit-addin-publishing), or launching and debugging (use revit-addin-debugging). license: MIT

Revit Add-in Bundle

An Autodesk App Store add-in ships as a .bundle — a PackageContents.xml with a Contents/<year> folder for each supported Revit version. A solution scaffolded from the templates with bundle support contains a ModularPipelines build project whose pack command assembles the bundle from every version's publish output and stamps it with a version. A solution created without bundle support requires the bundle infrastructure files first (see Common Pitfalls).

When to use

  • Packaging an add-in as an Autodesk App Store bundle.
  • Setting the vendor metadata and version of the bundle.

Workflow

Step 1: Set vendor metadata

Set the vendor fields in the Bundle section of build/appsettings.json (VendorName is required):

"Bundle": {
"VendorName": "Acme Corporation",
"VendorUrl": "https://acme.com",
"VendorEmail": "support@acme.com"
}

Step 2: Resolve the version

GitVersion derives the bundle's AppVersion from Git tags; a fixed Version in build/appsettings.json overrides it. Tag the commit before packing. GitVersion requires at least one commit in the repository history.

Step 3: Build the bundle

Run the pack command from the build directory. It compiles every supported Revit configuration, then assembles the bundle from each configuration's publish output. The same run also produces an installer only when the solution was scaffolded with installer support:

cd build
dotnet run -c Release -- pack

The result is a zipped .bundle under output/, laid out per version:

RevitAddIn.bundle/
  PackageContents.xml
  Contents/
    2025/
      RevitAddIn.addin
      RevitAddIn/RevitAddIn.dll
    2026/
      RevitAddIn.addin
      RevitAddIn/RevitAddIn.dll

The generated PackageContents.xml contains the product name, AppVersion, the vendor metadata, and one component entry per Revit year.

Step 4: Verify

Confirm the bundle has a Contents/<year> folder for every supported version and that PackageContents.xml shows the expected version and vendor fields, then upload it to the Autodesk App Store.

Validation

  • VendorName (at minimum) is set in the Bundle section of build/appsettings.json.
  • The version derives from a Git tag, or an explicit Version.
  • The bundle contains a Contents/<year> folder for each supported Revit version.

Common Pitfalls

PitfallCorrect approach
Building before any Git commitMake an initial commit before the build.
Hand-numbering versionsTag the commit and let GitVersion derive the version.
Shipping a bundle without vendor metadataSet the Bundle fields in build/appsettings.json.
Packing a solution scaffolded without bundle supportFirst create the solution with bundle support (dotnet new revit-addin-sln --bundle) and transfer the bundle infrastructure files from a temporary --bundle solution (see revit-template-migration).
A Revit year missing from the bundlepack builds every configured version. Add the year to the configuration matrix (revit-multi-version-configuration).