如何从源码编译AudioBand？.NET Framework开发者环境搭建完整指南

【免费下载链接】audio-band Display and control songs from the Windows taskbar 项目地址: https://gitcode.com/gh_mirrors/au/audio-band

AudioBand 是一款可以在 Windows 任务栏直接显示和控制歌曲的开源音乐工具，让你无需切换窗口就能查看专辑封面、歌曲名、艺术家和播放进度。如果你是一位 .NET Framework 开发者，想从源码编译 AudioBand、深入理解它的架构，甚至定制属于自己的任务栏音乐控制插件，那么这篇完整的开发环境搭建指南正是你需要的。本文将从环境准备、源码获取、编译配置到 COM 注册，一步步带你完成整个编译流程。

🎵 什么是 AudioBand？

简单来说，AudioBand 是一个任务栏 Deskband 工具：它把音乐信息“塞进”Windows 任务栏，在播放音乐时显示专辑封面、歌曲信息与进度条，并直接提供播放/暂停、上一曲/下一曲等控制按钮，界面高度可定制，支持深色/浅色主题。

它通过插件（AudioSource）机制对接不同的音乐播放器，官方内置了 Spotify、iTunes、MusicBee 三种支持，开发者也可以按照插件接口编写自己的音频源。

🛠️ 编译前需要准备哪些开发环境？

AudioBand 基于 WPF + .NET Framework 4.7 开发，属于典型的 Windows 桌面应用，因此对开发环境有明确要求。下表是推荐的环境清单：

组件	版本要求	用途
操作系统	Windows 10 / 11（64 位）	任务栏 Deskband 依赖 Windows 桌面
Visual Studio	2019（16.x）及以上	打开解决方案并编译
.NET Framework	4.7 开发包（随 VS 安装）	项目目标框架，见 AudioBand.csproj
NuGet	VS 自带	还原 MahApps.Metro、FluentWPF 等依赖包
WiX Toolset	v3.11 及以上（可选）	仅编译安装包时需要

💡 小提示：如果只是想编译主程序而不做安装包，WiX Toolset 可以不装；但打开解决方案时若包含 AudioBandInstaller 项目，VS 可能会提示缺少工具集，忽略它即可，不影响主项目编译。

📦 第一步：获取 AudioBand 源码

在本地任意目录打开命令行，使用 git 克隆仓库：

git clone https://gitcode.com/gh_mirrors/au/audio-band

克隆完成后，你会看到 src 目录下放着解决方案文件 AudioBand.sln，所有工程均位于其中。

🚀 第二步：打开解决方案并还原依赖

用 Visual Studio 2019 打开 src/AudioBand.sln，首次加载会自动触发 NuGet 还原。也可以手动执行还原以确保依赖完整。

解决方案共包含 8 个工程，分工如下：

• AudioBand：主程序（WPF Deskband 实现）
• AudioBand.AudioSource：音频源插件接口定义
• SpotifyAudioSource / iTunesAudioSource / MusicBeeAudioSource：三种播放器插件
• AudioSourceHost：插件宿主进程
• AudioBand.Logging：日志组件
• AudioBand.Test：单元测试（基于 xUnit）
• AudioBandInstaller：WiX 安装包工程

还原成功后，在解决方案资源管理器中右键解决方案，选择“生成解决方案”即可完成首次编译。

⚙️ 第三步：选择正确的编译配置

AudioBand 提供了多种编译配置组合（Debug/Release/Test × Any CPU/x64），首次编译建议按需选择：

• Release | x64：发布版，适合日常使用与最终分发
• Debug | Any CPU：调试版，方便单步跟踪代码

⚠️ 特别注意：主项目在 Debug 配置下定义了构建前后事件——编译前会强制结束 explorer.exe 进程，编译完成后自动重启（见 AudioBand.csproj 中的 PreBuildEvent/PostBuildEvent）。这是因为调试 Deskband 需要卸载任务栏控件，期间桌面图标和任务栏会短暂消失，属正常现象，不必惊慌。

📁 第四步：编译产物在哪里？

编译完成后，主程序输出位于 src/AudioBand/bin/Release/（或 bin/Debug/）目录，核心产物为：

• AudioBand.dll：任务栏 Deskband 本体（COM 组件）
• AudioSourceHost.exe 及相关 DLL：插件宿主
• 各 AudioSources 子目录：Spotify、iTunes、MusicBee 插件

🔧 第五步：注册并运行编译结果

Deskband 本质上是一个 COM 组件，编译产物不能直接双击运行，需要先注册。项目在 tools 目录下提供了现成脚本：

• 注册：install.cmd（内部调用 regasm /codebase 注册 AudioBand.dll）
• 卸载：uninstall.cmd

以管理员身份执行 install.cmd 完成注册后，右键任务栏 → 工具栏 → 勾选 AudioBand，即可看到音乐控制条出现在任务栏中。

🔍 深入理解 AudioBand 的项目结构

如果你是开发者，想进一步研究代码，这几个文件值得优先阅读：

• AudioBandToolbar.xaml：任务栏工具栏的主界面布局
• TaskbarHook.cs：任务栏钩子与 Deskband 生命周期管理
• IAudioSource.cs：音频源插件接口，写自己的插件从这里开始
• AudioSourceManager.cs：插件加载与管理
• Settings/Migrations：配置版本迁移逻辑，理解设置兼容性设计的好材料

❓ 常见问题与解决技巧

1. 编译时提示找不到 WiX 工具集：安装 WiX Toolset v3.11+，或在解决方案中卸载 AudioBandInstaller 工程再编译。
2. 任务栏不显示 AudioBand：确认以管理员身份运行过注册脚本，且构建的是 x64 版本（Deskband 对位数敏感）。
3. 调试时任务栏频繁闪烁：这是 Debug 构建重启 explorer 的正常行为，改用 Release 配置即可避免。
4. 想改界面主题：主题资源集中在 UI/Resources/Theming 目录，修改后重新编译即可生效。

🏁 小结

从源码编译 AudioBand 并不复杂：准备好 Visual Studio 2019 与 .NET Framework 4.7 环境、克隆源码、还原依赖、选对配置编译，最后通过 tools/install.cmd 完成 COM 注册即可在任务栏中使用。整个过程不仅能让你用上自己编译的版本，还能借此深入理解 WPF Deskband 的完整开发流程。希望这份 .NET Framework 开发者环境搭建指南能帮你顺利跑通第一步，玩转你的任务栏音乐控制工具！

【免费下载链接】audio-band Display and control songs from the Windows taskbar 项目地址: https://gitcode.com/gh_mirrors/au/audio-band