Strawberry音乐播放器在macOS系统下的Homebrew编译指南

环境准备

在macOS系统上使用Homebrew编译Strawberry音乐播放器前，需要确保系统环境配置正确。首先需要安装Xcode命令行工具和Homebrew包管理器：

1. 安装Xcode命令行工具：

   xcode-select --install
   

2. 安装Homebrew：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

依赖安装

Strawberry音乐播放器依赖于多个开发库和框架，需要通过Homebrew安装以下软件包：

brew install pkg-config cmake ninja meson bison flex wget create-dmg gettext boost protobuf protobuf-c
brew install glib glib-openssl glib-networking gdk-pixbuf gobject-introspection orc
brew install libffi openssl sqlite fftw libmtp libplist libxml2 libsoup
brew install libogg libvorbis flac wavpack opus speex mpg123 lame twolame taglib chromaprint libebur128 libbs2b libcdio libopenmpt faad2 faac fdk-aac musepack game-music-emu
brew install qt6 gstreamer

环境变量配置

为确保编译过程中能够正确找到相关库文件，需要设置以下环境变量：

export GIO_EXTRA_MODULES=$(brew --prefix)/lib/gio/modules
export GST_PLUGIN_SCANNER=$(brew --prefix)/opt/gstreamer/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=$(brew --prefix)/lib/gstreamer-1.0

源码获取与编译准备

1. 创建并进入构建目录：

   mkdir -p ~/build
   cd ~/build
   

2. 克隆Strawberry源码仓库：

   git clone --recursive https://github.com/strawberrymusicplayer/strawberry
   cd strawberry
   mkdir build
   cd build
   

编译配置

根据处理器架构不同，配置参数略有差异：

Intel x86_64架构

cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH=$(brew --prefix)/opt/qt6/lib/cmake \
-DBUILD_WITH_QT6=ON \
-DUSE_BUNDLE=ON \
-DENABLE_SPARKLE=OFF \
-DICU_ROOT=$(brew --prefix)/opt/icu4c \
-DPROTOBUF_INCLUDE_DIRS=$(brew --prefix)/include \
-DENABLE_DBUS=OFF

Apple Silicon架构

cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH=$(brew --prefix)/opt/qt6/lib/cmake \
-DBUILD_WITH_QT6=ON \
-DUSE_BUNDLE=ON \
-DENABLE_SPARKLE=OFF \
-DICU_ROOT=$(brew --prefix)/opt/icu4c \
-DPROTOBUF_INCLUDE_DIRS=$(brew --prefix)/include

编译与安装

执行以下命令开始编译和安装：

make -j 4
make install

问题修复

编译完成后，需要移除一些可能导致问题的插件：

sudo rm -rf $(brew --prefix)/opt/qt6/share/qt/plugins/virtualkeyboard \
$(brew --prefix)/opt/qt6/share/qt/plugins/platforminputcontexts
sudo rm -f $(brew --prefix)/Cellar/qt/*/share/qt/plugins/imageformats/libqpdf.dylib

手动文件复制

由于运行时依赖关系，需要手动复制libsoup库：

mkdir -p strawberry.app/Contents/Frameworks
cp $(brew --prefix)/lib/libsoup-3.0.0.dylib strawberry.app/Contents/Frameworks/

应用部署

完成上述步骤后，可以执行部署命令：

make deploy

部署验证

验证所有库文件是否正确部署：

make deploycheck

创建安装包

最后，可以创建DMG安装包：

make dmg

安装说明

生成的DMG文件可以直接拖拽安装到Applications目录，或者手动将strawberry.app复制到/Applications/目录下。

注意事项

1. 使用Homebrew编译可能存在部分gstreamer插件缺失的问题
2. 官方不提供对Homebrew编译方式的技术支持
3. 建议考虑使用官方提供的签名二进制版本以获得最佳体验