Skip to content

Releases: Acumatica/ACUCustomizationUtil

25.11.10.1042

10 Nov 09:03

Choose a tag to compare

Release Notes – ACU Customization Utility
Version: 25.11.10.1042
Date: November 10, 2025

Changes:

  1. Removed: manifest.json generation, as packages with this file fail ISV certification. We plan to discuss this issue further with Acumatica, so we can replace this file with one that will not trigger automatic validations.

Full Changelog: 25.10.07.1326...25.11.10.1042

25.10.07.1326

07 Oct 11:33

Choose a tag to compare

Release Notes – ACU Customization Utility
Version: 25.10.07.1326
Date: October 7, 2025

Changes:

  1. Added: Modern UI support
  2. Improved: Minor code enhancements and corrections.

Full Changelog: 25.05.19.0920...25.10.07.1326

25.05.19.0920

19 May 07:17

Choose a tag to compare

Release Notes – ACU Customization Utility
Version: 25.05.19.0920
Date: May 19, 2025

Changes:

  1. Fixed: Incorrect file path recording for customization files when packaging has been resolved.
  2. Added: .editorconfig file introduced for code analyzer configuration; basic settings applied.
  3. Improved: Minor code enhancements and corrections.

25.05.09.1425

09 May 17:38

Choose a tag to compare

Acumatica Customization Utility — New Release

Version: 25.05.09.1425


Overview

This release introduces several important improvements and new features to the Acumatica Customization Utility, enhancing package management, metadata handling, and build processes.


What's New

  • Added REST client for managing customization packages.
  • Extended acu.json configuration with new parameters:
    • pkg.tenant
    • pkg.branch
    • src.msBuildPath
    • src.assemblyInfoPath
  • Customization package improvements:
    • Embed metadata into the customization *.dll.
    • Include metadata.json in the customization .zip package.
  • Assembly metadata handling:
    • Assembly version and metadata are now automatically written to AssemblyInfo.cs.
  • Build command enhancement:
    • Added pkgSuffix option to the src make command.

Upgrade Instructions

  1. Update your acu.json file to include the new parameters as needed.
  2. Adjust your project files by removing old BeforeBuild logic (see "Notes for Users").
  3. Ensure that new metadata is correctly incorporated both into assemblies and customization packages.

Notes for Users

1. Parameter --url / pkg.url Usage

In the CLI --url parameter must be specified in the following format:

http://localhost/<instance name>

In the configuration file (acu.json), the pkg.url parameter must be specified in the following format:

http://localhost/<instance name>

2. Project File Update

Remove the following BeforeBuild target from your project .csproj file to avoid conflicts with the new metadata management:

<Target Name="BeforeBuild">
  <ItemGroup>
    <AssemblyAttributes Include="AssemblyVersion">
      <_Parameter1>$(Version)</_Parameter1>
    </AssemblyAttributes>
  </ItemGroup>
  <MakeDir Directories="$(IntermediateOutputPath)" />
  <WriteCodeFragment Language="C#" OutputFile="$(IntermediateOutputPath)Version.cs" AssemblyAttributes="@(AssemblyAttributes)" />
  <ItemGroup>
    <Compile Include="$(IntermediateOutputPath)Version.cs" />
  </ItemGroup>
</Target>

3. Assembly Metadata

Metadata is now automatically embedded into the assembly using AssemblyMetadata attributes, for example:

[assembly: AssemblyMetadata("GitBranch", "develop")]
[assembly: AssemblyMetadata("GitHash", "6e1ba91843de136967c1f7720314cd31d9272f36")]
[assembly: AssemblyMetadata("BuildUser", "********")]
[assembly: AssemblyMetadata("BuildMachine", "*********")]

4. Manifest Metadata (metadata.json)

The metadata.json file included in the customization .zip now contains detailed build information:

{
  "GitBranch": "develop",
  "GitHash": "9d12753f2ae922d938ac17c0a7a3511eb1c2e742",
  "BuildUser": "******",
  "BuildMachine": "*******",
  "AssemblyVersion": "25.100.25117.1504",
  "MakeMode": "QA",
  "PackageName": "ACUCustomization_PM-001_[25.100.0054][25117.1504].zip"
}

Additional Information

For more details on migration or any issues during upgrade, please refer to internal documentation or contact the development team.


23.10.17.38782

17 Oct 19:13

Choose a tag to compare

Fixes:

  • command "src build" (assembly file version creation).
  • mode QA | ISV, if it is set in the configuration file.

23.10.3.29702

04 Oct 15:35

Choose a tag to compare

Fixed:

  1. algorithm for determining customization build number;
  2. algorithm for finding full path to MSBuild.exe;
  3. other minor fixes & refactoring.