Documentation
This documentation describes ALWasp 0.8.0. Each guide covers one task. The reference pages give exact options and data.
Start
Install the tool and make the first build.
Getting Started
Install ALWasp, create alwasp.json, restore symbols, and make your first build in about five minutes.
Installation
Install, update, pin, and remove the ALWasp .NET tool.
Configuration
Understand alwasp.json inventories, profiles, targets, restore settings, transformations, and schema validation.
Guides
One page for each task: restore, build, verify, package, translate, automate.
Restore
How ALWasp finds and downloads AL symbol packages: sources, dependency discovery, feed order, version selection, and overrides.
Build
Compile configured targets, discovered project folders, one project, or a VS Code workspace, and control output, rulesets, manifests, and diagnostics.
Verification with check
Run configuration, build, compatibility, and translation gates over one deterministic selection.
Compatibility
Compare compiled AL packages or validate current source against previous packages with AppSourceCop.
Symbol Packages
Create symbol-only AL apps, pack NuGet dependencies, and explicitly publish to a feed or folder.
App Packages
Pack a compiled, deployable .app into a NuGet package and push it to a feed for your deployment pipeline.
Source Analysis
alwasp analyze — dependency and object graphs, changed objects, public API, and impacted tests from source and git alone.
Translation Coverage
alwasp validate translations — XLIFF coverage checking, placeholder validation, and release gating.
Translation Preparation
Prepare translation packages for a translator or an agent, validate the returned XLIFF, and apply it to your apps.
Translation Skill
Install the alwasp-translate agent skill for Codex and Claude Code to translate only the XLIFF units that need work.
CI/CD
GitHub Actions and Azure Pipelines patterns for private feeds, manifests, diagnostics, and version application.
Authentication
Configure public and private NuGet feeds with PATs, feed-token environment mappings, nuget.config, and credential providers.
Reference
Exact options, version selection, output formats, exit codes, and problem solutions.
CLI Reference
All ALWasp commands with their arguments and primary options, with links to the complete option lists and the guides.
Business Central Versions
How --bc-version and --bc-country select Microsoft symbols, the AL compiler, and analyzers, and which compiler ALWasp uses.
Structured Output
The --format json and ndjson output, the result document, the record stream, and the --result-file option.
Exit Codes, Variables, and Files
The exit codes of all commands, the environment variables that ALWasp reads, and the files and folders that it writes.
Troubleshooting
Causes and solutions for restore, authentication, compiler, build, and compatibility problems.
How ALWasp Works
What each command does in sequence: restore, config-driven build, version commands, compatibility, source analysis, and translation checks.
Project
Release history and license.