ALOps App Symbol¶

Creates symbol-only packages from compiled .app files using altool CreateSymbolPackage.

Property	Value
Task name (Azure DevOps)	`ALOpsAppSymbol@3`
Action name (GitHub)	`alops-appsymbol`
Version	`3.0.0`
Category	Utility
OS requirement	Both
Preview	yes

Creates symbol-only packages from compiled AL .app files. Uses altool.exe CreateSymbolPackage to strip implementation code, leaving only the public API surface. Optionally verifies each output with altool IsSymbolOnly and publishes artifacts.

Inputs¶

altool¶

Name	Type	Required	Default	Platform	Description
`altool_package_version`	Text	yes	`18.0.33.65164-beta`	Both	Version of the microsoft.dynamics.businesscentral.development.tools NuGet package. Pin to a specific version for reproducible builds.

source¶

Name	Type	Required	Default	Platform	Description
`app_source_path`	Text	no	(empty)	Both	Root folder to scan recursively for .app files. Leave empty to use the workspace directory.
`app_file_filter`	Text	no	`*.app`	Both	File filter pattern for selecting .app files.
`use_alops_compiler_apps`	Boolean	no	`false`	Both	When enabled, reads app paths from the ALOPS_COMPILE_ARTIFACT_ARRAY variable set by a preceding ALOpsAppCompiler task instead of scanning the file system.

output¶

Name	Type	Required	Default	Platform	Description
`output_path`	Text	no	(empty)	Both	Folder where symbol .app files will be written. Leave empty to use a 'symbol_output' subfolder in the workspace.
`verify_symbol`	Boolean	no	`true`	Both	Run altool IsSymbolOnly verification on each generated symbol package.
`publishartifact`	Boolean	no	`true` (alt: `true`)	Azure DevOps only	Upload symbol .app files as build artifacts.
`artifact_name`	Text	no	`ALOpsSymbolArtifact`	Both	Name of the build artifact when publishing symbol packages.

Outputs¶

Name	Description
`symbol_artifact`	Path to the last created symbol .app file.
`symbol_artifact_array`	Comma-separated list of all created symbol .app file paths.

Usage¶

Azure DevOpsGitHub Actions

- task: ALOpsAppSymbol@3
  displayName: 'ALOps App Symbol'
  inputs:
    altool_package_version: 18.0.33.65164-beta  # Version of the microsoft.dynamics.businesscentral.development.tools NuGet package. Pin to a specific version for reproducible builds. $(altool_package_version)
    app_source_path:                            # Root folder to scan recursively for .app files. Leave empty to use the workspace directory. $(app_source_path)
    app_file_filter: *.app                      # File filter pattern for selecting .app files. $(app_file_filter)
    use_alops_compiler_apps: False              # When enabled, reads app paths from the ALOPS_COMPILE_ARTIFACT_ARRAY variable set by a preceding ALOpsAppCompiler task instead of scanning the file system. $(use_alops_compiler_apps)
    output_path:                                # Folder where symbol .app files will be written. Leave empty to use a 'symbol_output' subfolder in the workspace. $(output_path)
    verify_symbol: True                         # Run altool IsSymbolOnly verification on each generated symbol package. $(verify_symbol)
    publishartifact: True                       # Upload symbol .app files as build artifacts. $(publishartifact)
    artifact_name: ALOpsSymbolArtifact          # Name of the build artifact when publishing symbol packages. $(artifact_name)

- name: ALOps App Symbol
  uses: HodorNV/ALOps-V3/alops-appsymbol@v3   <!-- TODO: confirm action repo path -->
  with:
    altool_package_version: '18.0.33.65164-beta'
    app_source_path: ''
    app_file_filter: '*.app'
    use_alops_compiler_apps: 'false'
    output_path: ''
    verify_symbol: 'true'
    artifact_name: 'ALOpsSymbolArtifact'