Hidamari开发环境部署全攻略：从入门到精通的双路径方案

1. 环境选型：构建策略对比与决策指南

Hidamari作为一款Linux平台的视频壁纸应用，提供两种差异化的开发环境部署方案。开发者可根据项目需求、团队协作模式及系统环境特点，选择最适合的构建路径。

1.1 传统部署方案

• 技术特性：直接基于系统环境构建，依赖系统级组件
• 核心优势：构建速度快（平均节省40%构建时间）、调试流程简化、资源占用低
• 适用场景：长期开发迭代、团队环境标准化、高性能硬件配置
• 局限：系统依赖冲突风险、跨发行版兼容性需手动处理

1.2 容器化部署方案

• 技术特性：基于Flatpak容器技术，实现环境隔离与标准化
• 核心优势：零系统污染、环境一致性高、跨平台兼容性强
• 适用场景：多项目并行开发、临时测试验证、团队协作环境复用
• 局限：首次构建耗时较长（约15-20分钟）、资源占用较高

⚠️ 决策建议：对于核心功能开发，推荐采用传统部署方案以获得更佳性能；对于环境验证或多版本测试，建议优先使用容器化方案。

2. 基础准备：环境前置条件配置

完成开发环境选型后，需进行基础系统配置与项目准备工作，为后续部署实施奠定基础。

2.1 系统环境要求

• 操作系统：Ubuntu 20.04+/Fedora 34+或其他兼容的Linux发行版
• 硬件配置：最低2GB内存，推荐4GB以上以确保流畅构建
• 网络环境：稳定的互联网连接（用于依赖下载与仓库同步）

2.2 项目获取

通过Git工具克隆项目仓库，包含完整源代码及子模块：

git clone --recurse-submodules https://gitcode.com/gh_mirrors/hi/hidamari

若已克隆仓库，可通过以下命令初始化子模块：

git submodule update --init --recursive

3. 部署实施：双路径详细操作指南

3.1 传统部署方案实施

3.1.1 系统层依赖安装

Ubuntu/Debian系系统：

sudo apt install dconf-cli libappindicator3-1 libgnome-desktop-4-1 \
libwebkit2gtk-4.1-0 libwnck-3-0 mesa-utils vdpauinfo xdg-user-dirs
# 安装核心系统库与桌面环境组件

Fedora/RHEL系系统：

sudo dnf install dconf glx-utils gnome-desktop4 libappindicator-gtk3 \
libwnck3 vdpauinfo webkit2gtk4.1 xdg-user-dirs
# 安装核心系统库与桌面环境组件

⚠️ 注意：gnome-desktop仅为库文件，不会安装完整GNOME桌面环境，无需担心系统环境变更。

3.1.2 开发工具链配置

Ubuntu/Debian系系统：

sudo apt install git meson gtk-update-icon-cache desktop-file-utils
# 安装版本控制与构建工具

Fedora/RHEL系系统：

sudo dnf install git meson gtk-update-icon-cache desktop-file-utils
# 安装版本控制与构建工具

3.1.3 Python环境配置

Python包依赖安装：

pip install -r requirements.txt
# 安装项目所需Python库

Fedora系统可选方案：

sudo dnf install python3-pillow python3-pydbus python3-requests \
python3-setproctitle python3-vlc yt-dlp
# 使用系统包管理器安装Python依赖

3.1.4 项目构建与安装

meson setup build && meson install -C build
# 生成构建配置并执行安装

3.2 容器化部署方案实施

3.2.1 容器工具链安装

基础工具安装：

sudo apt install flatpak flatpak-builder  # Ubuntu/Debian
# 或
sudo dnf install flatpak flatpak-builder  # Fedora/RHEL
# 安装Flatpak基础工具链

3.2.2 开发环境配置

推荐使用VSCode配合Flatpak扩展进行开发：

1. 安装VSCode Flatpak扩展
2. 打开命令面板（F1）
3. 搜索并执行"Flatpak: Select or Change Active Manifest"
4. 选择项目根目录下的io.github.jeffshee.Hidamari.json文件

图：VSCode中Flatpak扩展的命令面板，显示构建与运行相关选项

3.2.3 容器化构建与运行

通过VSCode命令面板执行：

• "Flatpak: Build and Run" - 构建并运行应用
• "Flatpak: Run" - 直接运行已构建应用
• "Flatpak: Open a Runtime Terminal" - 打开容器终端进行调试

4. 运维指南：环境管理与维护

4.1 传统部署清理流程

如需卸载传统部署的Hidamari，执行以下命令：

sudo rm -rf /usr/local/share/hidamari
sudo rm /usr/local/bin/hidamari
sudo rm /usr/local/share/appdata/io.github.jeffshee.Hidamari.appdata.xml
sudo rm /usr/local/share/applications/io.github.jeffshee.Hidamari.desktop
sudo rm /usr/local/share/glib-2.0/schemas/io.github.jeffshee.Hidamari.gschema.xml
sudo rm /usr/local/share/icons/hicolor/scalable/apps/io.github.jeffshee.Hidamari.svg
# 彻底清理安装文件与系统集成项

4.2 容器化环境管理

清理构建缓存：

flatpak-builder --clean build-dir io.github.jeffshee.Hidamari.json
# 清理构建目录缓存

更新依赖： 通过VSCode命令面板执行"Flatpak: Update Dependencies"或手动更新JSON清单文件。

4.3 开发效率优化建议

1. 环境隔离：传统部署方案建议配合Python虚拟环境使用

   python -m venv .venv && source .venv/bin/activate
   

2. 依赖管理：定期更新requirements.txt文件，保持依赖版本一致性

3. 构建优化：对于频繁构建场景，可使用Meson的增量构建特性

   meson compile -C build
   

5. 功能预览：Hidamari核心界面展示

Hidamari提供三种主要壁纸设置模式，满足不同使用场景需求：

图：本地视频选择界面，展示Hidamari支持的视频文件列表

图：流媒体设置界面，支持输入YouTube等视频流URL

图：网页壁纸设置界面，可配置在线网页或本地HTML文件作为壁纸

通过以上部署方案，开发者可以快速搭建Hidamari开发环境，根据实际需求选择传统或容器化路径，实现高效开发与测试。