HippoPlayer 项目下载及安装教程

1. 项目介绍

HippoPlayer 是一个现代化的音乐播放器，专为满足旧式音乐需求而设计。它支持多种音乐格式，包括 Amiga、C64 和游戏系统等旧式音乐格式。尽管 HippoPlayer 也支持 MP3、FLAC、Ogg Vorbis 等现代格式，但其主要目标是提供对旧式音乐格式的最佳支持。HippoPlayer 的目标是提供一个现代化的用户界面，同时保留旧式音乐播放器的经典功能。

2. 项目下载位置

HippoPlayer 项目的源代码托管在 GitHub 上。你可以通过以下步骤下载项目：

1. 打开终端或命令提示符。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/HippoPlayer/HippoPlayer.git
   

3. 进入项目目录：

   cd HippoPlayer
   

3. 项目安装环境配置

3.1 系统要求

HippoPlayer 支持 macOS、Windows 和 Linux 系统。以下是各平台的安装环境配置要求：

3.1.1 Linux

• Rust 1.20+: 使用 rustup 安装最新版本的 Rust。
• Tundra: 用于构建项目的构建系统。
• Qt 5.15: 用于用户界面的开发框架。

3.1.2 macOS

• Rust 1.20+: 使用 rustup 安装最新版本的 Rust。
• Qt 5.15: 使用 Homebrew 或从 Qt 官方网站下载并安装。

3.1.3 Windows

• Rust 1.20+: 使用 rustup 安装最新版本的 Rust。
• Qt 5.15: 从 Qt 官方网站下载并安装。
• Visual Studio 2019: 社区版即可，但专业版和企业版也可以。

3.2 环境变量配置

在安装 Qt 后，需要设置以下环境变量：

3.2.1 Linux 和 macOS

export QT5_BIN=$Qt5_DIR/bin
export QT5_INC=$Qt5_DIR/include
export QT5_LIB=$Qt5_DIR/lib

3.2.2 Windows

set QT5_BIN=c:\path\to\qt\5.15.0\msvc2017_64\bin
set QT5_LIB=c:\path\to\qt\5.15.0\msvc2017_64\lib
set QT5_INC=c:\path\to\qt\5.15.0\msvc2017_64\include

4. 项目安装方式

4.1 Linux

1. 安装 Tundra：

   git clone --recursive https://github.com/deplinenoise/tundra.git && cd tundra && make -j2 && sudo make install && cd .. && rm -rfv tundra
   

2. 运行构建脚本：

   scripts/linux_build_debug.sh
   

3. 运行 HippoPlayer：

   t2-output/linux-gcc-debug-default/hippo_player
   

4.2 macOS

1. 下载并安装 Qt 5.15。

2. 运行构建脚本：

   scripts/mac_build_debug.sh
   

3. 运行 HippoPlayer：

   t2-output/macosx-clang-debug-default/hippo_player
   

4.3 Windows

1. 下载并安装 Qt 5.15 和 Visual Studio 2019。

2. 运行构建脚本：

   scripts\win64_build_debug.cmd
   

3. 如果遇到“missing symbol”错误，运行以下脚本：

   scripts\win64_copy_bins.cmd
   

4. 运行 HippoPlayer：

   t2-output\win64-msvc-debug-default\hippo_player
   

5. 项目处理脚本

HippoPlayer 项目提供了多个脚本来简化构建和运行过程：

• Linux: scripts/linux_build_debug.sh
• macOS: scripts/mac_build_debug.sh
• Windows: scripts\win64_build_debug.cmd

这些脚本会自动处理项目的构建过程，并生成可执行文件。

总结

通过以上步骤，你可以成功下载并安装 HippoPlayer 项目。根据你的操作系统，按照相应的环境配置和安装步骤进行操作，即可体验这个现代化的旧式音乐播放器。