Skip to content

0.60.0 Dependancy Bundles - Upcoming Release Preview / Developer Build For Native Arm64 Wine with FEX

Choose a tag to compare

@aaf2tbz aaf2tbz released this 31 Jul 17:55
· 131 commits to main since this release
dcf7908

MetalSharp 0.60.0 Dependency Bundles | Not an Official Release

Released: July 31, 2026
Type: Runtime dependency archive for the next MetalSharp release
Current app release: MetalSharp 0.57.0

Important:

This is not a new MetalSharp application release and does not include an application DMG. MetalSharp 0.57.0 remains the current app release. This permanent archive preserves the custom native ARM64 Wine runtime for integration, testing, and the upcoming 0.60 update.

At a Glance

This release packages MetalSharp's complete native ARM64 Wine runtime and its graphics, compatibility, media, installer, managed-runtime, and Steam integration dependencies.

  • Wine: Native macOS ARM64 Wine 11.12
  • Guest support: AArch64, ARM64EC/ARM64X, x86_64, and i386/WoW64
  • Translation: Native ARM64 xtajit64.dll for x86_64 and custom FEX-derived xtajit.dll for i386
  • Graphics: MoltenVK, DXVK, vkd3d-proton, DXMT/Winemetal, and MetalSharp OpenGL-to-Metal
  • Archive: Four downloadable parts; 3.06 GB compressed (2.85 GiB), approximately 16 GiB staged
  • Contents: 45,892 entries
  • SHA-256: 9210991e4249d8dd647fba1bb7e8dcfe808f760c638eeebbf55752f560ad8f0c

Install

Download install-metalsharp-wine-runtime.sh and run:

chmod +x install-metalsharp-wine-runtime.sh
./install-metalsharp-wine-runtime.sh

The installer looks for either the complete archive or all four parts in the current directory, beside the script, and in Downloads or Desktop. If none are found, it downloads the parts from this release. It then:

  1. Verifies each part's fixed hash.
  2. Reassembles and tests the archive.
  3. Verifies every extracted payload hash.
  4. Creates the MetalSharp ~/.metalsharp/runtime/wine/bin and graphics layout adapters.
  5. Installs the runtime transactionally.

Replacing an existing runtime requires --replace. Prefixes, Steam state, bottles, saves, and shader caches are never removed.

Manual Reassembly

Download all four .part files, PARTS-SHA256SUMS.txt, and REASSEMBLE.txt into the same directory, then run:

shasum -a 256 -c PARTS-SHA256SUMS.txt
cat MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst.part01 \
    MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst.part02 \
    MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst.part03 \
    MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst.part04 \
    > MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst
shasum -a 256 MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst
zstd -t MetalSharp-Wine-Runtime-COMPLETE-all-arch-2026-07-31.tar.zst

Expected reconstructed SHA-256:

9210991e4249d8dd647fba1bb7e8dcfe808f760c638eeebbf55752f560ad8f0c

Runtime and Architecture Support

  • Native macOS ARM64 Wine 11.12 and wineserver.
  • AArch64/ARM64 Windows PE execution.
  • ARM64EC/ARM64X PE modules and import redirection.
  • x86_64 execution through the canonical native ARM64 xtajit64.dll provider.
  • i386/WoW64 execution through the custom FEX-derived native ARM64 xtajit.dll provider.
  • Wine-managed 32-bit guest addressing, PEB32/TEB32, syscall and Unix-call pointer conversion, TLS, contexts, SEH, APCs, callbacks, and multithread lifecycle support.
  • Darwin 16 KiB page-aware W^X handling, executable-code invalidation, and managed/JIT runtime support.
  • Native ARM64 Unix bridges for every guest architecture; no i386 or x86_64 Mach-O bridge is required.

The runtime does not require Rosetta or Apple's optional hardware TSO mode. x86 memory ordering is preserved in software with ARM64 acquire/release operations, barriers, and acquire/release atomics. All FEX TSO toggles are disabled in the packaged configuration.

Performance Runtime

  • P7/P8 architecture-transition classification and persistent FEX code caches.
  • Bounded shared-image caching, precise exception state, and stable safe-point and teardown behavior for x86_64 and i386/WoW64.
  • Deduplicated WoW64 executable-memory invalidation and batched Vulkan host procedure discovery.
  • Versioned per-prefix cache generations for DXVK, vkd3d-proton, DXMT, MetalSharp, Metal, and XDG, with automatic invalidation when runtime inputs change.
  • Native ARM64 hot-set prefetch helper and a bounded all-architecture manifest containing 222 entries and 211,225,570 bytes, staged during prefix setup.
  • Accepted P8 result: 0.791952 GB/s physical throughput, 1.908866 GB/s effective warm-start throughput, 0.990010 GB/s including the 100 ms overlap, and a 58.41% reduction in attributed cold-start stalls.
  • The P8 helper, manifest, source, validation evidence, provider staging, and environment integration are included in this package; P8 is not an external overlay.

