Getting Started

环境要求

构建步骤

1. 首次配置(或修改 CMakeLists.txt 后)

cmake --preset default
2. 编译 Debug
cmake --build build --config Debug
3. 编译 Release
cmake --build build --config Release
---
运行
编译完成后直接运行:
build/Debug/RambosPlayer.exe
或 Release 版本:
build/Release/RambosPlayer.exe
---
运行单元测试
# 运行全部测试
ctest --test-dir build --config Debug --output-on-failure
# 单独运行指定测试
.\build\Debug\TstFrameQueue.exe
.\build\Debug\TstAVSync.exe
.\build\Debug\TstDemuxThread.exe
▎ TstDemuxThread 依赖 tests/data/sample.mp4,首次运行前需生成:
▎
▎ ffmpeg -f lavfi -i "testsrc=duration=2:size=320x240:rate=25" \
▎ -f lavfi -i "sine=frequency=440:duration=2" \
▎ -c:v libx264 -c:a aac -shortest tests/data/sample.mp4
---
打包发布
Release 编译完成后运行打包脚本:
cd release
.\package.ps1 # 默认版本 1.0.0
.\package.ps1 -Version "1.2.1" # 指定版本号
输出:
- release/dist/ — 展开目录,可直接运行验证
- release/RambosPlayer-v1.2.1.zip — 最终分发包
脚本自动收集 Qt 运行时 DLL(windeployqt)、FFmpeg DLL、libx264、mpegts.min.js 等依赖。
---
崩溃排查
程序崩溃时,先读日志,不要盲目改代码:
<exe目录>/logs/rambos_*.log ← 查看崩溃前最后一条消息
<exe目录>/crash_*.dmp ← 用 WinDbg 加载,附上 .pdb 查调用栈
---