在Steam Deck上开发Chiaki4Deck项目的完整指南
项目地址: https://gitcode.com/gh_mirrors/ch/chiaki4deck 前言
Chiaki4Deck是一款专为Steam Deck优化的PlayStation远程播放客户端，基于Chiaki-ng项目开发。对于希望在Steam Deck上进行Chiaki4Deck项目开发的贡献者来说，本文将详细介绍如何在Steam Deck上搭建开发环境、进行代码修改和调试，而无需每次都构建新的Flatpak包。
开发环境准备
1. 安装开发版Flatpak
首先需要安装带有调试扩展的开发版Flatpak：
flatpak install --user --include-debug -y https://raw.githubusercontent.com/streetpea/chiaki-ng/main/scripts/flatpak/io.github.streetpea.Chiaki4deck-devel.flatpakref
技术说明：--include-debug参数会同时安装调试符号，这对于后续的调试工作至关重要。
2. 配置文件迁移
将正式版的配置文件复制到开发版中：
cp ~/.var/app/io.github.streetpea.Chiaki4deck/config/Chiaki/Chiaki.conf ~/.var/app/io.github.streetpea.Chiaki4deck-devel/config/Chiaki/Chiaki.conf
3. 安装开发工具链
安装KDE SDK及其调试扩展：
flatpak install --user org.kde.Sdk//6.8
flatpak install --user org.kde.Sdk.Debug//6.8
获取源代码
克隆Chiaki-ng项目及其子模块：
git clone --recurse-submodules https://github.com/streetpea/chiaki-ng.git
注意事项：如果开发自己的分支功能，需要切换到相应分支或将其合并到主分支中。
开发工作流程
1. 进入开发环境
使用以下命令进入Flatpak开发环境：
flatpak run --command=bash --devel io.github.streetpea.Chiaki4deck-devel
2. 构建项目
调试构建(Debug Build)
mkdir Debug
cd Debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
make
发布构建(Release Build)
mkdir Release
cd Release
cmake -DCMAKE_BUILD_TYPE=Release ..
make
3. 运行和调试
调试模式运行
gdb ./gui/chiaki
发布模式运行
./gui/chiaki
重要提示：在Flatpak环境中运行时，请将vaapi设置为none，否则视频可能无法正常工作。这在开发测试中可以接受，性能下降不是主要问题。
4. 代码编辑建议
推荐使用VSCode作为代码编辑器，可通过Steam Deck的Discover商店安装Flatpak版本。编辑保存后，修改会立即反映在Flatpak环境中。
5. 增量构建
代码修改后，只需在相应构建目录中重新运行make命令即可完成增量构建。
高级调试技巧
分析核心转储(Coredump)
- 列出所有核心转储：
coredumpctl
- 使用GDB分析特定进程的核心转储：
flatpak-coredumpctl -m [PID] io.github.streetpea.Chiaki4deck-devel
- 常用GDB命令：
bt：显示调用栈bt full：显示详细调用栈info locals：查看局部变量print [变量名]：打印变量值
依赖管理注意事项
如果需要添加新的依赖项，需要注意：
- 如果依赖项已包含在Flatpak模块或SDK中，可以直接使用
- 否则需要：
- 创建包含该模块的新Flatpak构建
- 或者本地安装该模块并添加到PATH中
结语
通过本文介绍的方法，开发者可以在Steam Deck上高效地进行Chiaki4Deck项目的开发和调试工作。这种开发方式避免了频繁构建Flatpak包的繁琐过程，大大提高了开发效率。对于希望为Chiaki4Deck项目贡献代码的开发者来说，掌握这些技巧将极大简化开发流程。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