Graphics

Vulkan and MoltenVK

  • Patched MoltenVK 1.4.2 with pinned Vulkan ICD selection.
  • Vulkan portability enumeration, Vulkan 1.3, dynamic rendering, synchronization2, maintenance4, buffer-device-address, robustness, and other features required by the Direct3D translation layers.
  • Native ARM64 Vulkan host paths for AArch64, ARM64EC/x86_64, and i386/WoW64 guests.

Direct3D: DXVK and vkd3d-proton

  • DXVK 3.0.2 final DLLs for AArch64, ARM64EC, x86_64, and i386.
  • D3D9 DLL loading, adapter enumeration, Apple M4 selection, and capability queries across all four guest modes.
  • D3D11/DXGI device creation, offscreen clears, copies, and deterministic CPU readback.
  • vkd3d-proton 3.1.0 d3d12.dll and d3d12core.dll for all four guest architectures.
  • D3D12 device creation, direct queues, resources, state transitions, upload/default/readback copies, fences, CPU waits, and deterministic readback.
  • Custom handling for MoltenVK's optional extension boundaries and architecture-correct PE-to-native-ARM64 routing.

D3D9 validation covers DLL loading, adapter selection, and capabilities. It does not claim device rendering or presentation.

DXMT and Winemetal

  • DXMT 0.80 D3D11/DXGI stack, Arm64 Translated
  • ARM64EC and i386 PE stages paired with native ARM64 winemetal.so.
  • Relocatable ARM64 libunwind.1.dylib closure.
  • Coverage for WMTCopyAllDevices, native bridge loading, DXGI imports, and factory creation/release.

OpenGL to Metal

  • Multi-architecture Wine opengl32.dll integration.
  • Native ARM64 MetalSharp OpenGL sidecar with pinned glslang and SPIRV-Cross.
  • WGL loading, pixel formats, contexts, Metal renderer identity, framebuffer clear/readback, and GLSL 1.20 drawing on all four guest architectures.
  • Opt-in GLSL 3.30 and 4.50 translation through SPIR-V, Metal Shading Language, Metal pipelines, and deterministic readback.

The modern OpenGL path validates the documented translated draw/readback surface; it is not a claim of complete OpenGL 4.x conformance.

Synchronization and Process Lifecycle

  • Toggleable Mach-semaphore MSync.
  • Events, semaphores, mutexes, wait-all, signal-and-wait, APCs, abandonment, named cross-process events, and second-thread coverage.
  • Exact per-prefix wineserver shutdown and disposable-prefix cleanup.
  • Canonical provider hashes and staging checks prevent wineboot from restoring stale xtajit.dll or xtajit64.dll providers.

SDL, Input, and Controllers

  • SDL2 2.32.10 and SDL3 3.4.10 DLLs for AArch64, ARM64EC, x86_64, and i386.
  • Relocatable native ARM64 SDL2 provider with Wine winebus integration.
  • Dummy audio/video initialization, hidden windows, software-surface clear/readback, events, dynamic loading, second threads, and clean shutdown.
  • XInput DLL families, DirectInput, and DirectInput8.
  • Controller enumeration, normalized state, axes, force-feedback capability, vibration calls, keyboard, and mouse support across all guest modes.
  • Duplicate raw-HID suppression for controllers also exposed through SDL/IOHID.

Audio, Media, and Windows Libraries

  • XAudio2, XACT, FAudio, and XNA/FNA compatibility assets.
  • D3DCompiler.
  • UCRT, Visual C++, and ATL runtime components.
  • MSXML, Quartz, Media Foundation, MIDI, WineGStreamer, and Windows codecs.
  • Native ARM64 GStreamer/FFmpeg closure with staged plugins and codecs.

Not included: legacy D3DX9/10/11 redistributable payloads, MFC, OpenAL, PhysX, or additional core-font packs.

