Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

## [Unreleased]

### Changed
- **Breaking:** SkiaSharp 4.156.1 (was 4.153.1), which needs Uno.Sdk 7 / Uno.WinUI 7 and `Microsoft.Maui.Controls` 10.0.110. KumikoUI.Uno is built with Uno.Sdk 7.0.22 (was 6.7.30), and KumikoUI.Maui now declares a minimum of `Microsoft.Maui.Controls` 10.0.110 (was 10.0.20). Uno apps must move to Uno.Sdk 7 and set `<SkiaSharpVersion>4.156.1</SkiaSharpVersion>`. On Uno.Sdk 7.0.22 an app may also need explicit `HarfBuzzSharp.NativeAssets.*` references at 14.4.0.101 (the version the managed HarfBuzzSharp requires), because the SDK pins its own at 14.4.0.100 (NU1605).
- KumikoUI.Uno lists the `Skia` Uno feature (Uno 7 ignores `SkiaRenderer` in a library) and references `SkiaSharp.Views.Uno.WinUI` explicitly on every non-Windows head.
- The public API files now declare the members the compiler synthesizes for records, record structs and delegates (`Equals`, `GetHashCode`, `ToString`, `==`, `!=`, `Deconstruct`, `Invoke`), which Microsoft.CodeAnalysis.PublicApiAnalyzers 5.x requires. No behavior change.

## [1.0.0-preview.1] - 2026-11-14

First 1.0 prerelease. All four packages (KumikoUI.Core, KumikoUI.SkiaSharp, KumikoUI.Maui, KumikoUI.Uno) ship at this version, and each package depends on the exact version of its siblings. The API may still change before 1.0.0. KumikoUI.Uno is the least verified host. The release brings the 1.0 API review and `sealed`/value-type changes (#37, #112), `KumikoSource` thread affinity (#69), saved layouts, column reordering and context menus (#98, #100), native text input on iOS, Android, Windows and Uno (#40-#43), and the hardware-accelerated render mode on MAUI (`KumikoRenderMode.Hardware`, #71); the entries marked **Breaking:** below list what to change when upgrading from 0.2.0. See [docs/release/1.0.0-preview.1-release-notes.md](https://github.com/TheEightBot/KumikoUI/blob/v1.0.0-preview.1/docs/release/1.0.0-preview.1-release-notes.md) for the summary and known issues.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ The repository pins its toolchain so every machine and CI build the same way:
|---|---|---|
| .NET SDK | `global.json` → `sdk.version` (roll forward: latest patch) | 10.0.401 |
| Workload set used by CI (MAUI, iOS, Android, Mac Catalyst, WebAssembly) | `.github/actions/setup-dotnet/action.yml` | 10.0.402.1 |
| Uno.Sdk | `global.json` → `msbuild-sdks` | 6.7.30 |
| Uno.Sdk | `global.json` → `msbuild-sdks` | 7.0.22 |
| NuGet package versions | `Directory.Packages.props` (central package management) | — |
| Package sources | `nuget.config` (nuget.org only) | — |

Expand Down
21 changes: 13 additions & 8 deletions Directory.Packages.props
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@
one app. SkiaSharp 4's runtime assembly keeps the v3 members (they are only removed from the
reference assembly), so Uno's own runtime, compiled against 3.x, binds unchanged.
-->
<SkiaSharpVersion>4.153.1</SkiaSharpVersion>
<SkiaSharpVersion>4.156.1</SkiaSharpVersion>

<!--
Minimum .NET MAUI version KumikoUI.Maui supports. It becomes the package's dependency floor, so it
no longer floats with whatever MAUI workload the build machine has. 10.0.20 is also the floor of
SkiaSharp.Views.Maui.Controls 4.153.1. Dependabot ignores it (.github/dependabot.yml); raise it by hand.
no longer floats with whatever MAUI workload the build machine has. 10.0.110 is also the floor of
SkiaSharp.Views.Maui.Controls 4.156.1. Dependabot ignores it (.github/dependabot.yml); raise it by hand.
-->
<MauiVersion>10.0.20</MauiVersion>
<MauiVersion>10.0.110</MauiVersion>

