FFmpegFreeUI.Ext.PluginSdk 2.4.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package FFmpegFreeUI.Ext.PluginSdk --version 2.4.0
                    
NuGet\Install-Package FFmpegFreeUI.Ext.PluginSdk -Version 2.4.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FFmpegFreeUI.Ext.PluginSdk" Version="2.4.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FFmpegFreeUI.Ext.PluginSdk" Version="2.4.0" />
                    
Directory.Packages.props
<PackageReference Include="FFmpegFreeUI.Ext.PluginSdk" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FFmpegFreeUI.Ext.PluginSdk --version 2.4.0
                    
#r "nuget: FFmpegFreeUI.Ext.PluginSdk, 2.4.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package FFmpegFreeUI.Ext.PluginSdk@2.4.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FFmpegFreeUI.Ext.PluginSdk&version=2.4.0
                    
Install as a Cake Addin
#tool nuget:?package=FFmpegFreeUI.Ext.PluginSdk&version=2.4.0
                    
Install as a Cake Tool

FFmpegFreeUI Ext Plugin SDK

这是 FFmpegFreeUI API Extended Edition 的 Ext Plugin API 编译期合同包。插件只需引用本 SDK,不要引用 FFmpegFreeUI.exe 或 FFmpegFreeUI.Ext.PluginHost.dll。

SDK 已发布到 NuGet.org。在插件项目目录执行:

dotnet add package FFmpegFreeUI.Ext.PluginSdk --version 2.4.0

然后确认插件项目至少包含:

<PropertyGroup>
  <TargetFramework>net10.0-windows10.0.17763.0</TargetFramework>
  <UseWindowsForms>true</UseWindowsForms>
  <AssemblyName>MyCompany.MyPlugin.3fui</AssemblyName>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="FFmpegFreeUI.Ext.PluginSdk"
                    Version="2.4.0"
                    PrivateAssets="all"
                    ExcludeAssets="runtime" />
</ItemGroup>

PrivateAssets="all" 避免 SDK 成为传递依赖,ExcludeAssets="runtime" 避免把 SDK 私有副本复制进插件输出。包内同时包含 XML API 文档和通过 buildTransitive 自动导入的一键部署目标。

v2.4 新增三套独立能力:host.PageEntries.RegisterPage(...) 可以相对左侧主导航或参数面板一级选项卡插入任意数量的页面;host.EncodingQueueToolbar.RegisterControl(...) 可以相对编码队列顶部任意原生按钮插入自定义 WinForms 控件;host.PluginSettings.RegisterPage(...) 可以只在插件管理器中提供一个设置页,不占用主导航。具体目标 ID、页面生命周期和示例见完整开发指南。

可以为当前 PowerShell 会话配置 FFmpegFreeUI 根目录:

$env:EXT_FFMPEGFREEUI_INSTALL_DIR = "D:\Apps\FFmpegFreeUI-API-Extended-Edition"

也可以写入当前用户环境变量,供以后打开的 IDE 和终端使用:

[Environment]::SetEnvironmentVariable(
  "EXT_FFMPEGFREEUI_INSTALL_DIR",
  "D:\Apps\FFmpegFreeUI-API-Extended-Edition",
  "User")

重新打开 IDE 或终端后,执行:

dotnet build -c Debug -t:ExtDeployFFmpegFreeUIPlugin

也可以不设置环境变量,按次指定目标目录:

dotnet build -c Release -t:ExtDeployFFmpegFreeUIPlugin `
  -p:ExtFFmpegFreeUIInstallDir="D:\Apps\FFmpegFreeUI-API-Extended-Edition"

目标会还原并编译插件,把 *.3fui.dll、可复制依赖以及 Debug 符号增量复制到 FFmpegFreeUI 的 Plugin 目录;不会清空该目录,也不会部署 SDK、PluginHost、主程序或 LakeUI 的私有副本。部署前请完全退出 FFmpegFreeUI,以免 DLL 被占用。

完整开发环境、部署约定和 API 说明见 Ext Plugin API v2 中文开发指南。

Product Compatible and additional computed target framework versions.
.NET net10.0-windows10.0.17763 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0-windows10.0.17763

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.5.0 96 8/27/2026
2.4.0 98 8/24/2026
2.3.0 101 8/20/2026