AppHandling/Replace-DependenciesInAppFile.ps1
|
<#
.Synopsis Replaces specified dependencies in an application file .Description Investigates whether the application file contains dependencies to a specific application ID and replaces the dependency if that is the case .Parameter Path Path of the application file to investigate .Parameter Destination Path of the modified application file, where dependencies was replaced (default is to rewrite the original file) .Parameter replaceDependencies A hashtable, describring the dependencies, which needs to be replaced .Parameter internalsVisibleTo An Array of hashtable, containing id, name and publisher of an app, which should be added to internals Visible to .Parameter showMyCode With this parameter you can change or check ShowMyCode in the app file. Check will throw an error if ShowMyCode is False. .Parameter replacePackageId Add this switch to replace the package id of the app file with a new GUID .Parameter replaceVersionNumber Add this parameter to replace the version number of the app file with this version number .Example Replace-DependenciesInAppFile -containerName test -Path c:\temp\myapp.app -replaceDependencies @{ "437dbf0e-84ff-417a-965d-ed2bb9650972" = @{ "id" = "88b7902e-1655-4e7b-812e-ee9f0667b01b"; "name" = "MyBaseApp"; "publisher" = "Freddy Kristiansen"; "minversion" = "1.0.0.0" }} .Example Replace-DependenciesInAppFile -containerName test -Path c:\temp\myapp.app -internalsVisibleTo @( @{ "id" = "88b7902e-1655-4e7b-812e-ee9f0667b01b"; "name" = "MyBaseApp"; "publisher" = "Freddy Kristiansen" } ) #> Function Replace-DependenciesInAppFile { Param ( [obsolete('ContainerName is no longer needed for Replace-DependenciesInAppFile')] [string] $containerName = $bcContainerHelperConfig.defaultContainerName, [Parameter(Mandatory=$true)] [string] $Path, [string] $Destination = $Path, [hashtable] $replaceDependencies = $null, [ValidateSet('Ignore','True','False','Check')] [string] $ShowMyCode = "Ignore", [switch] $replacePackageId, [string] $replaceVersionNumber, [HashTable[]] $internalsVisibleTo = $null ) $telemetryScope = InitTelemetryScope -name $MyInvocation.InvocationName -parameterValues $PSBoundParameters -includeParameters @() try { if ($isPsCore) { [System.Reflection.Assembly]::LoadWithPartialName('System.IO.Packaging') | Out-Null } else { [System.Reflection.Assembly]::LoadWithPartialName('WindowsBase') | Out-Null } $memoryStream = $null $fs = $null try { $fs = [System.IO.File]::OpenRead($Path) $binaryReader = [System.IO.BinaryReader]::new($fs) $magicNumber1 = $binaryReader.ReadUInt32() $metadataSize = $binaryReader.ReadUInt32() $metadataVersion = $binaryReader.ReadUInt32() $packageId = [Guid]::new($binaryReader.ReadBytes(16)) $contentLength = $binaryReader.ReadInt64() $magicNumber2 = $binaryReader.ReadUInt32() if ($magicNumber1 -ne 0x5856414E -or $magicNumber2 -ne 0x5856414E -or $metadataVersion -gt 2 -or $fs.Position + $contentLength -gt $fs.Length) { throw "Unsupported package format" } $memoryStream = [System.IO.MemoryStream]::new() $fs.Seek($metadataSize, [System.IO.SeekOrigin]::Begin) | Out-Null $fs.CopyTo($memoryStream) $memoryStream.Seek(0, [System.IO.SeekOrigin]::Begin) | Out-Null $memoryStream.SetLength($contentLength) $fs.Close() $fs.Dispose() $fs = $null $package = [System.IO.Packaging.Package]::Open($memoryStream, [System.IO.FileMode]::Open, [System.IO.FileAccess]::ReadWrite) $manifestPart = $package.GetPart('/NavxManifest.xml') $manifestStream = $manifestPart.GetStream() $manifest = [xml]([System.IO.StreamReader]::new($manifestStream)).ReadToEnd() $manifestStream.Close() $manifestChanges = $false $symbolReferencePart = $package.GetPart('/SymbolReference.json') $symbolReferenceStream = $symbolReferencePart.GetStream() $symbolJson = ([System.IO.StreamReader]::new($symbolReferenceStream)).ReadToEnd() $symbolReferenceStream.Close() $symbolReference = $symbolJson | ConvertFrom-Json $symbolReferenceChanges = $false if ($ShowMyCode -ne "Ignore") { if ($ShowMyCode -eq "Check") { $resexp = $manifest.Package.ChildNodes | Where-Object { $_.name -eq "ResourceExposurePolicy" } if ($resexp) { if ($resexp.allowDebugging -ne "true" -or $resexp.allowDownloadingSource -ne "true" -or $resexp.includeSourceInSymbolFile -ne "true") { throw "Application has limited ResourceExposurePolicy" } } elseif ($manifest.Package.App.ShowMyCode -eq "False") { throw "Application has ShowMyCode set to False" } } else { $resexp = $manifest.Package.ChildNodes | Where-Object { $_.name -eq "ResourceExposurePolicy" } if ($resexp) { if ($resexp.allowDebugging -ne "$ShowMyCode" -or $resexp.allowDownloadingSource -ne "$ShowMyCode" -or $resexp.includeSourceInSymbolFile -ne "$ShowMyCode") { Write-Host "Changing ResourceExposurePolicy properties to $ShowMyCode" $resexp.allowDebugging = "$showMyCode" $resexp.allowDownloadingSource = "$showMyCode" $resexp.includeSourceInSymbolFile = "$showMyCode" $manifestChanges = $true } } elseif ($manifest.Package.App.ShowMyCode -ne $ShowMyCode) { Write-Host "Changing ShowMyCode to $ShowMyCOde" $manifest.Package.App.ShowMyCode = "$ShowMyCode" $manifestChanges = $true } } } if ($replaceDependencies) { $manifest.Package.Dependencies.GetEnumerator() | % { $dependency = $_ if ($replaceDependencies.ContainsKey($dependency.id)) { $newDependency = $replaceDependencies[$dependency.id] Write-Host "Replacing dependency from $($dependency.id) to $($newDependency.id)" $dependency.id = $newDependency.id $dependency.name = $newDependency.name $dependency.publisher = $newDependency.publisher $dependency.minVersion = $newDependency.minVersion $manifestChanges = $true } } } if ($internalsVisibleTo) { $internalsVisibleTo | % { $ivt = $_ $existing = $manifest.Package.InternalsVisibleTo.GetEnumerator() | Where-Object { $_.id -eq $ivt.id -and $_.name -eq $ivt.name -and $_.publisher -eq $ivt.publisher } if (-not ($existing)) { Write-Host "Adding Id=$($ivt.Id), Name=$($ivt.Name), Publisher=$($ivt.Publisher) to InternalsVisibleTo" $element = $manifest.CreateElement("Module","http://schemas.microsoft.com/navx/2015/manifest") $element.SetAttribute('Id',$ivt.Id) $element.SetAttribute('Name',$ivt.Name) $element.SetAttribute('Publisher',$ivt.Publisher) $manifest.Package.InternalsVisibleTo.AppendChild($element) | Out-Null $manifestChanges = $true $symbolReference.InternalsVisibleToModules += @(@{ "AppId" = $ivt.Id "Name" = $ivt.Name "Publisher" = $ivt.Publisher }) $symbolReferenceChanges = $true } } } if ($replaceVersionNumber) { Write-Host "Replacing Version Number with $replaceVersionNumber" $manifest.Package.App.Version = $replaceVersionNumber $manifestChanges = $true } if ($replacePackageId) { Write-Host "Replacing Package ID with new GUID" $packageId = [Guid]::NewGuid() $manifestChanges = $true } if ($manifestChanges) { $partStream = $manifestPart.GetStream([System.IO.FileMode]::Create) $manifest.Save($partStream) $partStream.Flush() if ($symbolReferenceChanges) { $partStream = $symbolReferencePart.GetStream([System.IO.FileMode]::Create) $memStream = [System.IO.MemoryStream]::new() $strWriter = [System.IO.StreamWriter]::new($memStream) $json = $symbolreference | ConvertTo-Json -depth 99 $strWriter.Write($json) $strWriter.Flush() $memStream.Position = 0 $memStream.CopyTo($partStream) $partStream.Flush() } $package.Close() $fs = [System.IO.FileStream]::new($Destination, [System.IO.FileMode]::Create) $binaryWriter = [System.IO.BinaryWriter]::new($fs) $binaryWriter.Write([UInt32](0x5856414E)) $binaryWriter.Write([UInt32](40)) $binaryWriter.Write([UInt32](2)) $binaryWriter.Write($packageId.ToByteArray()) $binaryWriter.Write([UInt64]($memoryStream.Length)) $binaryWriter.Write([UInt32](0x5856414E)) $memoryStream.Seek(0, [System.IO.SeekOrigin]::Begin) | Out-Null $memoryStream.CopyTo($fs) $fs.Close() $fs.Dispose() $fs = $null } else { if ($Path -ne $Destination) { Copy-Item -Path $Path -Destination $Destination -Force } } } finally { if ($fs) { $fs.Close() } } } catch { TrackException -telemetryScope $telemetryScope -errorRecord $_ throw } finally { TrackTrace -telemetryScope $telemetryScope } } Export-ModuleMember -Function Replace-DependenciesInAppFile |