Стабильный выпуск SDL3-CS для SDL 3.4.20.

Версии пакетов

Изменения

• Native SDL закреплён на точном upstream release-3.4.20, commit f00dc919ca35b9756316e86c4777392de442f9b2. Выпуск исправляет работу мыши, clipboard, Vulkan, контроллеров и мобильных платформ; полный список upstream.
• Добавлен SDL.Hints.PS2GSColorDepth; XML документация audio и keyboard согласована со стабильными заголовками 3.4.20. Проверена unsigned-семантика AudioFrameSize, включая крайние значения каналов.
• Android Java bridge обновлён из того же SDL commit, включая исправления HID, audio callback lifetime и relative mouse events.
• На 06.11.2026 последние стабильные версии сопутствующих библиотек остаются SDL_image 3.4.8, SDL_mixer 3.2.4 и SDL_ttf 3.2.2. Их исходные commit сохранены.
• SDL_shadercross соответствует текущему upstream main 1ff05bec573988a98ef9e0260b4da44f512b8367, интегрированному в PR #328 для issue #327. Стабильного upstream release/tag у библиотеки нет; nativeVersion остаётся 3.0.0.
• Все шесть платформ каждого сопутствующего семейства используют общие ревизии для полной пересборки native matrix вместе с новым SDL.

Совместимость

Managed API соответствует стабильному SDL 3.4.20. Экспериментальные API SDL 3.6 не включены. Для обновления используйте SDL3-CS и core-пакет вашей платформы версии 3.4.20.0, а сопутствующие пакеты — с версиями из таблицы выше.

Stable SDL3-CS release for SDL 3.4.18 and SDL_image 3.4.8.

Package Versions

Changes

