Astrobot - Canonicalize fix and ffmpeg library on build (#817)

This commit is contained in:
Astell
2026-08-10 23:36:12 +02:00
committed by GitHub
parent 498d402577
commit 1e96eca316
3 changed files with 46 additions and 19 deletions
+19 -15
View File
@@ -47,24 +47,28 @@ built against `ffmpeg-core` specifically.
## Supplying the FFmpeg libraries
`dotnet publish` fetches a prebuilt release of `github.com/sharpemu/ffmpeg-core`
(the tag is pinned in `SharpEmu.CLI.csproj`'s `FfmpegRuntimeTag`, matched to
the `FFmpeg.AutoGen` package version in `Directory.Packages.props` -- both
need to agree on the same FFmpeg ABI) and copies its dynamically linked
libraries into a `plugins` folder next to the published executable. No C
toolchain is required to build SharpEmu; publishing just downloads a zip.
`plugins` is a loose, unpacked folder rather than something embedded in the
single-file bundle, so the OS loader can resolve the libraries' own
inter-dependencies (`avcodec` depends on `avutil`, etc.) itself.
Both `dotnet build` and `dotnet publish` fetch a prebuilt release of
`github.com/sharpemu/ffmpeg-core` (the tag is pinned in
`SharpEmu.CLI.csproj`'s `FfmpegRuntimeTag`, matched to the `FFmpeg.AutoGen`
package version in `Directory.Packages.props` -- both need to agree on the
same FFmpeg ABI) and copy its dynamically linked libraries into a `plugins`
folder next to the resulting executable (`artifacts/bin/...` for build,
`artifacts/publish/...` for publish). No C toolchain is required to build
SharpEmu; both just download a zip once (cached under
`$(BaseIntermediateOutputPath)ffmpeg-runtime/`, so later builds/publishes
reuse it instead of re-fetching). `plugins` is a loose, unpacked folder
rather than something embedded in the single-file bundle, so the OS loader
can resolve the libraries' own inter-dependencies (`avcodec` depends on
`avutil`, etc.) itself.
A plain `dotnet publish` with no `-r` still works: it defaults to the host
machine's own RID (see `Directory.Build.props`), so it fetches the matching
`ffmpeg-core` archive and populates `plugins` without any extra flags.
Passing an explicit `-r <rid>` (e.g. to cross-publish `linux-x64` from
A plain `dotnet build`/`dotnet publish` with no `-r` still works: it defaults
to the host machine's own RID (see `Directory.Build.props`), so it fetches
the matching `ffmpeg-core` archive and populates `plugins` without any extra
flags. Passing an explicit `-r <rid>` (e.g. to cross-publish `linux-x64` from
Windows) still overrides that default normally.
To use a different set of FFmpeg libraries, drop them into the published
`plugins` folder yourself (matching FFmpeg's own file-naming and versioning
To use a different set of FFmpeg libraries, drop them into the build or
published `plugins` folder yourself (matching FFmpeg's own file-naming and versioning
conventions, e.g. `avformat-61.dll` / `libavformat.so.61` / matching
`.dylib`) -- `FfmpegNativeBinkFrameSource` points `ffmpeg.RootPath` at that
folder and does not otherwise care where the files came from.
+20 -1
View File
@@ -130,7 +130,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
</PropertyGroup>
<Target Name="FetchFfmpegRuntime"
BeforeTargets="Publish"
BeforeTargets="Publish;Build"
Condition="'$(RuntimeIdentifier)' != '' And '$(FfmpegRuntimePackage)' != ''">
<DownloadFile
SourceUrl="https://github.com/sharpemu/ffmpeg-core/releases/download/$(FfmpegRuntimeTag)/$(FfmpegRuntimePackage)"
@@ -161,4 +161,23 @@ SPDX-License-Identifier: GPL-2.0-or-later
SkipUnchangedFiles="true" />
</Target>
<!-- Mirrors PublishFfmpegRuntime for plain `dotnet build`: devs running
straight out of the build output directory (no publish step) still
need the FFmpeg plugins present, otherwise AvPlayer/Bink video probing
throws NotSupportedException the first time a guest opens a movie. -->
<Target Name="BuildFfmpegRuntime"
AfterTargets="Build"
DependsOnTargets="FetchFfmpegRuntime"
Condition="'$(RuntimeIdentifier)' != '' And '$(FfmpegRuntimePackage)' != ''">
<ItemGroup>
<_FfmpegRuntimeFiles Condition="$(RuntimeIdentifier.StartsWith('win'))"
Include="$(FfmpegRuntimeExtractDir)/bin/*.dll" />
<_FfmpegRuntimeFiles Condition="!$(RuntimeIdentifier.StartsWith('win'))"
Include="$(FfmpegRuntimeExtractDir)/lib/*.so;$(FfmpegRuntimeExtractDir)/lib/*.so.*;$(FfmpegRuntimeExtractDir)/lib/*.dylib" />
</ItemGroup>
<Copy SourceFiles="@(_FfmpegRuntimeFiles)"
DestinationFolder="$(OutDir)$(NativeLibraryFolderName)"
SkipUnchangedFiles="true" />
</Target>
</Project>
+7 -3
View File
@@ -60,9 +60,7 @@ internal static class GpuWaitRegistry
// address) so distinct guest processes never alias.
private static readonly Dictionary<(object, ulong), ulong> _lastProduced = new();
// Unwraps to the shared root: per-thread TrackedCpuMemory decorators
// over ONE virtual memory are not reference-equal, so a raw-reference
// filter would make waits invisible across threads.
private static object? Canonicalize(object? memory)
{
while (memory is SharpEmu.HLE.ICpuMemoryWrapper wrapper)
@@ -120,6 +118,7 @@ internal static class GpuWaitRegistry
/// </summary>
public static OutstandingSnapshot SnapshotOutstanding(object? memory = null)
{
memory = Canonicalize(memory);
lock (_gate)
{
var outstanding = 0;
@@ -346,6 +345,7 @@ internal static class GpuWaitRegistry
/// </summary>
public static bool LatchSatisfiedByValue(object memory, ulong address, ulong value)
{
memory = Canonicalize(memory)!;
var latchedAny = false;
lock (_gate)
{
@@ -431,6 +431,7 @@ internal static class GpuWaitRegistry
/// </summary>
public static List<WaitingDcb>? CollectExpiredRetries(object memory, long nowTicks)
{
memory = Canonicalize(memory)!;
List<WaitingDcb>? expired = null;
lock (_gate)
{
@@ -473,6 +474,7 @@ internal static class GpuWaitRegistry
public static List<WaitingDcb>? CollectAllForMemory(object memory)
{
memory = Canonicalize(memory)!;
List<WaitingDcb>? collected = null;
lock (_gate)
{
@@ -558,6 +560,7 @@ internal static class GpuWaitRegistry
/// breaker. Also latches any already-waiting waiter it satisfies.</summary>
public static bool RecordProduced(object memory, ulong address, ulong value)
{
memory = Canonicalize(memory)!;
lock (_gate)
{
if (_lastProduced.Count >= 8192)
@@ -591,6 +594,7 @@ internal static class GpuWaitRegistry
long nowTicks,
long minAgeTicks)
{
memory = Canonicalize(memory)!;
List<WaitingDcb>? broken = null;
lock (_gate)
{