Releases: Acumatica/ACUCustomizationUtil
25.11.10.1042
Release Notes – ACU Customization Utility
Version: 25.11.10.1042
Date: November 10, 2025
Changes:
- Removed:
manifest.jsongeneration, 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
Release Notes – ACU Customization Utility
Version: 25.10.07.1326
Date: October 7, 2025
Changes:
- Added: Modern UI support
- Improved: Minor code enhancements and corrections.
Full Changelog: 25.05.19.0920...25.10.07.1326
25.05.19.0920
Release Notes – ACU Customization Utility
Version: 25.05.19.0920
Date: May 19, 2025
Changes:
- Fixed: Incorrect file path recording for customization files when packaging has been resolved.
- Added:
.editorconfigfile introduced for code analyzer configuration; basic settings applied. - Improved: Minor code enhancements and corrections.
25.05.09.1425
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.jsonconfiguration with new parameters:pkg.tenantpkg.branchsrc.msBuildPathsrc.assemblyInfoPath
- Customization package improvements:
- Embed metadata into the customization
*.dll. - Include
metadata.jsonin the customization.zippackage.
- Embed metadata into the customization
- Assembly metadata handling:
- Assembly version and metadata are now automatically written to
AssemblyInfo.cs.
- Assembly version and metadata are now automatically written to
- Build command enhancement:
- Added
pkgSuffixoption to thesrcmake command.
- Added
Upgrade Instructions
- Update your
acu.jsonfile to include the new parameters as needed. - Adjust your project files by removing old
BeforeBuildlogic (see "Notes for Users"). - 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
Fixes:
- command "src build" (assembly file version creation).
- mode QA | ISV, if it is set in the configuration file.
23.10.3.29702
Fixed:
- algorithm for determining customization build number;
- algorithm for finding full path to MSBuild.exe;
- other minor fixes & refactoring.