mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-22 00:54:26 +08:00
806 lines
23 KiB
Markdown
806 lines
23 KiB
Markdown
# LanMountainDesktop Launcher 全面改进计划
|
||
|
||
## 概述
|
||
|
||
本计划旨在将 LanMountainDesktop 的 Launcher 改进为符合原子化架构的独立启动器，参考 ClassIsland 的极简设计，同时保留阑山桌面的特色功能。
|
||
|
||
## 目标
|
||
|
||
1. **P0 (必须完成)**: 重写 Launcher 为极简模式，移除与主程序的耦合
|
||
2. **P1 (应该完成)**: 将 OOBE、Splash、更新、插件管理迁移到主程序
|
||
3. **P2 (推荐完成)**: 实现 Launcher 自更新机制
|
||
4. **P3 (可选优化)**: 性能优化和代码清理
|
||
5. **P4 (长期规划)**: 增强功能和可扩展性
|
||
|
||
## 当前问题
|
||
|
||
1. Launcher 是 Avalonia 应用，启动慢、内存占用高
|
||
2. Launcher 引用了 PluginSdk，与主程序有耦合
|
||
3. 主程序引用了 Launcher，构建关系复杂
|
||
4. Launcher 职责过多（OOBE + Splash + 更新 + 插件 + 启动）
|
||
5. 缺少 Launcher 自更新机制
|
||
6. GitHub Actions 工作流需要适配新的目录结构
|
||
|
||
## 改进后架构
|
||
|
||
```
|
||
安装根目录/
|
||
├── LanMountainDesktop.exe ← 启动器（唯一入口，极简，~100行代码）
|
||
├── app-1.0.0/ ← 版本目录
|
||
│ ├── .current ← 当前版本标记
|
||
│ ├── LanMountainDesktop.exe ← 主程序
|
||
│ └── ... (所有依赖)
|
||
└── .launcher/ ← 启动器数据（可选）
|
||
└── snapshots/ ← 版本快照
|
||
```
|
||
|
||
## 详细实施步骤
|
||
|
||
### P0: 基础架构重构
|
||
|
||
#### 1. 重写 Launcher 为极简模式
|
||
|
||
**文件**: `LanMountainDesktop.Launcher/Program.cs`
|
||
|
||
**目标**:
|
||
- 代码量控制在 100 行以内
|
||
- 零外部依赖（不使用 Avalonia）
|
||
- 只负责：版本选择、启动主程序、清理旧版本
|
||
|
||
**完整实现代码**:
|
||
|
||
```csharp
|
||
// LanMountainDesktop.Launcher/Program.cs
|
||
using System.Diagnostics;
|
||
using System.Runtime.InteropServices;
|
||
|
||
namespace LanMountainDesktop.Launcher;
|
||
|
||
internal static class Program
|
||
{
|
||
private const string HostExecutableName = "LanMountainDesktop.exe";
|
||
private const string HostExecutableNameLinux = "LanMountainDesktop";
|
||
|
||
[STAThread]
|
||
private static int Main(string[] args)
|
||
{
|
||
var rootDir = GetRootDirectory();
|
||
|
||
// 1. 查找最佳版本
|
||
var installation = FindBestVersion(rootDir);
|
||
if (installation == null)
|
||
{
|
||
ShowError("找不到有效的 LanMountainDesktop 版本，请重新安装。");
|
||
return 1;
|
||
}
|
||
|
||
// 2. 清理旧版本（异步，不阻塞）
|
||
_ = Task.Run(() => CleanupOldVersions(rootDir));
|
||
|
||
// 3. 启动主程序
|
||
return LaunchHost(installation, args);
|
||
}
|
||
|
||
private static string GetRootDirectory()
|
||
{
|
||
return Path.GetFullPath(
|
||
Path.GetDirectoryName(Environment.ProcessPath) ?? "");
|
||
}
|
||
|
||
private static string? FindBestVersion(string rootDir)
|
||
{
|
||
var exeName = OperatingSystem.IsWindows()
|
||
? HostExecutableName
|
||
: HostExecutableNameLinux;
|
||
|
||
return Directory.GetDirectories(rootDir)
|
||
.Where(x => IsValidVersionDirectory(x, exeName))
|
||
.OrderBy(x => File.Exists(Path.Combine(x, ".current")) ? 0 : 1)
|
||
.ThenByDescending(x => ParseVersion(Path.GetFileName(x)))
|
||
.FirstOrDefault();
|
||
}
|
||
|
||
private static bool IsValidVersionDirectory(string path, string exeName)
|
||
{
|
||
var dirName = Path.GetFileName(path);
|
||
return dirName.StartsWith("app-") &&
|
||
!File.Exists(Path.Combine(path, ".destroy")) &&
|
||
!File.Exists(Path.Combine(path, ".partial")) &&
|
||
File.Exists(Path.Combine(path, exeName));
|
||
}
|
||
|
||
private static Version ParseVersion(string dirName)
|
||
{
|
||
// app-1.0.0 or app-1.0.0-123
|
||
var parts = dirName.Split('-');
|
||
if (parts.Length >= 2 && Version.TryParse(parts[1], out var v))
|
||
return v;
|
||
return new Version(0, 0);
|
||
}
|
||
|
||
private static void CleanupOldVersions(string rootDir)
|
||
{
|
||
try
|
||
{
|
||
var oldVersions = Directory.GetDirectories(rootDir)
|
||
.Where(x => File.Exists(Path.Combine(x, ".destroy")));
|
||
|
||
foreach (var dir in oldVersions)
|
||
{
|
||
try { Directory.Delete(dir, recursive: true); } catch { }
|
||
}
|
||
}
|
||
catch { /* 忽略清理失败 */ }
|
||
}
|
||
|
||
private static int LaunchHost(string installation, string[] args)
|
||
{
|
||
var exeName = OperatingSystem.IsWindows()
|
||
? HostExecutableName
|
||
: HostExecutableNameLinux;
|
||
var exePath = Path.Combine(installation, exeName);
|
||
|
||
// Linux/macOS: 确保可执行权限
|
||
if (!OperatingSystem.IsWindows())
|
||
{
|
||
EnsureExecutable(exePath);
|
||
}
|
||
|
||
var startInfo = new ProcessStartInfo
|
||
{
|
||
FileName = exePath,
|
||
WorkingDirectory = Path.GetDirectoryName(installation),
|
||
UseShellExecute = true
|
||
};
|
||
|
||
foreach (var arg in args)
|
||
startInfo.ArgumentList.Add(arg);
|
||
|
||
// 传递环境变量
|
||
startInfo.EnvironmentVariables["LMD_PACKAGE_ROOT"] =
|
||
Path.GetDirectoryName(installation);
|
||
startInfo.EnvironmentVariables["LMD_VERSION"] =
|
||
Path.GetFileName(installation).Replace("app-", "");
|
||
|
||
try
|
||
{
|
||
Process.Start(startInfo);
|
||
return 0;
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
ShowError($"启动失败: {ex.Message}");
|
||
return 1;
|
||
}
|
||
}
|
||
|
||
private static void EnsureExecutable(string path)
|
||
{
|
||
try
|
||
{
|
||
Process.Start(new ProcessStartInfo
|
||
{
|
||
FileName = "chmod",
|
||
Arguments = $"+x \"{path}\"",
|
||
CreateNoWindow = true
|
||
})?.WaitForExit();
|
||
}
|
||
catch { }
|
||
}
|
||
|
||
private static void ShowError(string message)
|
||
{
|
||
if (OperatingSystem.IsWindows())
|
||
{
|
||
// Win32 MessageBox
|
||
try
|
||
{
|
||
MessageBox(IntPtr.Zero, message, "LanMountainDesktop", 0x10);
|
||
}
|
||
catch
|
||
{
|
||
Console.Error.WriteLine(message);
|
||
}
|
||
}
|
||
else
|
||
{
|
||
Console.Error.WriteLine(message);
|
||
}
|
||
}
|
||
|
||
[DllImport("user32.dll", CharSet = CharSet.Unicode)]
|
||
private static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);
|
||
}
|
||
```
|
||
|
||
#### 2. 修改 Launcher 项目文件
|
||
|
||
**文件**: `LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj`
|
||
|
||
**完整内容**:
|
||
|
||
```xml
|
||
<Project Sdk="Microsoft.NET.Sdk">
|
||
<PropertyGroup>
|
||
<OutputType>WinExe</OutputType>
|
||
<TargetFramework>net10.0</TargetFramework>
|
||
<Nullable>enable</Nullable>
|
||
<ImplicitUsings>enable</ImplicitUsings>
|
||
<Version>1.0.0</Version>
|
||
<ApplicationIcon>Assets\logo_nightly.ico</ApplicationIcon>
|
||
</PropertyGroup>
|
||
|
||
<!-- 图标资源 -->
|
||
<ItemGroup>
|
||
<Content Include="..\LanMountainDesktop\Assets\logo_nightly.ico" Link="Assets\logo_nightly.ico">
|
||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
|
||
</Content>
|
||
</ItemGroup>
|
||
</Project>
|
||
```
|
||
|
||
#### 3. 移除主程序对 Launcher 的引用
|
||
|
||
**文件**: `LanMountainDesktop/LanMountainDesktop.csproj`
|
||
|
||
**修改**: 删除以下行
|
||
```xml
|
||
<!-- 删除这一行 -->
|
||
<ProjectReference Include="..\LanMountainDesktop.Launcher\LanMountainDesktop.Launcher.csproj" ReferenceOutputAssembly="false" />
|
||
```
|
||
|
||
#### 4. 修改主程序支持新架构
|
||
|
||
**文件**: `LanMountainDesktop/Program.cs`
|
||
|
||
**修改**: 添加环境变量读取
|
||
|
||
```csharp
|
||
// 在 Program.cs 中添加
|
||
internal static class LaunchContext
|
||
{
|
||
public static string? PackageRoot =>
|
||
Environment.GetEnvironmentVariable("LMD_PACKAGE_ROOT");
|
||
public static string? Version =>
|
||
Environment.GetEnvironmentVariable("LMD_VERSION");
|
||
public static bool IsLaunchedByLauncher =>
|
||
!string.IsNullOrEmpty(PackageRoot);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### P1: 功能迁移
|
||
|
||
#### 5. 将 OOBE 迁移到主程序
|
||
|
||
**新建文件**: `LanMountainDesktop/Services/Oobe/OobeService.cs`
|
||
|
||
```csharp
|
||
using LanMountainDesktop.Models;
|
||
using LanMountainDesktop.Services.Settings;
|
||
|
||
namespace LanMountainDesktop.Services.Oobe;
|
||
|
||
public class OobeService
|
||
{
|
||
private readonly string _oobeStatePath;
|
||
|
||
public OobeService()
|
||
{
|
||
var appData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
|
||
_oobeStatePath = Path.Combine(appData, "LanMountainDesktop", ".oobe_completed");
|
||
}
|
||
|
||
public bool IsFirstRun()
|
||
{
|
||
return !File.Exists(_oobeStatePath);
|
||
}
|
||
|
||
public void MarkCompleted()
|
||
{
|
||
var dir = Path.GetDirectoryName(_oobeStatePath);
|
||
if (!Directory.Exists(dir))
|
||
Directory.CreateDirectory(dir);
|
||
File.WriteAllText(_oobeStatePath, DateTime.UtcNow.ToString("O"));
|
||
}
|
||
}
|
||
```
|
||
|
||
**新建文件**: `LanMountainDesktop/Views/Oobe/OobeWindow.axaml`
|
||
|
||
```xml
|
||
<Window xmlns="https://github.com/avaloniaui"
|
||
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
||
x:Class="LanMountainDesktop.Views.Oobe.OobeWindow"
|
||
Title="欢迎使用阑山桌面"
|
||
Width="800"
|
||
Height="600"
|
||
WindowStartupLocation="CenterScreen">
|
||
<Grid>
|
||
<!-- OOBE 界面内容 -->
|
||
<TextBlock Text="欢迎使用阑山桌面" FontSize="24" HorizontalAlignment="Center" Margin="0,50,0,0"/>
|
||
<Button Content="开始使用" HorizontalAlignment="Center" VerticalAlignment="Bottom" Margin="0,0,0,50" Click="OnStartClick"/>
|
||
</Grid>
|
||
</Window>
|
||
```
|
||
|
||
**修改文件**: `LanMountainDesktop/App.axaml.cs`
|
||
|
||
```csharp
|
||
// 在 OnFrameworkInitializationCompleted 中添加
|
||
private async Task InitializeOobeAsync()
|
||
{
|
||
var oobeService = new OobeService();
|
||
if (oobeService.IsFirstRun())
|
||
{
|
||
var oobeWindow = new Views.Oobe.OobeWindow();
|
||
await oobeWindow.ShowDialog();
|
||
oobeService.MarkCompleted();
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 6. 将 Splash 迁移到主程序
|
||
|
||
**新建文件**: `LanMountainDesktop/Views/Splash/SplashWindow.axaml`
|
||
|
||
```xml
|
||
<Window xmlns="https://github.com/avaloniaui"
|
||
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
||
x:Class="LanMountainDesktop.Views.Splash.SplashWindow"
|
||
Title="阑山桌面"
|
||
Width="400"
|
||
Height="300"
|
||
WindowStartupLocation="CenterScreen"
|
||
ShowInTaskbar="False"
|
||
SystemDecorations="None">
|
||
<Grid Background="{DynamicResource SystemAccentColor}">
|
||
<StackPanel VerticalAlignment="Center" HorizontalAlignment="Center">
|
||
<Image Source="/Assets/logo_nightly.png" Width="100" Height="100"/>
|
||
<TextBlock Text="阑山桌面" FontSize="20" Margin="0,20,0,0" HorizontalAlignment="Center"/>
|
||
<TextBlock x:Name="StatusText" Text="正在启动..." Margin="0,10,0,0" HorizontalAlignment="Center"/>
|
||
</StackPanel>
|
||
</Grid>
|
||
</Window>
|
||
```
|
||
|
||
**修改文件**: `LanMountainDesktop/App.axaml.cs`
|
||
|
||
```csharp
|
||
// 在初始化时显示 Splash
|
||
private SplashWindow? _splashWindow;
|
||
|
||
private void ShowSplash()
|
||
{
|
||
_splashWindow = new SplashWindow();
|
||
_splashWindow.Show();
|
||
}
|
||
|
||
private void CloseSplash()
|
||
{
|
||
_splashWindow?.Close();
|
||
_splashWindow = null;
|
||
}
|
||
```
|
||
|
||
#### 7. 将更新逻辑迁移到主程序
|
||
|
||
**新建目录**: `LanMountainDesktop/Services/Update/`
|
||
|
||
**新建文件**: `LanMountainDesktop/Services/Update/UpdateService.cs`
|
||
|
||
```csharp
|
||
using System.Net.Http.Json;
|
||
using LanMountainDesktop.Models;
|
||
|
||
namespace LanMountainDesktop.Services.Update;
|
||
|
||
public class UpdateService
|
||
{
|
||
private readonly HttpClient _httpClient;
|
||
private readonly string _currentVersion;
|
||
|
||
public UpdateService()
|
||
{
|
||
_httpClient = new HttpClient();
|
||
_httpClient.DefaultRequestHeaders.Add("User-Agent", "LanMountainDesktop");
|
||
_currentVersion = GetType().Assembly.GetName().Version?.ToString() ?? "1.0.0";
|
||
}
|
||
|
||
public async Task<UpdateCheckResult> CheckForUpdateAsync(UpdateChannel channel)
|
||
{
|
||
// 调用 GitHub Release API
|
||
var releases = await _httpClient.GetFromJsonAsync<List<GitHubRelease>>(
|
||
"https://api.github.com/repos/ClassIsland/LanMountainDesktop/releases");
|
||
|
||
var latest = channel == UpdateChannel.Stable
|
||
? releases?.FirstOrDefault(r => !r.Prerelease)
|
||
: releases?.FirstOrDefault();
|
||
|
||
if (latest == null)
|
||
return new UpdateCheckResult { HasUpdate = false };
|
||
|
||
var latestVersion = latest.TagName.TrimStart('v');
|
||
var hasUpdate = new Version(latestVersion) > new Version(_currentVersion);
|
||
|
||
return new UpdateCheckResult
|
||
{
|
||
HasUpdate = hasUpdate,
|
||
Version = latestVersion,
|
||
DownloadUrl = latest.Assets.FirstOrDefault()?.BrowserDownloadUrl
|
||
};
|
||
}
|
||
}
|
||
|
||
public class UpdateCheckResult
|
||
{
|
||
public bool HasUpdate { get; set; }
|
||
public string? Version { get; set; }
|
||
public string? DownloadUrl { get; set; }
|
||
}
|
||
|
||
public enum UpdateChannel { Stable, Preview }
|
||
|
||
public class GitHubRelease
|
||
{
|
||
public string TagName { get; set; } = "";
|
||
public bool Prerelease { get; set; }
|
||
public List<GitHubAsset> Assets { get; set; } = new();
|
||
}
|
||
|
||
public class GitHubAsset
|
||
{
|
||
public string BrowserDownloadUrl { get; set; } = "";
|
||
}
|
||
```
|
||
|
||
#### 8. 将插件管理迁移到主程序
|
||
|
||
**新建目录**: `LanMountainDesktop/Services/Plugins/`
|
||
|
||
**新建文件**: `LanMountainDesktop/Services/Plugins/PluginUpdateService.cs`
|
||
|
||
```csharp
|
||
namespace LanMountainDesktop.Services.Plugins;
|
||
|
||
public class PluginUpdateService
|
||
{
|
||
private readonly string _pluginsDirectory;
|
||
|
||
public PluginUpdateService()
|
||
{
|
||
var appData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
|
||
_pluginsDirectory = Path.Combine(appData, "LanMountainDesktop", "plugins");
|
||
}
|
||
|
||
public async Task CheckAndUpdatePluginsAsync()
|
||
{
|
||
// 检查插件更新
|
||
// 下载并安装更新
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### P2: 自更新机制
|
||
|
||
#### 9. 实现 Launcher 自更新
|
||
|
||
**修改文件**: `LanMountainDesktop.Launcher/Program.cs`
|
||
|
||
```csharp
|
||
// 在 Main 方法开头添加自更新检查
|
||
private static void CheckForLauncherUpdate()
|
||
{
|
||
var rootDir = GetRootDirectory();
|
||
var updatePath = Path.Combine(rootDir, "LanMountainDesktop.Launcher.Update.exe");
|
||
|
||
if (File.Exists(updatePath))
|
||
{
|
||
// 有新版本 Launcher，替换自身
|
||
try
|
||
{
|
||
var currentPath = Environment.ProcessPath;
|
||
var backupPath = currentPath + ".old";
|
||
|
||
// 重命名当前版本
|
||
if (File.Exists(backupPath))
|
||
File.Delete(backupPath);
|
||
File.Move(currentPath!, backupPath);
|
||
|
||
// 移动新版本
|
||
File.Move(updatePath, currentPath!);
|
||
|
||
// 删除备份
|
||
File.Delete(backupPath);
|
||
|
||
// 重启自己
|
||
Process.Start(new ProcessStartInfo
|
||
{
|
||
FileName = currentPath,
|
||
UseShellExecute = true
|
||
});
|
||
Environment.Exit(0);
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
// 回滚
|
||
Console.Error.WriteLine($"Launcher 更新失败: {ex.Message}");
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 10. 主程序支持更新 Launcher
|
||
|
||
**新建文件**: `LanMountainDesktop/Services/Update/LauncherUpdateService.cs`
|
||
|
||
```csharp
|
||
namespace LanMountainDesktop.Services.Update;
|
||
|
||
public class LauncherUpdateService
|
||
{
|
||
private readonly HttpClient _httpClient;
|
||
|
||
public LauncherUpdateService()
|
||
{
|
||
_httpClient = new HttpClient();
|
||
}
|
||
|
||
public async Task<bool> UpdateLauncherAsync(string downloadUrl)
|
||
{
|
||
var rootDir = LaunchContext.PackageRoot
|
||
?? Path.GetDirectoryName(Environment.ProcessPath)!;
|
||
var updatePath = Path.Combine(rootDir, "LanMountainDesktop.Launcher.Update.exe");
|
||
|
||
// 下载新版本
|
||
var response = await _httpClient.GetAsync(downloadUrl);
|
||
await using var fs = File.Create(updatePath);
|
||
await response.Content.CopyToAsync(fs);
|
||
|
||
return true;
|
||
}
|
||
|
||
public void RestartWithNewLauncher()
|
||
{
|
||
var launcherPath = Path.Combine(
|
||
LaunchContext.PackageRoot ?? "",
|
||
"LanMountainDesktop.exe");
|
||
|
||
Process.Start(new ProcessStartInfo
|
||
{
|
||
FileName = launcherPath,
|
||
UseShellExecute = true
|
||
});
|
||
|
||
// 退出主程序，让 Launcher 接管
|
||
Environment.Exit(0);
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### P3: 清理旧代码
|
||
|
||
#### 11. 删除文件清单
|
||
|
||
**删除以下文件/目录**:
|
||
|
||
```
|
||
LanMountainDesktop.Launcher/
|
||
├── App.axaml ← 删除
|
||
├── App.axaml.cs ← 删除
|
||
├── Views/ ← 删除整个目录
|
||
│ ├── OobeWindow.axaml
|
||
│ ├── OobeWindow.axaml.cs
|
||
│ ├── SplashWindow.axaml
|
||
│ └── SplashWindow.axaml.cs
|
||
├── Services/ ← 删除大部分
|
||
│ ├── LauncherFlowCoordinator.cs ← 删除
|
||
│ ├── OobeStateService.cs ← 删除
|
||
│ ├── UpdateCheckService.cs ← 删除
|
||
│ ├── UpdateEngineService.cs ← 删除
|
||
│ ├── PluginInstallerService.cs ← 删除
|
||
│ └── PluginUpgradeQueueService.cs ← 删除
|
||
└── Models/ ← 删除（如不再需要）
|
||
```
|
||
|
||
---
|
||
|
||
### P4: GitHub Actions 工作流修改
|
||
|
||
#### 12. 修改 release.yml
|
||
|
||
**关键修改点**:
|
||
|
||
1. **Launcher 单独编译**:
|
||
```yaml
|
||
- name: Publish Launcher
|
||
run: |
|
||
dotnet publish LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj `
|
||
-c Release `
|
||
-o ./publish/launcher-win-x64 `
|
||
--self-contained `
|
||
-r win-x64 `
|
||
-p:PublishSingleFile=false `
|
||
-p:PublishTrimmed=false `
|
||
-p:DebugType=none
|
||
```
|
||
|
||
2. **目录结构调整**:
|
||
```yaml
|
||
- name: Restructure for Launcher
|
||
run: |
|
||
$version = "${{ needs.prepare.outputs.version }}"
|
||
$publishDir = "publish/windows-x64"
|
||
$launcherDir = "publish/launcher-win-x64"
|
||
$appDir = "app-$version"
|
||
|
||
# 创建新结构
|
||
$newStructure = "publish-launcher/windows-x64"
|
||
New-Item -ItemType Directory -Path $newStructure -Force
|
||
|
||
# 移动主程序到 app-{version}/
|
||
$appPath = Join-Path $newStructure $appDir
|
||
Move-Item -Path $publishDir -Destination $appPath -Force
|
||
|
||
# 复制 Launcher 到根目录
|
||
Copy-Item -Path "$launcherDir\*" -Destination $newStructure -Recurse -Force
|
||
|
||
# 创建 .current 标记
|
||
New-Item -ItemType File -Path (Join-Path $appPath ".current") -Force
|
||
```
|
||
|
||
3. **Linux/macOS 同样调整**:
|
||
- Linux: 修改 DEB 打包流程
|
||
- macOS: 修改 DMG 打包流程
|
||
|
||
#### 13. 修改 build.yml
|
||
|
||
**修改**: 移除 Launcher 相关构建步骤，因为 Launcher 现在完全独立
|
||
|
||
---
|
||
|
||
### P5: 图标资源处理
|
||
|
||
#### 14. Launcher 图标配置
|
||
|
||
**方案**: 使用链接方式引用主程序图标
|
||
|
||
**文件**: `LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj`
|
||
|
||
```xml
|
||
<ItemGroup>
|
||
<!-- 链接主程序的图标 -->
|
||
<Content Include="..\LanMountainDesktop\Assets\logo_nightly.ico" Link="Assets\logo_nightly.ico">
|
||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
|
||
</Content>
|
||
</ItemGroup>
|
||
```
|
||
|
||
#### 15. 安装程序配置
|
||
|
||
**文件**: `LanMountainDesktop/installer/LanMountainDesktop.iss` (Inno Setup)
|
||
|
||
**关键配置**:
|
||
|
||
```ini
|
||
[Setup]
|
||
AppName=阑山桌面
|
||
AppVersion={#MyAppVersion}
|
||
DefaultDirName={autopf}\LanMountainDesktop
|
||
OutputBaseFilename=LanMountainDesktop-Setup-{#MyAppVersion}-x64
|
||
SetupIconFile=..\Assets\logo_nightly.ico
|
||
UninstallDisplayIcon={app}\LanMountainDesktop.exe
|
||
|
||
[Files]
|
||
; Launcher
|
||
Source: "..\..\publish\windows-x64\LanMountainDesktop.exe"; DestDir: "{app}"; Flags: ignoreversion
|
||
; 主程序版本目录
|
||
Source: "..\..\publish\windows-x64\app-{#MyAppVersion}\*"; DestDir: "{app}\app-{#MyAppVersion}"; Flags: ignoreversion recursesubdirs
|
||
|
||
[Icons]
|
||
; 桌面快捷方式
|
||
Name: "{autodesktop}\阑山桌面"; Filename: "{app}\LanMountainDesktop.exe"; IconFilename: "{app}\LanMountainDesktop.exe"
|
||
; 开始菜单
|
||
Name: "{group}\阑山桌面"; Filename: "{app}\LanMountainDesktop.exe"; IconFilename: "{app}\LanMountainDesktop.exe"
|
||
```
|
||
|
||
---
|
||
|
||
## 文件变更清单
|
||
|
||
### 修改文件
|
||
|
||
1. `LanMountainDesktop.Launcher/Program.cs` - 完全重写
|
||
2. `LanMountainDesktop.Launcher/LanMountainDesktop.Launcher.csproj` - 简化依赖
|
||
3. `LanMountainDesktop/LanMountainDesktop.csproj` - 移除 Launcher 引用
|
||
4. `LanMountainDesktop/Program.cs` - 添加 LaunchContext
|
||
5. `LanMountainDesktop/App.axaml.cs` - 添加 OOBE/Splash/更新入口
|
||
6. `.github/workflows/release.yml` - 调整打包流程
|
||
7. `.github/workflows/build.yml` - 适配新构建流程
|
||
|
||
### 新增文件
|
||
|
||
1. `LanMountainDesktop/Services/Oobe/OobeService.cs`
|
||
2. `LanMountainDesktop/Views/Oobe/OobeWindow.axaml`
|
||
3. `LanMountainDesktop/Views/Oobe/OobeWindow.axaml.cs`
|
||
4. `LanMountainDesktop/Views/Splash/SplashWindow.axaml`
|
||
5. `LanMountainDesktop/Views/Splash/SplashWindow.axaml.cs`
|
||
6. `LanMountainDesktop/Services/Update/UpdateService.cs`
|
||
7. `LanMountainDesktop/Services/Update/LauncherUpdateService.cs`
|
||
8. `LanMountainDesktop/Services/Plugins/PluginUpdateService.cs`
|
||
|
||
### 删除文件
|
||
|
||
1. `LanMountainDesktop.Launcher/App.axaml`
|
||
2. `LanMountainDesktop.Launcher/App.axaml.cs`
|
||
3. `LanMountainDesktop.Launcher/Views/` 目录
|
||
4. `LanMountainDesktop.Launcher/Services/LauncherFlowCoordinator.cs`
|
||
5. `LanMountainDesktop.Launcher/Services/OobeStateService.cs`
|
||
6. `LanMountainDesktop.Launcher/Services/UpdateCheckService.cs`
|
||
7. `LanMountainDesktop.Launcher/Services/UpdateEngineService.cs`
|
||
8. `LanMountainDesktop.Launcher/Services/PluginInstallerService.cs`
|
||
9. `LanMountainDesktop.Launcher/Services/PluginUpgradeQueueService.cs`
|
||
|
||
---
|
||
|
||
## 风险与回滚方案
|
||
|
||
### 风险
|
||
|
||
1. **启动失败**: 新 Launcher 可能有 bug 导致无法启动
|
||
2. **更新中断**: 更新逻辑迁移可能导致更新失败
|
||
3. **图标丢失**: 图标配置错误导致快捷方式无图标
|
||
|
||
### 回滚方案
|
||
|
||
1. 保留原 Launcher 代码分支
|
||
2. 准备紧急修复版本
|
||
3. 用户可手动下载完整安装包恢复
|
||
|
||
---
|
||
|
||
## 验证清单
|
||
|
||
- [ ] Launcher 能正常启动主程序
|
||
- [ ] 版本选择逻辑正确
|
||
- [ ] 旧版本清理正常
|
||
- [ ] OOBE 流程正常
|
||
- [ ] Splash 显示正常
|
||
- [ ] 更新检查正常
|
||
- [ ] 插件安装正常
|
||
- [ ] GitHub Actions 打包成功
|
||
- [ ] 安装程序图标正常
|
||
- [ ] 快捷方式图标正常
|
||
|
||
---
|
||
|
||
## 实施顺序建议
|
||
|
||
### 第一阶段（立即实施）
|
||
1. 重写 Launcher Program.cs
|
||
2. 修改 Launcher.csproj
|
||
3. 移除主程序对 Launcher 的引用
|
||
4. 测试基本启动功能
|
||
|
||
### 第二阶段（功能迁移）
|
||
1. 迁移 OOBE 到主程序
|
||
2. 迁移 Splash 到主程序
|
||
3. 迁移更新逻辑到主程序
|
||
4. 迁移插件管理到主程序
|
||
|
||
### 第三阶段（CI/CD）
|
||
1. 修改 release.yml
|
||
2. 修改 build.yml
|
||
3. 测试打包流程
|
||
4. 验证安装程序
|
||
|
||
### 第四阶段（优化）
|
||
1. 实现 Launcher 自更新
|
||
2. 性能优化
|
||
3. 清理旧代码
|