Sunshine项目本地构建与打包完整指南

Sunshine项目本地构建与打包完整指南

Sunshine Sunshine is a Gamestream host for Moonlight. 项目地址: https://gitcode.com/gh_mirrors/sunshine5/Sunshine

项目概述

Sunshine是一个基于CMake构建的开源项目，主要用于实现高效的屏幕捕获和流媒体传输功能。该项目支持多种操作系统平台，包括Linux、macOS和Windows。本文将详细介绍如何在不同平台上完成Sunshine项目的本地构建与打包过程。

构建环境准备

CMake版本要求

Sunshine项目要求CMake版本必须高于3.25。在开始构建前，请确保您的系统已安装符合要求的CMake版本。

cmake --version  # 检查当前CMake版本

各平台依赖安装

Linux平台依赖

Linux系统的依赖项会根据发行版的不同而有所差异。对于基于Debian和Fedora的发行版，可以参考项目提供的构建脚本获取完整的依赖列表。

特别需要注意的是NVFBC捕获功能需要CUDA Toolkit支持：

1. CUDA版本需要与GCC版本匹配
2. 不同CUDA版本支持不同的GPU架构
3. 当前推荐使用CUDA 11.8版本

macOS平台依赖

macOS用户可以选择使用Homebrew或MacPorts来安装依赖项。

Homebrew安装方式示例：

brew install cmake openssl@3 opus miniupnpc node

常见问题解决： 如果遇到SSL头文件找不到的问题，需要创建符号链接：

# Intel芯片
ln -s /usr/local/opt/openssl/include/openssl /usr/local/include/openssl

# Apple Silicon芯片
ln -s /opt/homebrew/opt/openssl/include/openssl /opt/homebrew/include/openssl

Windows平台依赖

Windows用户需要先安装MSYS2环境，然后在UCRT64环境中执行以下命令：

pacman -Syu  # 更新所有包
pacman -S mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-nodejs mingw-w64-ucrt-x86_64-openssl

项目构建流程

获取源代码

git clone --recurse-submodules <项目仓库地址>
cd sunshine
mkdir build

执行构建

使用Ninja构建系统可以显著加快构建速度：

cmake -B build -G Ninja -S .
ninja -C build

构建选项说明： 项目提供了多种构建选项，可以通过修改CMake配置来启用或禁用特定功能。这些选项通常包括是否启用文档生成、是否包含特定平台的优化等。

打包发布

完成构建后，可以使用CPack工具生成不同格式的安装包：

Linux平台打包

# 生成DEB包
cpack -G DEB --config ./build/CPackConfig.cmake

# 生成RPM包
cpack -G RPM --config ./build/CPackConfig.cmake

macOS平台打包

# 生成DragNDrop安装包
cpack -G DragNDrop --config ./build/CPackConfig.cmake

Windows平台打包

# 生成NSIS安装程序
cpack -G NSIS --config ./build/CPackConfig.cmake

# 生成便携式ZIP包
cpack -G ZIP --config ./build/CPackConfig.cmake

构建技巧与建议

1. 并行构建：使用-j参数可以指定并行构建任务数，充分利用多核CPU性能

   ninja -C build -j8
   

2. 调试构建：如果需要调试版本，可以在CMake配置时添加-DCMAKE_BUILD_TYPE=Debug

3. 清理构建：当需要重新构建时，建议先清理构建目录

   rm -rf build/*
   

4. 组件选择：通过CMake选项可以只构建特定组件，减少构建时间

常见问题排查

如果在构建过程中遇到问题，可以尝试以下步骤：

1. 检查所有依赖是否已正确安装
2. 确认CMake版本符合要求
3. 查看构建日志中的错误信息
4. 尝试在干净的构建环境中重新构建

通过本文的详细指导，您应该能够在不同平台上顺利完成Sunshine项目的构建和打包工作。如果在实际操作中遇到任何问题，建议参考项目的完整文档或寻求社区支持。

Sunshine Sunshine is a Gamestream host for Moonlight. 项目地址: https://gitcode.com/gh_mirrors/sunshine5/Sunshine