feat: 优化客户端跨平台配置和运行态管理

scripts/package-client.ps1

@@ -10,7 +10,7 @@ $ErrorActionPreference = "Stop"
 
 $RepoRoot = Split-Path -Parent $PSScriptRoot
 if ([string]::IsNullOrWhiteSpace($SourceDir)) {
-    $SourceDir = Join-Path $RepoRoot "out/bin"
+    $SourceDir = Join-Path $RepoRoot "out/bin/Release"
 }
 if ([string]::IsNullOrWhiteSpace($OutputDir)) {
     $OutputDir = Join-Path $RepoRoot "dist/UpdateClient"
@@ -40,13 +40,32 @@ $configRelativeParent = Split-Path $configRelativePath -Parent
 $runtimeDirRelative = Normalize-RelativePath (Split-Path $configRelativeParent -Parent)
 if ($runtimeDirRelative -eq ".") { $runtimeDirRelative = "" }
 
-function Join-RelativePath([string]$Base, [string]$Child) {
-    $baseNorm = Normalize-RelativePath $Base
-    $childNorm = Normalize-RelativePath $Child
-    if ([string]::IsNullOrWhiteSpace($baseNorm)) { return $childNorm }
-    if ([string]::IsNullOrWhiteSpace($childNorm)) { return $baseNorm }
-    return "$baseNorm/$childNorm"
-}
+function Join-RelativePath([string]$Base, [string]$Child) {
+    $baseNorm = Normalize-RelativePath $Base
+    $childNorm = Normalize-RelativePath $Child
+    if ([string]::IsNullOrWhiteSpace($baseNorm)) { return $childNorm }
+    if ([string]::IsNullOrWhiteSpace($childNorm)) { return $baseNorm }
+    return "$baseNorm/$childNorm"
+}
+
+function Get-InstallDirectoryId([string]$RuntimeDir) {
+    $normalized = ([IO.Path]::GetFullPath($RuntimeDir) -replace '\\', '/').TrimEnd('/')
+    $sha = [System.Security.Cryptography.SHA256]::Create()
+    try {
+        $bytes = [System.Text.Encoding]::UTF8.GetBytes($normalized)
+        $hash = $sha.ComputeHash($bytes)
+        return -join ($hash | ForEach-Object { $_.ToString("x2") })
+    } finally {
+        $sha.Dispose()
+    }
+}
+
+function Get-UserDataManifestCandidate([string]$RuntimeDir, [string]$ManifestName) {
+    $localData = [Environment]::GetFolderPath("LocalApplicationData")
+    if ([string]::IsNullOrWhiteSpace($localData)) { return "" }
+    $installId = Get-InstallDirectoryId $RuntimeDir
+    return Join-Path $localData "Marsco\UpdateClientSDK\installations\$installId\update\manifest_cache\$ManifestName"
+}
 
 $requiredFields = @(
     "app_id", "channel", "current_version",
@@ -81,9 +100,9 @@ $debugArtifacts = Get-ChildItem $source -Recurse -File | Where-Object {
     $_.Name -match '^(Qt5.*d|qwindowsd|libEGLd|libGLESv2d|msvcp.*d|vcruntime.*d)\.dll$' -or
     $_.Extension -in @('.pdb', '.ilk')
 }
-if ($debugArtifacts) {
-    throw "Source directory contains Debug artifacts. Clean out/bin and rebuild Release first. Example: $($debugArtifacts[0].FullName)"
-}
+if ($debugArtifacts) {
+    throw "Source directory contains Debug artifacts. Clean the Release output directory and rebuild Release first. Example: $($debugArtifacts[0].FullName)"
+}
 
 $expectedMainPath = Join-RelativePath $runtimeDirRelative $mainExecutable
 $mainLeafName = Split-Path $mainExecutable -Leaf
@@ -95,18 +114,23 @@ if ($duplicateMain) {
     throw "Source directory contains a duplicate main executable outside $expectedMainPath. Use a clean Release root directory: $($duplicateMain.FullName)"
 }
 
-$manifestName = "manifest_$($settings.current_version).json"
-$sourceManifestRelative = Join-RelativePath $runtimeDirRelative "update/manifest_cache/$manifestName"
-$sourceManifest = Join-Path $source ($sourceManifestRelative -replace '/', [IO.Path]::DirectorySeparatorChar)
-if (-not (Test-Path $sourceManifest)) {
-    $legacySourceManifest = Join-Path $source "update/manifest_cache/$manifestName"
-    if (Test-Path $legacySourceManifest) {
-        $sourceManifest = $legacySourceManifest
-    }
-}
-if (-not (Test-Path $sourceManifest)) {
-    throw "Missing signed Manifest cache for current version: $sourceManifest. Complete online update/verification for this version before packaging."
-}
+$manifestName = "manifest_$($settings.current_version).json"
+$runtimeDirAbsolute = if ([string]::IsNullOrWhiteSpace($runtimeDirRelative)) {
+    $source
+} else {
+    Join-Path $source ($runtimeDirRelative -replace '/', [IO.Path]::DirectorySeparatorChar)
+}
+$sourceManifestRelative = Join-RelativePath $runtimeDirRelative "update/manifest_cache/$manifestName"
+$manifestCandidates = @(
+    (Get-UserDataManifestCandidate $runtimeDirAbsolute $manifestName),
+    (Join-Path $source ($sourceManifestRelative -replace '/', [IO.Path]::DirectorySeparatorChar)),
+    (Join-Path $source "update/manifest_cache/$manifestName")
+) | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
+$sourceManifest = $manifestCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1
+if (-not $sourceManifest -or -not (Test-Path $sourceManifest)) {
+    $searched = ($manifestCandidates | ForEach-Object { "  - $_" }) -join [Environment]::NewLine
+    throw "Missing signed Manifest cache for current version: $manifestName. Complete online update/verification for this version before packaging. Searched paths:$([Environment]::NewLine)$searched"
+}
 
 if (Test-Path $OutputDir) {
     Remove-Item $OutputDir -Recurse -Force