<!--
Version of Microsoft.Windows.Compatibility that Uno.Sdk adds implicitly to WebAssembly heads
Expand All @@ -40,7 +40,7 @@
MAUI uses MauiVersion above (the minimum KumikoUI.Maui supports).
-->
<WindowsAppSdkWinUIVersion>1.8.260528001</WindowsAppSdkWinUIVersion>
<UnoWinUIVersion>6.7.135</UnoWinUIVersion>
<UnoWinUIVersion>7.0.65</UnoWinUIVersion>
<WindowsDesktopRefVersion>10.0.13</WindowsDesktopRefVersion>
<!-- Other UI frameworks and grids an app may import next to KumikoUI. -->
<CommunityToolkitWinUIDataGridVersion>7.1.2</CommunityToolkitWinUIDataGridVersion>
Expand All @@ -64,11 +64,16 @@
<PackageVersion Include="SkiaSharp.Views" Version="$(SkiaSharpVersion)" />
<PackageVersion Include="SkiaSharp.Views.Maui.Controls" Version="$(SkiaSharpVersion)" />
<PackageVersion Include="SkiaSharp.Views.WinUI" Version="$(SkiaSharpVersion)" />
<PackageVersion Include="SkiaSharp.Views.Uno.WinUI" Version="$(SkiaSharpVersion)" />
<PackageVersion Include="SkiaSharp.Skottie" Version="$(SkiaSharpVersion)" />
<PackageVersion Include="SkiaSharp.NativeAssets.Linux" Version="$(SkiaSharpVersion)" />
<!-- The HarfBuzzSharp version SkiaSharp.HarfBuzz depends on; its Linux native library is a separate package. -->
<PackageVersion Include="HarfBuzzSharp.NativeAssets.Linux" Version="14.2.1.301" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.WebAssembly" Version="14.2.1.301" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.Linux" Version="14.4.0.101" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.WebAssembly" Version="14.4.0.101" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.Android" Version="14.4.0.101" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.iOS" Version="14.4.0.101" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.Win32" Version="14.4.0.101" />
<PackageVersion Include="HarfBuzzSharp.NativeAssets.macOS" Version="14.4.0.101" />
</ItemGroup>

