编译与打包

方式一：内置 build.bat（推荐）

在 StudioModFramework 根目录运行：

cmd

cd "C:\Program Files\Studio 2.0\StudioModFramework"
build.bat

脚本使用系统内置的 Roslyn/C# 编译器 csc.exe，自动链接 Studio 运行库与依赖，一键生成：

bin/StudioSDK.dll
bin/StudioModLoader.dll
StudioInstaller.exe

方式二：Visual Studio 解决方案

打开根目录的 StudioModFramework.sln，选择 Debug | x64 或 Release | x64，执行「生成解决方案」。

需要安装 Visual Studio 的 .NET 桌面开发工作负载及 .NET Framework 4.7.2 开发组件，并在本机安装 Studio 2.0。

解决方案包含三个项目：

项目	内容
`StudioSDK`	插件接口、配置管理与 `StudioAPI`
`StudioModLoader`	启动引导、插件加载、菜单与调试控制台（引用 `StudioSDK`）
`StudioInstaller`	框架安装与卸载工具

SDK 和加载器引用 Studio 自带程序集，默认从 C:\Program Files\Studio 2.0\Studio_Data\Managed 查找，兼容 Program Files (x86) 安装目录。Harmony 等依赖来自仓库的 deps/；WebView2 宿主首次构建时从官方 NuGet 下载固定版本 SDK。

指定 Studio 安装位置

Studio 装在别处时，在根目录新建 Directory.Build.props.user（该文件不纳入 Git）：

xml

<Project>
  <PropertyGroup>
    <StudioManagedDir>D:\Studio 2.0\Studio_Data\Managed</StudioManagedDir>
  </PropertyGroup>
</Project>

或在 Visual Studio Developer Command Prompt 中直接指定：

cmd

msbuild StudioModFramework.sln /p:Configuration=Release /p:Platform=x64 /p:StudioManagedDir="D:\Studio 2.0\Studio_Data\Managed"

产物位置

两种构建方式产物一致：SDK 与加载器位于 bin/，同时复制到根目录；安装器位于根目录。

构建不会执行安装器

build.bat / msbuild 只负责产出文件。要装进 Studio 需要单独运行 StudioInstaller.exe，见安装与部署。

插件安装与分发

编译出的 YourMod.dll 放入以下任一路径即可被自动加载：

全局目录：C:\Program Files\Studio 2.0\Mods\
用户目录：%LOCALAPPDATA%\Studio 2.0\Mods\

支持子目录组织（如 Mods/YourMod/YourMod.dll），支持伴随依赖 DLL 自动解析。

其他构建脚本

Framework 目录下还提供：

脚本	用途
`build-loader.ps1`	只构建 Loader
`build-updater.ps1`	构建自动更新宿主（NetSparkle，需要 .NET SDK）
`build-webview2.ps1`	构建 WebView2 弹窗宿主

编译与打包 ​

方式一：内置 build.bat（推荐） ​

方式二：Visual Studio 解决方案 ​

指定 Studio 安装位置 ​

产物位置 ​

插件安装与分发 ​