Download-ALApp.ps1
|
<#
.SYNOPSIS Download APP File from repository .DESCRIPTION Will trigger script for downloading the needed app file, e.g. from Azure DevOps Artifact server or from some file server Value from AppDownloadScript parameter will be called with parameters name, publisher, version and path in input object. It is used to download missing dependency when compiling the AppTree or Installing the AppTree .EXAMPLE PS C:\> Download-ALApp -name "MyApp" -publisher "me" -version 1.0.0 -targetPath "c:\mypath" -AppDownloadScript "Download-ALAppFromNuget" Will download nuget package me.MyApp of version 1.0.0 or newer from registered nuget sources. .Parameter name Name of the app to download .Parameter publisher Name of the publisher of the app to download .Parameter version Needed version of the app to download .Parameter targetPath Path to place the downloaded App file .Parameter baseApplicationVersion Version of base application to use for downloading the app. This is used for downloading only dependencies compatible with this version. .Parameter AppDownloadScript Script to use to download the app. This should take parameters from pipeline with name "name", "publisher", "version" and "targetPath" or extract them from input object. Script could copy the app from somewhere, download it from some server etc. #> function Download-ALApp { param( [Parameter(ValueFromPipelineByPropertyName = $True)] $name, [Parameter(ValueFromPipelineByPropertyName = $True)] $publisher, [Parameter(ValueFromPipelineByPropertyName = $True)] $version, [Parameter(ValueFromPipelineByPropertyName = $True)] $id, [Parameter(ValueFromPipelineByPropertyName = $True)] $dependencies, [Parameter(ValueFromPipelineByPropertyName = $True)] $targetPath = '.\', [Parameter(ValueFromPipelineByPropertyName = $True)] $baseApplicationVersion = '', [Parameter(ValueFromPipelineByPropertyName = $True)] $AppDownloadScript, [Parameter(ValueFromPipelineByPropertyName = $True)] [switch]$UnifiedNaming, [Parameter(ValueFromPipelineByPropertyName = $True)] [String]$DependencyTag ) if ($dependencies) { foreach ($dep in $dependencies) { if ($dep.name) { Write-Host "Downloading App $($dep.name) from $($dep.publisher) version $($dep.version) id $($dep.id) into $targetPath" if ($UnifiedNaming) { $packageName = Format-AppNameForNuget -publisher $dep.publisher -appname $dep.name -id $dep.id -tag '' -version '' } else { $DependencyFormat = '$($dep.publisher)_$($dep.name)' $packageName = Format-AppNameForNuget -Name ($ExecutionContext.InvokeCommand.ExpandString($DependencyFormat)) } $dep | Add-Member -MemberType NoteProperty -Name 'packageName' -Value $packageName } } if ($AppDownloadScript) { Write-Host "executing $AppDownloadScript" $Configuration = New-Object -TypeName PSObject $Configuration | Add-Member -MemberType NoteProperty -Name 'dependencies' -Value $dependencies $Configuration | Add-Member -MemberType NoteProperty -Name 'path' -Value $targetPath $Configuration | Add-Member -MemberType NoteProperty -Name 'baseApplicationVersion' -Value $baseApplicationVersion #$Configuration | $AppDownloadScript #Invoke-Expression -Command $AppDownloadScript [ScriptBlock]$sb = [ScriptBlock]::Create("`$Args | $AppDownloadScript") Write-Host "Config: $Configuration" Invoke-Command -ScriptBlock $sb -Args $Configuration } } else { if ($name) { Write-Host "Downloading App $name from $publisher version $version into $targetPath" if ($AppDownloadScript) { Write-Host "executing $AppDownloadScript" $Configuration = New-Object -TypeName PSObject $Configuration | Add-Member -MemberType NoteProperty -Name 'name' -Value $name $Configuration | Add-Member -MemberType NoteProperty -Name 'publisher' -Value $publisher $Configuration | Add-Member -MemberType NoteProperty -Name 'version' -Value $version $Configuration | Add-Member -MemberType NoteProperty -Name 'id' -Value $id $Configuration | Add-Member -MemberType NoteProperty -Name 'path' -Value $targetPath $Configuration | Add-Member -MemberType NoteProperty -Name 'UnifiedNaming' -Value $UnifiedNaming $Configuration | Add-Member -MemberType NoteProperty -Name 'DependencyTag' -Value $DependencyTag $Configuration | Add-Member -MemberType NoteProperty -Name 'baseApplicationVersion' -Value $baseApplicationVersion #$Configuration | $AppDownloadScript #Invoke-Expression -Command $AppDownloadScript [ScriptBlock]$sb = [ScriptBlock]::Create("`$Args | $AppDownloadScript") Write-Host "Config: $Configuration" Invoke-Command -ScriptBlock $sb -Args $Configuration } } else { Write-Host "No app to download" } } } |