mirror of https://github.com/wwiinnddyy/LanMountainDesktop.git synced 2026-06-24 02:14:26 +08:00

Files

lincube 93d6d93815 Migrate to Avalonia 12 and Plugin SDK v5

Upgrade project to the Avalonia 12 baseline and Plugin SDK v5: centralize Avalonia packages, remove legacy WebView.Avalonia usage (use NativeWebView/WebView2 EnvironmentRequested), and update Fluent/Material icon/package usages. Bump multiple package/project versions to 5.0.0 and Avalonia 12.0.1, update plugin template and README/docs to SDK v5, and add PLUGIN_SDK_V5_MIGRATION.md.

Also fix runtime/behavior bugs: make DataLocationResolver use a fixed bootstrap launcher data path and avoid recursive ResolveDataRoot; add legacy-state handling and extraction in OobeStateService; and update component settings tests to reflect migrated storage (DB/backup) and reset cache for test reloads. Various csproj, tests, and docs updated to reflect the migration and ensure build/test compatibility.

2026-04-29 10:16:25 +08:00

2.0 KiB

Raw Blame History

01-插件打包规范

了解 .laapp 包的规范和结构，确保插件能正确安装和运行。

📦 .laapp 文件格式

.laapp 是阑山桌面的插件包格式，本质上是一个 ZIP 压缩包。

文件结构

MyPlugin.laapp
├── plugin.json              # 插件清单（必需）
├── MyPlugin.dll             # 主程序集（必需）
├── Localization/            # 本地化文件夹
│   ├── zh-CN.json
│   └── en-US.json
└── *.dll                    # 依赖项

📋 plugin.json 规范

必需字段

{
  "id": "com.example.myplugin",
  "name": "我的插件",
  "description": "插件描述",
  "author": "作者名",
  "version": "1.0.0",
  "apiVersion": "5.0.0",
  "entranceAssembly": "MyPlugin.dll",
  "sharedContracts": []
}

字段验证规则

字段	规则
`id`	小写字母、数字、点号，反向域名格式
`version`	语义化版本（x.y.z）
`apiVersion`	必须与 SDK 版本兼容
`entranceAssembly`	必须与 DLL 文件名一致

🔨 构建配置

.csproj 关键配置

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
  </PropertyGroup>
  
  <ItemGroup>
    <PackageReference Include="LanMountainDesktop.PluginSdk" Version="5.0.0" />
  </ItemGroup>
  
  <!-- 确保资源文件复制到输出目录 -->
  <ItemGroup>
    <None Update="plugin.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="Localization\**\*.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
  </ItemGroup>
</Project>

✅ 打包检查清单

plugin.json 格式正确
id 全局唯一
apiVersion 与 SDK 版本匹配
DLL 文件名与 entranceAssembly 一致
所有依赖项已包含
本地化文件完整

最后更新：2026年4月

2.0 KiB Raw Blame History Unescape Escape