scrcpy编译构建：从源码到跨平台发布
项目地址: https://gitcode.com/gh_mirrors/sc/scrcpy 本文详细解析了scrcpy项目的完整构建流程，涵盖了从Meson+Ninja构建系统配置、客户端依赖管理（SDL2+FFmpeg）、服务器端Java构建流程到Windows/Linux/macOS跨平台打包的全过程。文章深入探讨了scrcpy如何通过现代化的构建工具链实现高效的跨平台编译和部署，包括版本管理策略、依赖处理机制、平台特定优化以及统一的打包系统架构。
Meson+Ninja构建系统配置
scrcpy项目采用Meson和Ninja作为其现代化的构建系统，这种组合为跨平台编译提供了高效且灵活的解决方案。Meson负责配置和生成构建文件，而Ninja则负责高效的并行编译执行。
Meson构建配置解析
scrcpy的Meson配置位于项目根目录的meson.build文件中，这是一个简洁而强大的配置：
project('scrcpy', 'c',
version: '3.2',
meson_version: '>= 0.49',
default_options: [
'c_std=c11',
'warning_level=2',
'b_ndebug=if-release',
])
add_project_arguments('-Wmissing-prototypes', language: 'c')
if get_option('compile_app')
subdir('app')
endif
if get_option('compile_server')
subdir('server')
endif
这个配置定义了项目的基本信息，包括：
- 项目名称：
scrcpy - 编程语言：C语言
- 版本号：3.2
- 最低Meson版本要求：0.49
- 默认编译选项：C11标准、警告级别2、发布版本禁用调试
构建选项配置
项目通过meson_options.txt文件提供了丰富的构建选项：
option('compile_app', type: 'boolean', value: true, description: 'Build the client')
option('compile_server', type: 'boolean', value: true, description: 'Build the server')
option('prebuilt_server', type: 'string', description: 'Path of the prebuilt server')
option('portable', type: 'boolean', value: false, description: 'Use scrcpy-server from the same directory as the scrcpy executable')
option('static', type: 'boolean', value: false, description: 'Use static dependencies')
option('server_debugger', type: 'boolean', value: false, description: 'Run a server debugger and wait for a client to be attached')
option('v4l2', type: 'boolean', value: true, description: 'Enable V4L2 feature when supported')
option('usb', type: 'boolean', value: true, description: 'Enable HID/OTG features when supported')
这些选项为用户提供了灵活的构建选择，可以根据需求启用或禁用特定功能。
应用模块构建配置
app/meson.build文件包含了客户端应用的主要构建配置，展示了Meson的强大功能：
源文件组织
Meson配置中明确定义了所有源文件：
src = [
'src/main.c',
'src/adb/adb.c',
'src/adb/adb_device.c',
# ... 超过50个源文件
'src/util/thread.c',
'src/util/tick.c',
'src/util/timeout.c',
]
平台特定配置
项目针对不同平台进行了精细化的配置：
if host_machine.system() == 'windows'
windows = import('windows')
src += [
'src/sys/win/file.c',
'src/sys/win/process.c',
windows.compile_resources('scrcpy-windows.rc'),
]
conf.set('_WIN32_WINNT', '0x0600')
conf.set('WINVER', '0x0600')
else
src += [
'src/sys/unix/file.c',
'src/sys/unix/process.c',
]
if host_machine.system() == 'darwin'
conf.set('_DARWIN_C_SOURCE', true)
endif
endif
功能模块检测
构建系统能够自动检测和配置可选功能：
v4l2_support = get_option('v4l2') and host_machine.system() == 'linux'
if v4l2_support
src += [ 'src/v4l2_sink.c' ]
endif
usb_support = get_option('usb')
if usb_support
src += [
'src/usb/aoa_hid.c',
'src/usb/gamepad_aoa.c',
# ... USB相关源文件
]
endif
依赖项管理
Meson优雅地处理了外部依赖：
dependencies = [
dependency('libavformat', version: '>= 57.33', static: static),
dependency('libavcodec', version: '>= 57.37', static: static),
dependency('libavutil', static: static),
dependency('libswresample', static: static),
dependency('sdl2', version: '>= 2.0.5', static: static),
]
if v4l2_support
dependencies += dependency('libavdevice', static: static)
endif
if usb_support
dependencies += dependency('libusb-1.0', static: static)
endif
构建流程示例
典型的scrcpy构建流程如下：
# 配置构建目录
meson setup build --buildtype=release --strip -Db_lto=true
# 编译项目
ninja -C build
# 安装到系统
sudo ninja -C build install
跨平台构建支持
scrcpy的Meson配置充分考虑了跨平台需求：
| 平台 | 特殊配置 | 依赖处理 |
|---|---|---|
| Linux | POSIX标准配置 | 动态链接库依赖 |
| Windows | Windows资源编译 | MinGW库链接 |
| macOS | Darwin特定配置 | Homebrew包管理 |
测试框架集成
Meson配置还包含了完整的测试框架：
if get_option('buildtype') == 'debug'
tests = [
['test_adb_parser', [
'tests/test_adb_parser.c',
'src/adb/adb_device.c',
'src/adb/adb_parser.c',
# ... 测试依赖
]],
# ... 更多测试用例
]
foreach t : tests
exe = executable(t[0], sources, ...)
test(t[0], exe)
endforeach
endif
这种配置确保了在调试模式下自动构建和运行所有单元测试。
scrcpy的Meson+Ninja构建系统配置展示了现代C项目构建的最佳实践，通过清晰的模块化配置、灵活的选项管理和完善的跨平台支持，为开发者提供了高效可靠的构建体验。这种配置方式不仅简化了构建过程，还确保了项目在不同平台和环境中的一致性和可维护性。
客户端依赖管理（SDL2+FFmpeg）
scrcpy客户端核心功能依赖于两个关键的多媒体库：SDL2（Simple DirectMedia Layer）用于跨平台图形渲染和输入处理，FFmpeg用于音视频解码和处理。这两个库的版本选择、编译配置和集成方式直接影响scrcpy的性能、稳定性和跨平台兼容性。
依赖版本管理策略
scrcpy采用精确的版本锁定机制确保构建的可靠性。通过独立的依赖管理脚本，项目维护者可以严格控制每个依赖的版本：
# SDL2版本配置（app/deps/sdl.sh）
VERSION=2.32.2
FILENAME=SDL-$VERSION.tar.gz
SHA256SUM=f2c7297ae7b3d3910a8b131e1e2a558fdd6d1a4443d5e345374d45cadfcb05a4
# FFmpeg版本配置（app/deps/ffmpeg.sh）
VERSION=7.1.1
FILENAME=ffmpeg-$VERSION.tar.xz
SHA256SUM=733984395e0dbbe5c046abda2dc49a5544e7e0e1e2366bba849222ae9e3a03b1
这种版本锁定策略确保了：
- 构建过程的可重复性
- 避免因依赖库更新导致的兼容性问题
- 便于安全漏洞的跟踪和修复
跨平台编译配置
scrcpy的依赖管理支持多种构建模式和目标平台：
| 构建类型 | 目标平台 | 链接方式 | 配置参数 |
|---|---|---|---|
| Native | Linux | Static | --enable-static --disable-shared |
| Native | Linux | Shared | --disable-static --enable-shared |
| Cross | Windows 32-bit | Static | --host=i686-w64-mingw32 --enable-static |
| Cross | Windows 64-bit | Shared | --host=x86_64-w64-mingw32 --enable-shared |
SDL2定制化配置
SDL2作为scrcpy的图形和输入后端，需要针对不同平台进行优化配置：
Linux平台配置：
conf=(
--prefix="$INSTALL_DIR/$DIRNAME"
--enable-video-wayland
--enable-video-x11
)
Windows跨平台配置：
conf+=(
--host="$HOST_TRIPLET"
--disable-static
--enable-shared
)
SDL2在scrcpy中的主要功能包括：
- 窗口管理和渲染
- 输入事件处理（键盘、鼠标）
- 多线程同步原语
- 日志系统集成
FFmpeg精简配置策略
考虑到scrcpy的特定需求，FFmpeg配置进行了大量精简，只启用必要的组件：
conf=(
--prefix="$INSTALL_DIR/$DIRNAME"
--pkg-config-flags="--static"
--extra-cflags="-O2 -fPIC"
--disable-programs
--disable-doc
--disable-swscale
--disable-postproc
--disable-avfilter
--disable-network
--disable-everything
--enable-swresample
--enable-libdav1d
--enable-decoder=h264
--enable-decoder=hevc
--enable-decoder=av1
--enable-decoder=libdav1d
--enable-decoder=pcm_s16le
--enable-decoder=opus
--enable-decoder=aac
--enable-decoder=flac
--enable-decoder=png
--enable-protocol=file
--enable-demuxer=image2
--enable-parser=png
--enable-zlib
)
这种配置策略显著减少了二进制大小和依赖复杂度，同时确保支持所有必要的编解码器。
依赖构建工作流
scrcpy采用统一的工作目录结构管理依赖构建：
work/
├── sources/ # 源代码存档
├── build/ # 构建中间文件
└── install/ # 最终安装文件
构建过程通过通用脚本common提供标准化功能：
- 文件下载和校验验证
- 构建类型参数解析
- 跨平台工具链配置
- 安装目录管理
平台特定优化
Windows平台特殊处理：
if [[ "$HOST" == win* ]]
then
export CFLAGS='-static-libgcc -static'
export CXXFLAGS="$CFLAGS"
export LDFLAGS='-static-libgcc -static'
fi
Linux平台V4L2支持：
if [[ "$HOST" == linux ]]
then
conf+=(
--enable-libv4l2
--enable-outdev=v4l2
--enable-encoder=rawvideo
)
fi
集成与链接配置
构建scrcpy客户端时，通过pkg-config正确配置依赖库路径：
meson setup "$LINUX_BUILD_DIR" \
--pkg-config-path="$DEPS_INSTALL_DIR/lib/pkgconfig" \
-Dc_args="-I$DEPS_INSTALL_DIR/include" \
-Dc_link_args="-L$DEPS_INSTALL_DIR/lib" \
--buildtype=release \
--strip \
-Db_lto=true
这种依赖管理方式确保了：
- 开发环境与生产环境的一致性
- 跨平台构建的可重复性
- 最小化的运行时依赖
- 优化的二进制大小和性能
通过精心设计的依赖管理系统，scrcpy能够在保持功能完整性的同时，实现出色的跨平台兼容性和部署便利性。
服务器端Java构建流程
scrcpy的服务器端是一个运行在Android设备上的Java应用程序，负责捕获设备屏幕、处理音频、编码视频流以及与客户端通信。服务器端的构建过程采用了Android标准的构建工具链，但针对scrcpy的特殊需求进行了优化。
构建环境配置
服务器端构建需要配置Android SDK环境，主要包括：
# 环境变量配置示例
export ANDROID_HOME=/path/to/android/sdk
export ANDROID_PLATFORM=35 # Android API级别
export ANDROID_BUILD_TOOLS=35.0.0 # 构建工具版本
export BUILD_DIR=build_output # 自定义构建目录
构建流程详解
scrcpy服务器端的构建流程可以分为以下几个关键步骤：
1. 源码预处理
构建过程首先处理AIDL接口文件和生成BuildConfig类：
2. AIDL接口编译
服务器端使用了Android的AIDL机制来处理系统服务调用：
// 生成的AIDL接口示例
public interface IDisplayWindowListener extends IInterface {
void onDisplayAdded(int displayId);
void onDisplayRemoved(int displayId);
void onDisplayConfigurationChanged(int displayId, Configuration newConfig);
}
3. Java源码编译
编译过程使用javac命令，指定Android平台作为bootclasspath：
javac -encoding UTF-8 -bootclasspath "$ANDROID_JAR" \
-cp "$LAMBDA_JAR:$GEN_DIR" \
-d "$CLASSES_DIR" \
-source 1.8 -target 1.8 \
${FAKE_SRC[@]} \
${SRC[@]}
4. Dex转换和打包
根据Android平台版本选择不同的dex工具：
| Android版本 | 使用工具 | 输出格式 |
|---|---|---|
| < API 31 | dx工具 | classes.dex → JAR |
| ≥ API 31 | d8工具 | classes.zip → 直接使用 |
核心构建脚本分析
构建脚本build_without_gradle.sh的主要功能模块：
#!/usr/bin/env bash
# 构建配置
PLATFORM=${ANDROID_PLATFORM:-35}
BUILD_TOOLS=${ANDROID_BUILD_TOOLS:-35.0.0}
# 目录结构设置
BUILD_DIR="$(realpath ${BUILD_DIR:-build_manual})"
CLASSES_DIR="$BUILD_DIR/classes"
GEN_DIR="$BUILD_DIR/gen"
# 源码文件组织
SRC=(
com/genymobile/scrcpy/*.java
com/genymobile/scrcpy/audio/*.java
com/genymobile/scrcpy/control/*.java
com/genymobile/scrcpy/device/*.java
com/genymobile/scrcpy/opengl/*.java
com/genymobile/scrcpy/util/*.java
com/genymobile/scrcpy/video/*.java
com/genymobile/scrcpy/wrappers/*.java
)
构建产物结构
构建完成后生成的服务器端二进制文件包含以下组件：
| 组件类型 | 文件路径 | 功能描述 |
|---|---|---|
| 主类文件 | com/genymobile/scrcpy/Server.class | 服务器主入口点 |
| 控制模块 | com/genymobile/scrcpy/control/*.class | 处理控制消息 |
| 视频模块 | com/genymobile/scrcpy/video/*.class | 视频捕获和编码 |
| 音频模块 | com/genymobile/scrcpy/audio/*.class | 音频处理和编码 |
| 设备接口 | com/genymobile/scrcpy/wrappers/*.class | 系统服务封装 |
自定义构建选项
构建脚本支持多个自定义选项：
#创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
