# Build-Plugin.ps1
# Builds and packages the AD Compare plugin for Disco ICT import
#
# Usage:
# .\Build-Plugin.ps1 -DiscoBinPath "C:\Program Files\Disco\WebApp\bin"
#
# Or if you have the Disco source solution built:
# .\Build-Plugin.ps1 -DiscoBinPath "C:\Source\Disco\Disco.Web\bin"
param(
[Parameter(Mandatory=$true)]
[string]$DiscoBinPath,
[string]$Configuration = "Release"
)
$ErrorActionPreference = "Stop"
$PluginDir = $PSScriptRoot
$PluginName = "Disco.Plugins.ADCompare"
Write-Host "=== AD Compare Plugin Builder ===" -ForegroundColor Cyan
Write-Host "Disco bin path: $DiscoBinPath" -ForegroundColor Gray
# --- Validate Disco bin path and required DLLs ---
if (-not (Test-Path $DiscoBinPath)) {
Write-Error "Disco bin path not found: $DiscoBinPath"
exit 1
}
$requiredDlls = @("Disco.Services.dll", "Disco.Models.dll", "Disco.Data.dll")
foreach ($dll in $requiredDlls) {
$dllPath = Join-Path $DiscoBinPath $dll
if (-not (Test-Path $dllPath)) {
Write-Error "Required assembly not found: $dllPath`nMake sure '$DiscoBinPath' contains the Disco assemblies."
exit 1
}
}
Write-Host "All required Disco assemblies found" -ForegroundColor Green
# --- Find MSBuild ---
$msbuild = $null
# Try VS2022/2019 via vswhere
$vsWhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
if (Test-Path $vsWhere) {
$msbuild = & $vsWhere -latest -requires Microsoft.Component.MSBuild -find "MSBuild\**\Bin\MSBuild.exe" 2>$null | Select-Object -First 1
}
# Try .NET Framework MSBuild
if (-not $msbuild -or -not (Test-Path $msbuild)) {
$frameworkMSBuild = "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exe"
if (Test-Path $frameworkMSBuild) {
$msbuild = $frameworkMSBuild
}
}
if (-not $msbuild -or -not (Test-Path $msbuild)) {
Write-Error "MSBuild not found. Install Visual Studio Build Tools or .NET Framework 4.7.2 Developer Pack."
exit 1
}
Write-Host "Using MSBuild: $msbuild" -ForegroundColor Gray
# --- Create temp csproj with resolved assembly paths ---
$csproj = Join-Path $PluginDir "$PluginName.csproj"
$csprojContent = Get-Content $csproj -Raw
# Replace all HintPaths to point at the single Disco bin directory
$csprojContent = $csprojContent -replace '[^<]*Disco\.Models\.dll', "$DiscoBinPath\Disco.Models.dll"
$csprojContent = $csprojContent -replace '[^<]*Disco\.Data\.dll', "$DiscoBinPath\Disco.Data.dll"
$csprojContent = $csprojContent -replace '[^<]*Disco\.Services\.dll', "$DiscoBinPath\Disco.Services.dll"
# Newtonsoft.Json - use from Disco bin
$newtonsoftPath = Join-Path $DiscoBinPath "Newtonsoft.Json.dll"
if (Test-Path $newtonsoftPath) {
$csprojContent = $csprojContent -replace '[^<]*Newtonsoft\.Json\.dll', "$newtonsoftPath"
}
# System.Web.Mvc - use from Disco bin if available
$mvcPath = Join-Path $DiscoBinPath "System.Web.Mvc.dll"
if (Test-Path $mvcPath) {
# Replace the strong-name reference with a HintPath reference
$csprojContent = $csprojContent -replace '', "$mvcPathFalse"
}
$tempCsproj = Join-Path $PluginDir "$PluginName.build.csproj"
$csprojContent | Set-Content $tempCsproj -Encoding UTF8
Write-Host "Assembly references resolved" -ForegroundColor Green
# --- Build ---
Write-Host "`nBuilding $PluginName ($Configuration)..." -ForegroundColor Yellow
$buildOutput = Join-Path $PluginDir "bin\$Configuration"
& $msbuild $tempCsproj /p:Configuration=$Configuration /p:OutputPath=$buildOutput /t:Build /v:minimal
if ($LASTEXITCODE -ne 0) {
Remove-Item $tempCsproj -ErrorAction SilentlyContinue
Write-Error "Build failed!"
exit 1
}
Remove-Item $tempCsproj -ErrorAction SilentlyContinue
$pluginDll = Join-Path $buildOutput "$PluginName.dll"
if (-not (Test-Path $pluginDll)) {
Write-Error "Build output not found: $pluginDll"
exit 1
}
Write-Host "Build successful: $pluginDll" -ForegroundColor Green
# --- Generate Manifest ---
Write-Host "`nGenerating manifest..." -ForegroundColor Yellow
# Copy Disco assemblies to build output for ManifestGenerator resolution
foreach ($dll in $requiredDlls) {
$src = Join-Path $DiscoBinPath $dll
Copy-Item $src $buildOutput -Force -ErrorAction SilentlyContinue
}
# Copy other dependencies from Disco bin
$depDlls = @("EntityFramework.dll", "System.Web.Mvc.dll", "RazorGenerator.Mvc.dll", "Newtonsoft.Json.dll")
foreach ($dep in $depDlls) {
$depPath = Join-Path $DiscoBinPath $dep
if (Test-Path $depPath) {
Copy-Item $depPath $buildOutput -Force -ErrorAction SilentlyContinue
}
}
# Try Disco's ManifestGenerator if it exists in the bin path or nearby
$useManifestGen = $false
$manifestGenExe = Join-Path $DiscoBinPath "Disco.Services.Plugins.ManifestGenerator.exe"
if (-not (Test-Path $manifestGenExe)) {
# Check parent directory
$manifestGenExe = Join-Path (Split-Path $DiscoBinPath -Parent) "Disco.Services.Plugins.ManifestGenerator.exe"
}
if (Test-Path $manifestGenExe) {
$useManifestGen = $true
Write-Host "Found ManifestGenerator: $manifestGenExe" -ForegroundColor Gray
& $manifestGenExe $pluginDll
if ($LASTEXITCODE -ne 0) {
Write-Warning "ManifestGenerator failed, creating manifest manually..."
$useManifestGen = $false
}
}
if (-not $useManifestGen) {
# Create manifest.json manually
$version = [System.Reflection.AssemblyName]::GetAssemblyName($pluginDll).Version
$manifest = [ordered]@{
Id = $PluginName
Name = "AD Compare"
Author = "Jess"
Url = "https://gitea.hideawaygaming.com.au/jessikitty/disco-ad-compare-plugin"
Version = $version.ToString()
AssemblyPath = "$PluginName.dll"
TypeName = "Disco.Plugins.ADCompare.ADComparePlugin"
ConfigurationHandlerTypeName = "Disco.Plugins.ADCompare.ConfigurationHandler.ADCompareConfigurationHandler"
WebHandlerTypeName = "Disco.Plugins.ADCompare.WebHandler.ADCompareWebHandler"
Features = @()
}
$manifest | ConvertTo-Json -Depth 5 | Set-Content (Join-Path $buildOutput "manifest.json") -Encoding UTF8
Write-Host "Manual manifest.json created" -ForegroundColor Green
}
# --- Package as .discoPlugin ---
Write-Host "`nPackaging .discoPlugin file..." -ForegroundColor Yellow
# Disco-provided assemblies to exclude from the package
$excludePatterns = @(
"Disco.Models.*", "Disco.Data.*", "Disco.Services.*", "Disco.Web.*", "Disco.BI.*",
"EntityFramework.*", "System.Web.Mvc.*", "RazorGenerator.Mvc.*", "Newtonsoft.Json.*",
"*.build.csproj", "*.discoPlugin"
)
if (-not $version) {
$version = [System.Reflection.AssemblyName]::GetAssemblyName($pluginDll).Version
}
$packageName = "$PluginName-$($version.ToString()).discoPlugin"
$packagePath = Join-Path $PluginDir $packageName
# Remove old packages
Get-ChildItem $PluginDir -Filter "*.discoPlugin" | Remove-Item -Force
# Collect files for packaging (exclude Disco-provided assemblies)
$filesToPackage = Get-ChildItem $buildOutput -Recurse -File | Where-Object {
$file = $_.Name
-not ($excludePatterns | Where-Object { $file -like $_ })
}
# Build package in temp directory
$tempPkg = Join-Path $env:TEMP "discoplugin_$([guid]::NewGuid().ToString('N'))"
New-Item -ItemType Directory -Path $tempPkg -Force | Out-Null
foreach ($f in $filesToPackage) {
$relativePath = $f.FullName.Substring($buildOutput.Length + 1)
$destPath = Join-Path $tempPkg $relativePath
$destDir = Split-Path $destPath -Parent
if (-not (Test-Path $destDir)) { New-Item -ItemType Directory -Path $destDir -Force | Out-Null }
Copy-Item $f.FullName $destPath -Force
}
Write-Host "Files in package:" -ForegroundColor Gray
Get-ChildItem $tempPkg -Recurse -File | ForEach-Object {
Write-Host " $($_.FullName.Substring($tempPkg.Length + 1))" -ForegroundColor Gray
}
Compress-Archive -Path "$tempPkg\*" -DestinationPath $packagePath -Force
Remove-Item $tempPkg -Recurse -Force
$packageSize = [math]::Round((Get-Item $packagePath).Length / 1KB, 1)
Write-Host "`n=== Package created: $packagePath ($($packageSize) KB) ===" -ForegroundColor Green
Write-Host "Import into Disco ICT via: Configuration > Plugins > Install Plugin" -ForegroundColor Cyan