Skip to content

developer-runtime.md

Latest commit

 

History

History
73 lines (59 loc) · 2.21 KB

developer-runtime.md

File metadata and controls

73 lines (59 loc) · 2.21 KB
Raw

D3D12 Developer Runtime Package

metalsharp-d3d12-developer-sdk.tar.zst is the portable developer package for D3D12 to Metal runtime work. It keeps contracts, probes, scripts, docs, and a ready staged Wine/DXMT runtime in one archive.

Layout

developer-sdk/d3d12/
  README.md
  contracts/
  docs/
  probes/
  scripts/
  runtime/
    wine/
    dxmt/
      x86_64-windows/
      x86_64-unix/
    host/
    metalsharp-backend
    manifest.json

The runtime files are generated from release bundle inputs. They are not stored directly in git.

Platform Posture

  • macOS: the package includes the MetalSharp Wine runtime, DXMT DLLs, and Winemetal bridge needed for Apple Silicon D3D12 probe work.
  • Linux: contracts, probes, and scripts are portable. Use a local Wine runtime with --wine, --prefix, and --dxmt-runtime when investigating non-Metal loader behavior.
  • Windows: probe sources, contracts, and PowerShell environment helpers are included. Native Windows does not use Wine, but the sources are useful for compiling reference probes and comparing export contracts.

Quick Start

tar --use-compress-program=unzstd -xf metalsharp-d3d12-developer-sdk.tar.zst
cd developer-sdk/d3d12
source scripts/sdk-env.sh
scripts/preflight-runtime-layout.py --dxmt-runtime "$METALSHARP_DXMT_RUNTIME"
scripts/run-probes.sh --wine "$WINE" --prefix "$WINEPREFIX" --dxmt-runtime "$METALSHARP_DXMT_RUNTIME" --mini-only

PowerShell users can initialize equivalent environment variables with:

.\scripts\sdk-env.ps1

Rebuild And Publish

The CI release flow rebuilds this package from the current repository SDK source plus the released runtime and graphics split bundles:

tools/dmg/create-bundles.sh
tools/bundles/create-developer-sdk.py \
  --bundle-dir app/bundles \
  --out-dir dist/developer-sdk \
  --manifest dist/bundles/metalsharp-bundle-manifest.tsv
tools/bundles/verify-developer-sdk.sh \
  dist/developer-sdk/metalsharp-d3d12-developer-sdk.tar.zst

On main and version tags, CI uploads the refreshed SDK tarball and updated bundle manifest back to the bundles release with --clobber. The DMG build then downloads that refreshed SDK instead of repackaging a stale tarball.