QtScrcpy 开源项目入门指南及问题解答

QtScrcpy 开源项目入门指南及问题解答

项目地址:https://gitcode.com/gh_mirrors/qt/QtScrcpy

项目基础介绍

QtScrcpy 是一款基于 Genymobile 的 scrcpy 项目的增强版 Android 实时显示控制软件。它支持通过USB或网络显示和控制Android设备，无需root权限。该工具专注于轻量化（仅显示设备屏幕）、高性能（30~60fps）、高画质（至少1920x1080分辨率）、低延迟（35~70ms）以及快速启动（一秒内即可显示首帧）。QtScrcpy 支持GNU/Linux、Windows和macOS三大平台，并且不向设备中安装任何额外软件。项目采用 C++ 作为主要开发语言，利用Qt框架实现GUI界面，而底层视频处理依赖FFmpeg。

新手注意事项及解决方案

1. 环境配置问题

解决步骤：

• 确保Qt环境: 对于新手，首先需要正确配置Qt开发环境。对于非Arch Linux用户，推荐使用官方Qt Installer或aqtinstall设置Qt版本（5.12以上），Windows用户还需选择MSVC 2019编译器。
• Git克隆及子模块: 使用命令git clone --recurse-submodules git@github.com:barry-ran/QtScrcpy.git来克隆项目，确保获取所有依赖。

2. 编译失败问题

解决步骤：

• 检查依赖: 在Linux上，确保已安装必要的包，如cmake, qt5-base, qt5-multimedia, qt5-x11extras等。
• 编译指令: 在Linux环境下，运行ci/linux/build_for_linux.sh "Release"以编译。Windows用户则应该在Qt Creator中打开CMakeLists.txt并编译Release版本。

3. ADB调试未启用

解决步骤：

• 启用ADB调试: 进入设备的开发者选项，在“USB调试”处打钩。这通常需先在“关于手机”里连续点击版本号多次来解锁开发者选项。
• 连接设备: 连接设备后，通过命令行输入adb devices检查是否识别到设备。如果没有列出你的设备，可能需要更新ADB驱动。

---

通过遵循上述指导，新手可以顺利地开始使用QtScrcpy进行Android设备的远程控制与管理，享受高效且低门槛的开发体验。记得在遇到具体技术问题时，参考项目的文档和社区讨论以寻求更深入的帮助。

QtScrcpy QtScrcpy 可以通过 USB / 网络连接Android设备，并进行显示和控制。无需root权限。 项目地址: https://gitcode.com/gh_mirrors/qt/QtScrcpy