从零搭建Hidamari动态壁纸开发环境：两种方案解决系统依赖冲突

从零搭建Hidamari动态壁纸开发环境：两种方案解决系统依赖冲突

【免费下载链接】hidamariVideo wallpaper for Linux. Written in Python. 🐍项目地址: https://gitcode.com/gh_mirrors/hi/hidamari

目录

• 1. 环境诊断：确认系统兼容性
• 2. 方案一：传统构建方式——系统级环境部署
• 3. 方案二：Flatpak容器化构建——隔离环境部署
• 4. 常见问题速查
• 5. 开发环境迁移指南

1. 环境诊断：确认系统兼容性 ⚓️env-check

在开始部署前，请执行以下命令检查系统是否满足基本要求：

# 检查Python版本（需3.8+） python3 --version # 检查GTK版本（需3.24+） pkg-config --modversion gtk+-3.0 # 检查系统架构 uname -m

若命令执行失败或版本低于要求，请先升级相应组件。Arch系用户可使用pacman -Syu，Debian系使用apt update && apt upgrade。

开发者笔记

• 推荐使用Ubuntu 20.04+/Fedora 34+系统以获得最佳兼容性
• 32位系统可能存在依赖缺失问题，建议使用64位系统开发

2. 方案一：传统构建方式——系统级环境部署 ⚓️traditional-build

2.1 环境准备

2.1.1 安装系统依赖

通用基础指令：

# 安装构建工具链 sudo apt install git meson # Ubuntu/Debian系 # 或 sudo dnf install git meson # Fedora/RHEL系

发行版特定依赖：

# Ubuntu/Debian系完整依赖 sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev libwnck-3-dev libvlc-dev dconf-cli libappindicator3-1 mesa-utils vdpauinfo xdg-user-dirs # Fedora/RHEL系完整依赖 sudo dnf install gtk3-devel webkit2gtk4.1-devel libwnck3-devel vlc-devel dconf glx-utils libappindicator-gtk3 vdpauinfo xdg-user-dirs

2.1.2 Python环境配置

✅ 已验证：Python虚拟环境方案

# 创建虚拟环境 python3 -m venv .venv # 激活虚拟环境 source .venv/bin/activate # Linux/macOS # 或 .venv\Scripts\activate # Windows # 安装Python依赖 pip install -r requirements.txt

⚠️ 注意：虚拟环境激活后，所有Python命令将在隔离环境中执行

2.2 项目构建与运行

# 克隆项目代码 git clone https://gitcode.com/gh_mirrors/hi/hidamari cd hidamari # 初始化构建配置 meson setup build # 执行构建 meson compile -C build # 测试运行 ./build/src/hidamari

2.3 系统安装（可选）

# 安装到系统 sudo meson install -C build # 从应用菜单启动或直接运行 hidamari

开发者笔记

• 推荐使用PyCharm或VSCode配合Python插件进行开发
• 修改UI文件（.ui）后需重新运行meson compile
• 调试时可使用G_MESSAGES_DEBUG=all hidamari查看详细日志

3. 方案二：Flatpak容器化构建——隔离环境部署 ⚓️flatpak-build

3.1 Flatpak环境准备

✅ 已验证：基础环境配置

# 安装Flatpak工具链 sudo apt install flatpak flatpak-builder # Ubuntu/Debian系 # 或 sudo dnf install flatpak flatpak-builder # Fedora/RHEL系 # 添加Flathub仓库 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

3.2 项目获取与配置

# 克隆项目（包含子模块） git clone --recurse-submodules https://gitcode.com/gh_mirrors/hi/hidamari cd hidamari # 若已克隆项目，初始化子模块 git submodule update --init --recursive

3.3 使用VSCode进行Flatpak开发

✅ 已验证：VSCode开发流程

1. 安装VSCode Flatpak扩展
2. 打开命令面板（F1）
3. 执行Flatpak: Select or Change Active Manifest
4. 选择io.github.jeffshee.Hidamari.json
5. 执行Flatpak: Build and Run开始构建和运行

3.4 手动构建与运行

⚠️ 实验性：命令行构建方式

# 构建Flatpak包 flatpak-builder --user --install --force-clean build-dir io.github.jeffshee.Hidamari.json # 运行应用 flatpak run io.github.jeffshee.Hidamari

开发者笔记

• Flatpak首次构建耗时较长（30-60分钟），后续构建会增量更新
• 开发过程中可使用Flatpak: Open a Runtime Terminal调试运行环境
• 如需修改依赖，需同步更新python3-requirements.json和requirements.txt

4. 常见问题速查 ⚓️faq

构建错误

运行时问题

Q: 应用启动后无界面显示？
A: 检查是否安装了所有运行时依赖，特别是libwnck3和libappindicator-gtk3

Q: 视频无法播放？
A: 确认系统已安装vlc和ffmpeg，Flatpak用户需检查沙箱权限

5. 开发环境迁移指南 ⚓️migration

5.1 环境备份

# 导出已安装的Python包列表 pip freeze > requirements-backup.txt # 保存Flatpak构建状态（可选） flatpak-builder --export-bundle hidamari.flatpak build-dir io.github.jeffshee.Hidamari

5.2 新环境恢复

# 克隆项目并安装Python依赖 git clone https://gitcode.com/gh_mirrors/hi/hidamari cd hidamari python3 -m venv .venv source .venv/bin/activate pip install -r requirements-backup.txt

构建方式特性对比

Hidamari应用主界面 - 本地视频选择标签页

Hidamari流媒体URL输入界面

Hidamari网页壁纸配置界面

【免费下载链接】hidamariVideo wallpaper for Linux. Written in Python. 🐍项目地址: https://gitcode.com/gh_mirrors/hi/hidamari