Fonts, Networking, and TLS

  • Source-built, relocatable FreeType, libpng, HarfBuzz, Pango, and related text/font dependencies.
  • Complete Wine 11.12 font and NLS data used by the build, including Tahoma, Webdings, Wingdings, Symbol, Marlett, locale and normalization tables, code pages, and ICU data.
  • All 90 former build-tree symlinks are package-relative
  • Native ARM64 GnuTLS closure, including nettle, GMP, p11-kit, gettext, IDN, and related libraries.
  • OpenSSL libraries used by the packaged multimedia/network closure.
  • Schannel, WinHTTP, WinINet, HTTPS, sockets, DNS, and TLS support.
  • No required Homebrew runtime path in the audited packaged Mach-O closure.

Browser and Web Compatibility

  • Wine Gecko 2.47.4 packages for Gecko/MSHTML and both registry views.
  • Gecko-backed document creation, JavaScript, DOM, events, HTTPS, and the required i386 socket/time/TLS path.
  • Wine/provider compatibility work for CEF subprocesses, WebView2 fixed-runtime bootstrap, Electron renderer/GPU/utility processes, HTTPS, input, audio, pixels, and teardown.

External CEF, WebView2, and Electron application/runtime distributions are not duplicated in this archive.

Installers and Deployment

  • MSI/Windows Installer and WiX lifecycle support: install, execute, repair/reinstall, uninstall, and cleanup.
  • NSIS i386 installer/uninstaller support, including the conventional 0x400000 image-base reservation required by relocation-stripped installers.
  • Native ARM64 innoextract closure and i386 Inno Setup compatibility.
  • Runtime recognition for MSI/WiX, NSIS, Inno, Burn, InstallShield, Squirrel, ClickOnce, MSIX, and AppX packages.

Managed Runtimes and Java

Wine Mono

  • Official Wine Mono 11.2.0 packages.
  • x86, x86_64, and targeted native ARM64 CoreEE/W^X integration.
  • Direct i386 and native ARM64 CLR startup, plus x86_64 PE32+ IL-only execution through the native ARM64 CLR contract.
  • Threads, reflection, XML, P/Invoke, pointer-width, and shutdown coverage.

Included Windows Java Runtimes

  • Temurin 8u492-b09 Windows x86_64 JRE with Server VM.
  • Temurin 8u472-b08 Windows i386 JRE with Client VM.
  • Complete java.exe, JVM DLLs, Java libraries, CRT dependencies, AWT, networking, TLS, sound, JNI, and runtime resources for both modes.
  • Coverage for interpreted and JIT execution, JNI callbacks and attached threads, class loading, reflection, JARs, buffers, garbage collection, monitors, wait/notify, atomics, sockets, TLS, code-cache invalidation, exceptions, and repeated lifecycles.

The private Oracle JRE 8u501 native ARM64 runtime is not redistributed. Its manifest is retained, but the Oracle binaries and DMG are not release assets.

Steam and MetalSharp Integration

  • MetalSharp-compatible Steam WebHelper wrapper source and executable.
  • Runtime environment and provider-staging helpers.
  • Steam launch and handoff assets retained for MetalSharp packaging.

This archive is not a preconfigured Steam installation or a MetalSharp application DMG.

Existing-Install Migration

  • The 0.60 updater replaces the runtime in place while preserving Steam, bottles, settings, cover/API metadata, logs, shader caches, games, Sharp Library data, and custom Wine drive mappings.
  • Existing prefixes receive native ARM64 Wine and are accepted only after their AArch64, ARM64EC, x86_64, and i386 provider surfaces are complete.
  • i386 is pinned to xtajit.dll; competing wow64cpu.dll and development candidate providers are not staged into user prefixes.
  • The packaged ARM64 win32u.so bounds macOS dyld EGL diagnostics so a missing optional EGL library cannot overflow Wine's debug buffer during migration or startup. Wine then uses its platform OpenGL fallback.

Archive Contents

Directory Contents
wine/ Complete authoritative Wine build
graphics/ DXVK, vkd3d-proton, DXMT/Winemetal, OpenGL/Metal, and MoltenVK
dependencies/ Gecko, Mono, GStreamer, GnuTLS, FreeType, and related closures
providers/ Canonical ARM64 and ARM64EC execution providers
scripts/ Runtime environment, staging, and launch helpers
integration/ MetalSharp and Steam integration assets
source/ Unencrypted public source snapshot, exact licenses, provenance records, and reproducible per-file hashes
metadata/ Provenance, per-file hashes, architecture counts, and Mach-O dependency audits

Licensing

MetalSharp-owned code in source/ is offered under PolyForm Noncommercial 1.0.0. Its exact boundaries are documented in SOURCE-LICENSE-SCOPE.md.

Wine, FEX, DXMT, MoltenVK, DXVK, vkd3d-proton, and all other third-party projects retain their original upstream licenses. PolyForm does not replace or restrict those licenses.