2026-04-13 19:54:37 +08:00
|
|
|
|
# 01-插件打包规范
|
|
|
|
|
|
|
|
|
|
|
|
了解 .laapp 包的规范和结构，确保插件能正确安装和运行。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 📦 .laapp 文件格式
|
|
|
|
|
|
|
|
|
|
|
|
`.laapp` 是阑山桌面的插件包格式，本质上是一个 **ZIP 压缩包**。
|
|
|
|
|
|
|
|
|
|
|
|
### 文件结构
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
MyPlugin.laapp
|
|
|
|
|
|
├── plugin.json # 插件清单（必需）
|
|
|
|
|
|
├── MyPlugin.dll # 主程序集（必需）
|
|
|
|
|
|
├── Localization/ # 本地化文件夹
|
|
|
|
|
|
│ ├── zh-CN.json
|
|
|
|
|
|
│ └── en-US.json
|
|
|
|
|
|
└── *.dll # 依赖项
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 📋 plugin.json 规范
|
|
|
|
|
|
|
|
|
|
|
|
### 必需字段
|
|
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
|
{
|
|
|
|
|
|
"id": "com.example.myplugin",
|
|
|
|
|
|
"name": "我的插件",
|
|
|
|
|
|
"description": "插件描述",
|
|
|
|
|
|
"author": "作者名",
|
|
|
|
|
|
"version": "1.0.0",
|
Avalonia12 (#7)
* ava12升级
* Enable centralized package versioning
Add <Project> and <PropertyGroup> with <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally> to Directory.Packages.props to enable centralized package version management across the repository. This allows package versions to be controlled from this single file instead of individual project files.
* Migrate codebase to Avalonia 12 APIs
Apply Avalonia 12 migration changes: replace SystemDecorations with WindowDecorations and remove ExtendClientAreaChromeHints/ExtendClientAreaTitleBarHeightHint usages; update BindingPlugins removal logic (no-op); switch clipboard usage to ClipboardExtensions.SetTextAsync; update Bitmap.CopyPixels calls to the new signature. Replace TextBox.Watermark with PlaceholderText, convert NumberBox styles to FANumberBox and adjust templates, change Checked/Unchecked handlers to IsCheckedChanged, and adapt FluentIcons usages (SymbolIconSource -> FASymbol/FAFont/FluentIcon equivalents). Fix MainWindow partial classes to inherit Window and correct missing variables/fields/usings. Add migration docs/specs/tasks under .trae and include a small TestFluentIcons project for icon testing.
* 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.
* Update icon glyphs and symbol mappings
Replace and refine icon sources across settings pages and controls: many FAFontIconSource glyphs were updated to specific Seagull Fluent Icons codepoints, some FASymbolIconSource usages were replaced with FAFontIconSource, and a number of symbol-to-Symbol enum mappings were adjusted (e.g. "Bell" -> AlertOn, "Shield" -> ShieldLock). Also clarified a comment in SettingsWindow and fixed a trailing newline in StudySettingsPage. Changes standardize icon visuals and bridge FluentIcons glyphs into FluentAvalonia icon sources.
* fix.修复合并产生的问题。
2026-04-29 12:14:29 +08:00
|
|
|
|
"apiVersion": "5.0.0",
|
2026-04-13 19:54:37 +08:00
|
|
|
|
"entranceAssembly": "MyPlugin.dll",
|
|
|
|
|
|
"sharedContracts": []
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 字段验证规则
|
|
|
|
|
|
|
|
|
|
|
|
| 字段 | 规则 |
|
|
|
|
|
|
|-----|------|
|
|
|
|
|
|
| `id` | 小写字母、数字、点号，反向域名格式 |
|
|
|
|
|
|
| `version` | 语义化版本（x.y.z） |
|
|
|
|
|
|
| `apiVersion` | 必须与 SDK 版本兼容 |
|
|
|
|
|
|
| `entranceAssembly` | 必须与 DLL 文件名一致 |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 🔨 构建配置
|
|
|
|
|
|
|
|
|
|
|
|
### .csproj 关键配置
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
|
|
<Project Sdk="Microsoft.NET.Sdk">
|
|
|
|
|
|
<PropertyGroup>
|
|
|
|
|
|
<TargetFramework>net10.0</TargetFramework>
|
|
|
|
|
|
</PropertyGroup>
|
|
|
|
|
|
|
|
|
|
|
|
<ItemGroup>
|
Avalonia12 (#7)
* ava12升级
* Enable centralized package versioning
Add <Project> and <PropertyGroup> with <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally> to Directory.Packages.props to enable centralized package version management across the repository. This allows package versions to be controlled from this single file instead of individual project files.
* Migrate codebase to Avalonia 12 APIs
Apply Avalonia 12 migration changes: replace SystemDecorations with WindowDecorations and remove ExtendClientAreaChromeHints/ExtendClientAreaTitleBarHeightHint usages; update BindingPlugins removal logic (no-op); switch clipboard usage to ClipboardExtensions.SetTextAsync; update Bitmap.CopyPixels calls to the new signature. Replace TextBox.Watermark with PlaceholderText, convert NumberBox styles to FANumberBox and adjust templates, change Checked/Unchecked handlers to IsCheckedChanged, and adapt FluentIcons usages (SymbolIconSource -> FASymbol/FAFont/FluentIcon equivalents). Fix MainWindow partial classes to inherit Window and correct missing variables/fields/usings. Add migration docs/specs/tasks under .trae and include a small TestFluentIcons project for icon testing.
* 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.
* Update icon glyphs and symbol mappings
Replace and refine icon sources across settings pages and controls: many FAFontIconSource glyphs were updated to specific Seagull Fluent Icons codepoints, some FASymbolIconSource usages were replaced with FAFontIconSource, and a number of symbol-to-Symbol enum mappings were adjusted (e.g. "Bell" -> AlertOn, "Shield" -> ShieldLock). Also clarified a comment in SettingsWindow and fixed a trailing newline in StudySettingsPage. Changes standardize icon visuals and bridge FluentIcons glyphs into FluentAvalonia icon sources.
* fix.修复合并产生的问题。
2026-04-29 12:14:29 +08:00
|
|
|
|
<PackageReference Include="LanMountainDesktop.PluginSdk" Version="5.0.0" />
|
2026-04-13 19:54:37 +08:00
|
|
|
|
</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月*
|