安装与设置

相关源文件

• README.md
• app/meson.build
• doc/build.md
• doc/linux.md
• doc/macos.md
• doc/windows.md
• install_release.sh
• meson_options.txt

本文档介绍了 scrcpy 在不同平台上的安装过程，以及如何设置环境以连接到 Android 设备。有关安装后的使用信息，请参阅 使用指南。

先决条件

在安装 scrcpy 之前，请确保您的系统满足以下最低要求

• 目标 Android 设备 API 级别 21 (Android 5.0) 或更高版本
• USB 数据线或网络连接到 Android 设备
• 在 Android 设备上启用 USB 调试（OTG 模式不需要）
• 用于音频转发：Android 11 或更高版本

来源： README.md48-56

对于某些设备（尤其是小米），您可能需要启用一个额外的选项 USB 调试（安全设置） 来允许输入控制。

来源： README.md58-69

安装方法

安装 scrcpy 的方法有三种

来源： README.md74-78 doc/windows.md5-47 doc/linux.md5-74 doc/macos.md5-48

平台特定安装

Linux

从官方发布版下载

下载适用于您架构的静态构建版

wget https://github.com/Genymobile/scrcpy/releases/download/v3.2/scrcpy-linux-x86_64-v3.2.tar.gz
tar xf scrcpy-linux-x86_64-v3.2.tar.gz
cd scrcpy-linux-x86_64-v3.2

从包管理器安装

取决于您的发行版

发行版	命令
Arch Linux	pacman -S scrcpy
Fedora	dnf copr enable zeno/scrcpy && dnf install scrcpy
Gentoo	emerge scrcpy

快速安装脚本

对于 Debian/Ubuntu，您可以使用提供的安装脚本

来源： doc/linux.md5-74 install_release.sh1-22

Windows

从官方发布版下载

1. 下载适用于您系统架构的 ZIP 文件
   • 64位： scrcpy-win64-v3.2.zip
   • 32位： scrcpy-win32-v3.2.zip
2. 将 ZIP 文件解压到您选择的位置
3. 通过命令行或提供的批处理文件运行 scrcpy

从包管理器安装

包管理器	命令
WinGet	winget install --exact Genymobile.scrcpy
Chocolatey	choco install scrcpy choco install adb （如果需要）
Scoop	scoop install scrcpy scoop install adb （如果需要）

在 Windows 上运行

要在 Windows 上运行 scrcpy

1. 在 scrcpy 目录中双击 open_a_terminal_here.bat
2. 输入您的命令： scrcpy [options]

或者，使用

• scrcpy-console.bat - 启动时带有终端窗口
• scrcpy-noconsole.vbs - 启动时没有终端窗口

来源： doc/windows.md5-100

macOS

从官方发布版下载

下载合适的静态构建版

• 适用于 Apple Silicon (M1/M2)： scrcpy-macos-aarch64-v3.2.tar.gz
• 适用于 Intel： scrcpy-macos-x86_64-v3.2.tar.gz

解压并运行应用程序。

从包管理器安装

使用 Homebrew

使用 MacPorts

来源： doc/macos.md1-70

从源代码构建

对于需要自定义构建或最新开发版本的用户，scrcpy 可以从源代码进行构建。

基本构建要求

• 开发工具：gcc, pkg-config, meson, ninja
• 依赖项
  • FFmpeg 库（libavformat, libavcodec 等）
  • SDL2
  • libusb（用于 USB 功能）
  • ADB（用于设备通信）
  • JDK 17+（用于构建服务器组件）

平台特定依赖项

平台	安装命令
Debian/Ubuntu	sudo apt install gcc git pkg-config meson ninja-build libsdl2-dev libavcodec-dev libavdevice-dev libavformat-dev libavutil-dev libswresample-dev libusb-1.0-0-dev openjdk-17-jdk
Fedora	sudo dnf install SDL2-devel ffms2-devel libusb1-devel libavdevice-free-devel meson gcc make java-devel
Windows (MSYS2)	pacman -S mingw-w64-x86_64-SDL2 mingw-w64-x86_64-ffmpeg mingw-w64-x86_64-libusb mingw-w64-x86_64-make mingw-w64-x86_64-gcc mingw-w64-x86_64-pkg-config mingw-w64-x86_64-meson
macOS	brew install sdl2 ffmpeg libusb pkg-config meson adoptopenjdk/openjdk/adoptopenjdk17

来源： doc/build.md20-179 app/meson.build1-288 meson_options.txt1-9

构建流程

克隆仓库

两个主要构建选项

1. 使用预构建服务器（速度更快，无需 Android SDK）

2. 从源代码构建所有内容（需要 Android SDK）

安装到系统

来源： doc/build.md196-279 app/meson.build157-163

安装后设置

ADB 设置

1. 确保 ADB 已安装并且可以在您的 PATH 中访问
2. 在您的 Android 设备上启用 USB 调试
   • 转到 设置 → 关于手机 → 点击“版本号”7 次
   • 返回 设置 → 开发人员选项 → 启用“USB 调试”
3. 通过 USB 连接您的设备
4. 验证连接： adb devices 应列出您的设备

配置选项

Scrcpy 可以在构建时通过 meson 选项进行配置

选项	描述
--buildtype=release	构建优化版本
-Db_lto=true	启用链接时优化
-Dprebuilt_server=path	使用预构建服务器
-Dportable=true	构建便携版

来源： meson_options.txt1-9 app/meson.build157-163

验证安装

安装后，您可以验证 scrcpy 是否正常工作

如果 scrcpy 成功启动，您应该能在电脑上看到您的 Android 设备屏幕镜像。

来源： README.md81-89

安装文件结构

系统级安装时，scrcpy 会将文件放置在以下位置

文件	位置	目的
scrcpy	/usr/local/bin/	主可执行文件
scrcpy-server	/usr/local/share/scrcpy/	推送到设备的服务器组件
scrcpy.1	/usr/local/share/man/man1/	手册页
icon.png	/usr/local/share/icons/hicolor/256x256/apps/	应用程序图标
_scrcpy	/usr/local/share/zsh/site-functions/	ZSH 补全
scrcpy	/usr/local/share/bash-completion/completions/	Bash 补全

来源： doc/build.md269-277 app/meson.build183-208

故障排除

如果在安装过程中遇到问题，请查看这些常见问题

1. 找不到 ADB：确保 ADB 已安装并在您的 PATH 中
2. 依赖项错误：验证是否已安装所有必需的依赖项
3. 权限问题：确保您拥有适当的权限
4. 构建错误：对于源代码构建，请检查是否已安装所有构建依赖项
5. 服务器版本不匹配：确保服务器版本与客户端版本匹配

有关更详细的故障排除，请参阅 故障排除。

来源： README.md183-187