ARM Build Script Documentation

Overview

The arm_build.ps1 script automates the build process for the GestoreTrimestrale solution, including environment setup, TFS workspace management, and test execution.

Prerequisites

Visual Studio 2022 (Enterprise, Professional, or Community edition)
Team Foundation Server PowerShell Snapin
MSBuild
VSTest Console

Usage

Basic Usage

.\arm_build.ps1

Parameters

LocalWorkspace (string)
- Default: "C:\TFS Fideuram\TP_SEI_Project\root"
- Purpose: Specifies the root workspace directory
```
.\arm_build.ps1 -LocalWorkspace "C:\CustomPath"
```
SkipTests (switch)
- Purpose: Skips test execution when specified
```
.\arm_build.ps1 -SkipTests
```
RunApp (switch)
- Purpose: Launches the application after successful build
```
.\arm_build.ps1 -RunApp
```

Combined Usage

.\arm_build.ps1 -LocalWorkspace "C:\CustomPath" -SkipTests -RunApp

Build Process Steps

Environment validation
Visual Studio x64 environment setup
TFS workspace update
Configuration file updates
Solution build
Test execution (if not skipped):
- FlushFilesWaitingForZIP
- SetUpZipCases_DoNotUse
- ProcessCanComplete
- ZipIntegrity
- NumberOfPackedPDFIsOK
Application launch (if specified)

Error Handling

The script includes comprehensive error handling with:

Path validation
Environment setup verification
Build status checking
Test execution monitoring
Detailed error messages

Output

The script provides colored console output for better visibility:

Yellow: Process steps
Cyan: Test execution
Red: Errors
Green: Success messages

1.7 KiB Raw Blame History