• Updated every Image native package to exact upstream SDL_image release-3.4.8 (#319).
• The upstream public header changes only its micro version macro; the managed SDL3-CS API and ABI are unchanged.
• Corrected the SDL_SetGPUBlendConstants interop ABI so SDL_FColor is passed by value, preserving constant blend colors (#321).
• Corrected native IO read/write return values to use pointer-sized size_t values while preserving the public ulong API (#318).
• Rebuilt the complete native RID matrix from the pinned sources; Mixer, TTF, and Shadercross use revision 14 because revision 13 was already published.

Applications should update SDL3-CS and the matching core platform package to 3.4.18.1, then use the matching Image package version above.

Stable API compatibility

The wrapper API and event layouts target stable SDL 3.4.18. Development-only SDL 3.6 APIs from PR #309 (including OpenXR, notifications and HasSVE2) are excluded from this release and from main until their native stable baseline is available. The IO size_t and GPU blend-constant ABI fixes are retained. The development changes remain available in Git history.

Stable upstream releases were rechecked on 2026-10-21: SDL 3.4.18, SDL_image 3.4.8, SDL_ttf 3.2.2 and SDL_mixer 3.2.4. SDL_shadercross has no stable release or SemVer tag, so its verified source pin is unchanged. All five component families are included in the full native release.

Stable SDL3-CS release for SDL 3.4.18.

Package Versions

Changes

• Updated the core native baseline to exact upstream SDL release-3.4.18 and exposed PenDeviceType on all five pen event layouts (#314).
• Aligned Front keycode/scancode and GPU/app metadata documentation with the stable SDL 3.4.18 headers; no SDL 3.6 development API is included.
• Rebuilt the full native matrix and the exact Android Java bridge; companion upstream versions remain unchanged.

Applications should update SDL3-CS and the matching core platform package to 3.4.18.0 and use the companion package revisions listed above.

SDL3-CS patch release with the GPU alpha-to-coverage API fix and rebuilt native package families.

Package Versions

Changes

• Exposed the typed GPUMultisampleState.EnableAlphaToCoverage property (#303).
• Bundled native license and patent notices in every platform package (#305).
• Bundled LGPL source archives and build provenance for the affected Mixer and Shadercross packages (#306).

Applications should update SDL3-CS and all platform-native package families to the versions shown above.

SDL3-CS managed-only patch release that restores source-generator compatibility with supported .NET SDK compiler hosts.

Package Versions

Changes

• Restored the source generator's Roslyn 4.4 compatibility baseline and added a package-level regression check, preventing CS9057 with SDK compiler hosts that use Roslyn 5.0 (#296).

Applications should update SDL3-CS to 3.4.16.1; existing native platform package versions are reused unchanged.

Stable SDL3-CS release for SDL 3.4.16, SDL_image 3.4.6, and the verified SDL_shadercross upstream main baseline.

This release rebuilds and validates the complete native RID matrix from the exact manifest source revisions. The SDL Metal fence correction previously carried as a downstream patch is included in upstream SDL 3.4.16, so the core package returns to an exact stable tag source.

Package Versions

Changes

• Added First and Last aliases for the supported SDL event groups, making event routing filters easier to express (#276).
• Updated the core native baseline and wrapper documentation to exact SDL 3.4.16, including the pen proximity state field and Android AAudio input preset hint (#292).
• Updated every Image native package to exact SDL_image 3.4.6 (#293).
• Updated every Shadercross native package to exact upstream main@e55cf5e31ced6f3d1be5cc6d0c50e99384f9f4ba, which contains the DirectXShaderCompiler discovery fixes without public header changes (#294).

Applications should update SDL3-CS and all platform-native package families to the versions shown above.

SDL3-CS patch release for SDL 3.4.14 with managed ABI corrections and the verified Avalonia Android audio-only reference.

This release rebuilds and validates the complete native RID matrix from the exact manifest source revisions. The Android base and SDL_mixer package READMEs now document the supported audio-only integration, so their payload changes are published together with a full native-package verification.

Package Versions

Changes

• Corrected display lookup bindings so SDL display structures are passed by pointer, matching the native ABI (#267).
• Added frame-duration output support to IMG_GetAnimationDecoderFrame (#268).
• Added the required duration parameter to MIX_CreateSineWaveAudio (#269).
• Added a verified audio-only Avalonia Android SDL_mixer reference that keeps an existing Activity and documents the JNI/context and lifecycle sequence (#274).
• Aligned the Roslyn package references with version 5.9.0.

Applications should update SDL3-CS and all platform-native package families to the versions shown above.

SDL3-CS patch release for SDL 3.4.14 with a native Metal GPU fix and managed API improvements.

This release rebuilds and validates the complete native RID matrix from the exact manifest source revisions. The core SDL packages include the corrected Metal fence behavior; the remaining native component families are rebuilt at common free revisions so every supported platform remains version-aligned.

Package Versions

Changes

• Corrected the inverted SDL_QueryGPUFence completion result in the Metal backend used by the macOS native packages (#257).
• Fixed SDL_AppInit callback argument marshalling so the managed callback receives the complete argv array (#262).
• Added scoped span-based overloads for GPU uniforms, shader and graphics-pipeline creation, texture updates, and SDL_ttf UTF-8 input (#249, #250, #251, #252, #253, #254).
• Added managed ShaderCross overloads for HLSL source and SPIR-V graphics-shader entry points (#255, #256).

Applications using the Metal GPU backend should update the managed package and every native component package to the versions shown above.

Stable SDL3-CS feature and Android compatibility release for SDL 3.4.14.

This release updates the managed wrapper and every platform-specific core package to the exact SDL 3.4.14 stable source. Android packages are rebuilt with native 16 KB page-size support. The production release rebuilds and validates the complete native RID matrix from the exact manifest source revisions so every supported platform remains version-aligned.

Package Versions

Changes

• Updated the core SDL baseline from 3.4.12 to the exact stable SDL 3.4.14 release, including matching wrapper documentation and native packages (#246).
• Added a managed SDL main-callback application contract and opt-in generated entry point, including managed-state lifetime handling and exception containment (#232).
• Rebuilt the complete Android native payload with Android NDK r28c and explicit flexible page-size support (#244).
• Rebuilt the Android SDLActivity bridge from the exact SDL 3.4.14 source revision and retained deterministic source/version parity gates.
• Added fail-closed checks for every packaged Android shared library, final APK alignment, Android App Bundle page alignment, and execution on a 16 KB Android environment.

The SDL 3.4.14 header describes GIP metadata reset as enabled by default. The exact 3.4.14 release runtime still uses false when that hint is unset; applications that require reset behavior should set the hint explicitly.

Applications targeting Android 15/API 35 or newer should update the managed package and every Android native component package to the versions shown above.

Stable SDL3-CS patch release for SDL 3.4.12.

This release publishes the managed SDL3-CS wrapper and aligns every SDL_image platform package on revision 3.4.4.8. Android, Linux, and Windows packages include the required libwebp license; iOS, macOS, and tvOS use a version-only repack. Native binaries and source revisions are unchanged.

Package Versions

Changes

• Added the missing GPURenderStateCreateInfo managed binding and typed GPU render-state creation API (#208).
• Corrected the source-region type used by DownloadFromGPUBuffer (#221).
• Added mixed nullable/pointer CreateAudioStream overloads for practical source and destination specification combinations (#223).
• Aligned PointInRectFloat edge handling with SDL and added a non-nullable overload (#225).
• Added the libwebp license to Android, Linux, and Windows Image runtime packages and aligned iOS, macOS, and tvOS on the same Image package revision without rebuilding or changing native payloads (#226).

Applications should update SDL3-CS to 3.4.12.4. Consumers of Image packages should update every platform package to 3.4.4.8; other native component package versions remain unchanged.