<ItemGroup Label="Hosts">
Expand All @@ -83,7 +88,7 @@
<ItemGroup Label="Build">
<PackageVersion Include="MinVer" Version="8.0.0" />
<!-- Records the public API of the four shipped libraries in PublicAPI.*.txt files (Directory.Build.targets, #54). -->
<PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="3.3.4" />
<PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="5.6.0" />
</ItemGroup>

<!--
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
</p>
<p align="center">
<img alt=".NET 10" src="https://img.shields.io/badge/.NET-10.0-512BD4?logo=dotnet" />
<img alt="SkiaSharp" src="https://img.shields.io/badge/SkiaSharp-4.153.1-ff6b6b" />
<img alt="SkiaSharp" src="https://img.shields.io/badge/SkiaSharp-4.156.1-ff6b6b" />
<img alt="Hosts" src="https://img.shields.io/badge/hosts-.NET%20MAUI%20%7C%20Uno%20Platform-512BD4" />
<img alt="Platforms" src="https://img.shields.io/badge/platforms-iOS%20%7C%20Android%20%7C%20macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20WebAssembly-blue" />
<img alt="License" src="https://img.shields.io/badge/license-MIT-green" />
Expand Down Expand Up @@ -113,7 +113,7 @@ All four packages share one version, and each depends on the exact version of th

## Supported platforms

All packages target **.NET 10** and **SkiaSharp 4.153.1**.
All packages target **.NET 10** and **SkiaSharp 4.156.1**.

| Package | Platform (target framework) | Minimum OS | App build host | Verification |
|---|---|---|---|---|
Expand Down Expand Up @@ -144,7 +144,7 @@ The grid, its columns and its options are the same on both hosts. What differs i
|---|---|---|
| Package | `KumikoUI.Maui` | `KumikoUI.Uno` |
| Startup | `builder.UseKumikoUI()` in `MauiProgram` (required: it registers SkiaSharp's MAUI handlers and passes `ConfigureFonts` aliases to the grid) | no startup call |
| App project | — | `<SkiaSharpVersion>4.153.1</SkiaSharpVersion>` and the `SkiaRenderer` Uno feature |
| App project | — | `<SkiaSharpVersion>4.156.1</SkiaSharpVersion>` and the `SkiaRenderer` Uno feature |
| Control namespace | `clr-namespace:KumikoUI.Maui;assembly=KumikoUI.Maui` | `using:KumikoUI.Uno` |
| Models namespace | `clr-namespace:KumikoUI.Core.Models;assembly=KumikoUI.Core` | `using:KumikoUI.Core.Models` |
| Two-way bindings | default for the selection properties | set `Mode=TwoWay` explicitly (WinUI bindings default to one-way) |
Expand Down Expand Up @@ -221,15 +221,15 @@ The grid, its columns and its options are the same on both hosts. What differs i
<!-- snippet: skip project file fragment, not C# or XAML -->
```xml
<PropertyGroup>
<SkiaSharpVersion>4.153.1</SkiaSharpVersion>
<SkiaSharpVersion>4.156.1</SkiaSharpVersion>
<UnoFeatures>
SkiaRenderer;
</UnoFeatures>
</PropertyGroup>

<!-- Windows App SDK head only: the SkiaRenderer feature does not add the WinUI SkiaSharp views -->
<ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
<PackageReference Include="SkiaSharp.Views.WinUI" Version="4.153.1" />
<PackageReference Include="SkiaSharp.Views.WinUI" Version="4.156.1" />
</ItemGroup>
```

Expand Down Expand Up @@ -1938,7 +1938,7 @@ Set `IsReadOnly`, `AllowSorting` or `AllowFiltering` to `False` on the grid. The
The grid places its input view over the edited cell. If the keyboard still covers the cell, the grid scrolls it above the keyboard. A cell in the last rows can only move as far as the grid can scroll, so let the window make room: set `WindowSoftInputMode` to `adjustResize` or `adjustPan` ([docs/TEXT-INPUT.md](docs/TEXT-INPUT.md#android)).

**My Uno app fails to load SkiaSharp, or draws nothing.**
Set `<SkiaSharpVersion>4.153.1</SkiaSharpVersion>` in the app project and enable the `SkiaRenderer` Uno feature: Uno.Sdk defaults to SkiaSharp 3.x, and the app must resolve the same major as KumikoUI. On the Windows App SDK head, also reference `SkiaSharp.Views.WinUI` ([Uno Platform](#uno-platform)).
Set `<SkiaSharpVersion>4.156.1</SkiaSharpVersion>` in the app project and enable the `SkiaRenderer` Uno feature: Uno.Sdk defaults to SkiaSharp 3.x, and the app must resolve the same major as KumikoUI. On the Windows App SDK head, also reference `SkiaSharp.Views.WinUI` ([Uno Platform](#uno-platform)).

**My iOS or Mac Catalyst app terminates at launch.**
Adopt the UIScene lifecycle; see the note under [.NET MAUI](#net-maui).
Expand Down
2 changes: 1 addition & 1 deletion docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Settled with the maintainer on 2026-10-22. Each is the contract the issues imple
| Package scope | Core, SkiaSharp and MAUI reach 1.0.0 together. KumikoUI.Uno is backed as a first-class target and ships as 1.0.0 only if every head passes the device matrix (H3); otherwise it ships `1.0.0-preview` and joins at 1.0.x. Versions stay in lockstep. **Update 2026-11-14:** versions stay in lockstep, so the first release is `1.0.0-preview.1` for all four packages; whether Uno joins the stable `1.0.0` is decided from the device matrix then. |
| Runtime | `net10.0` everywhere; `net9.0` dropped. |
| SkiaSharp | 4.153.x before 1.0 (compile-breaking text API and native ABI change land once, before the freeze). |
| Watermark | Android API 24, iOS 17.0, Mac Catalyst 17.0, Windows 10.0.19041 on both hosts; re-baselined at each .NET major. Uno.Sdk 6.7.x via `global.json`, central package management, pinned workload sets. |
| Watermark | Android API 24, iOS 17.0, Mac Catalyst 17.0, Windows 10.0.19041 on both hosts; re-baselined at each .NET major. Uno.Sdk 7.0.x via `global.json`, central package management, pinned workload sets. |
| API freeze | All breaking clean-up happens in 0.2.0: `KumikoDataGrid` control name, collision-free type names, `RowTappedEventArgs`, runtime state only through `KumikoSource`, item-based read-only selection, structured `ViewChanged`, dead members removed, grid-level `IsReadOnly`/`AllowSorting`/`AllowFiltering` implemented, one `UseKumikoUI()` on MAUI and no hosting call on Uno, `ContentView`/`Control` base classes, `IDisposable` source. Namespaces stay rooted at `KumikoUI`. |
| Naming | Product "KumikoUI DataGrid". `DataGrid*` for model/host types, `Grid*` for primitives and engine, `Drawn*` for editors; no other `Kumiko*` types. File names match type names. |
| Governance tooling | PublicApiAnalyzers now; package validation from 1.0.0; CS1591 as error after docs; `.editorconfig` + `dotnet format` in CI. |
Expand Down
2 changes: 1 addition & 1 deletion global.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@
"rollForward": "latestPatch"
},
"msbuild-sdks": {
"Uno.Sdk": "6.7.30"
"Uno.Sdk": "7.0.22"
}
}
12 changes: 9 additions & 3 deletions samples/SampleApp.Uno/Platforms/Android/Main.Android.cs
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
using Android.Views;
using Android.Widget;
using Microsoft.UI.Xaml.Media;
using Uno.UI.Hosting;

namespace SampleApp.Uno.Droid;

Expand All @@ -19,17 +20,22 @@ namespace SampleApp.Uno.Droid;
HardwareAccelerated = true,
Theme = "@style/Theme.App.Starting"
)]
public class Application : Microsoft.UI.Xaml.NativeApplication
public class Application : global::Uno.UI.Runtime.Android.NativeApplication
{
static Application()
{
App.InitializeLogging();
}

public Application(IntPtr javaReference, JniHandleOwnership transfer)
: base(() => new App(), javaReference, transfer)
: base(javaReference, transfer)
{
}

// Uno 7 builds the host in the application class, when the first activity starts.
protected override global::Uno.UI.Hosting.UnoPlatformHost CreateHost() =>
global::Uno.UI.Hosting.UnoPlatformHostBuilder.Create()
.App(() => new App())
.UseAndroid()
.Build();
}

Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ namespace SampleApp.Uno.Droid;
ConfigurationChanges = global::Uno.UI.ActivityHelper.AllConfigChanges,
WindowSoftInputMode = SoftInput.AdjustResize | SoftInput.StateHidden
)]
public class MainActivity : Microsoft.UI.Xaml.ApplicationActivity
public class MainActivity : global::Uno.UI.Runtime.Android.ApplicationActivity
{
protected override void OnCreate(Bundle? savedInstanceState)
{
Expand Down
21 changes: 21 additions & 0 deletions samples/SampleApp.Uno/SampleApp.Uno.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,27 @@
<PackageReference Include="SkiaSharp.Views.WinUI" />
</ItemGroup>

<!--
Uno.Sdk 7.0.22 adds HarfBuzzSharp's native libraries to each head at 14.4.0.100, while Uno.WinUI 7.0.65 and
SkiaSharp.HarfBuzz depend on the managed HarfBuzzSharp 14.4.0.101, whose native packages need 14.4.0.101. The
mismatch is an NU1605 downgrade, so the app references the natives at the managed version (Directory.Packages.props).
Uno dedups its implicit references against these explicit ones.
-->
<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
<PackageReference Include="HarfBuzzSharp.NativeAssets.Android" />
</ItemGroup>
<ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
<PackageReference Include="HarfBuzzSharp.NativeAssets.iOS" />
</ItemGroup>
<ItemGroup Condition="$(TargetFramework.Contains('-desktop'))">
<PackageReference Include="HarfBuzzSharp.NativeAssets.Win32" />
<PackageReference Include="HarfBuzzSharp.NativeAssets.macOS" />
<PackageReference Include="HarfBuzzSharp.NativeAssets.Linux" />
</ItemGroup>
<ItemGroup Condition="$(TargetFramework.Contains('-browserwasm'))">
<PackageReference Include="HarfBuzzSharp.NativeAssets.WebAssembly" />
</ItemGroup>

<!--
Reference the library under test. KumikoUI.Uno is itself a multi-head Uno project with the SAME
head TFMs as this app, so the per-head TargetFramework MUST flow through (no UndefineProperties)
Expand Down
Loading
Loading