mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-20 23:54:26 +08:00
f8a4bb888c
Introduce unified material/color spec and tests, and refactor appearance plumbing to use MaterialColorSnapshot as the single source of truth. Add .trae material-color-service spec/checklist/tasks and integration/unit tests for plugin mapping and appearance VM behavior. AppearanceChangedEvent extended with new appearance change flags and HasChanged logic. ComponentEditorMaterialThemeAdapter rewritten to accept MaterialColorSnapshot and derive palette from snapshot data. Simplify AppearanceSettingsPageViewModel and related view code: remove legacy preview/custom-seed UI logic, preserve material/color fields when updating theme or corner radius, and update save calls to use with-expressions. Update ComponentEditorWindow to use adapter-provided OnPrimary brush and minor docs updates.
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# Plugin SDK v5 Migration Guide
|
|
|
|
Plugin SDK v5 is the Avalonia 12 compatibility baseline for LanMountainDesktop plugins.
|
|
|
|
## What Changed
|
|
|
|
- Rebuild plugins against `LanMountainDesktop.PluginSdk` `5.0.0`.
|
|
- Set `plugin.json` `apiVersion` to `5.0.0`.
|
|
- Target `net10.0` and use Avalonia `12.0.1` compatible UI dependencies.
|
|
- Use `FluentAvaloniaUI` `3.0.0-preview1` and `FluentIcons.Avalonia` `2.1.325` when a plugin directly references those packages.
|
|
|
|
## Compatibility
|
|
|
|
SDK v5 is a binary breaking change because the SDK exposes Avalonia UI types such as `Control`, `UserControl`, and `SettingsPageBase`. Plugins built for SDK v4 must be rebuilt and republished for SDK v5.
|
|
|
|
The host does not provide an Avalonia 11 / Avalonia 12 dual UI stack. The public extension entry points remain the same: custom settings pages still derive from `SettingsPageBase`, and desktop components still provide Avalonia controls through the existing registration APIs.
|
|
|
|
## Appearance Snapshot
|
|
|
|
`IPluginAppearanceContext.Snapshot` remains read-only. In addition to theme variant and corner radius tokens, the snapshot can now include host material/color data:
|
|
|
|
- `AccentColor`
|
|
- `SeedColor`
|
|
- `ColorSource`
|
|
- `SystemMaterialMode`
|
|
- `ColorRoles`
|
|
- `MaterialSurfaces`
|
|
- `WallpaperSeedCandidates`
|
|
|
|
Existing plugins that only read `CornerRadiusTokens` and `ThemeVariant` continue to work. New plugins should treat the added properties as optional and prefer `ColorRoles`/`MaterialSurfaces` over hard-coded colors.
|
|
|
|
## Minimal Package Update
|
|
|
|
```xml
|
|
<ItemGroup>
|
|
<PackageReference Include="LanMountainDesktop.PluginSdk" Version="5.0.0" />
|
|
</ItemGroup>
|
|
```
|
|
|
|
```json
|
|
{
|
|
"apiVersion": "5.0.0"
|
|
}
|
|
```
|
|
|
|
## Validation
|
|
|
|
After updating package versions and rebuilding the plugin, verify that the generated `.laapp` contains the rebuilt assembly, `plugin.json`, and `.deps.json` next to the plugin entry assembly.
|