Scrcpy-iOS Android设备远程控制工具使用指南
项目地址: https://gitcode.com/gh_mirrors/sc/scrcpy-ios 项目概述
Scrcpy-iOS 是一款基于 Genymobile scrcpy 项目的 iOS 应用程序，专门用于远程控制 Android 设备。该项目通过 SSH 服务器桥接 iPhone 和 Android 设备之间的通信流量，实现硬件解码和优化的手势操作。
核心功能特性
- SSH远程连接：通过 SSH 服务器连接远程 Android 设备
- 硬件解码：使用 VideoToolbox.framework 进行硬件解码屏幕帧
- 手势优化：在不稳定网络环境下优化的滑动手势
- Termux支持：支持连接在 Termux 应用中启动的 sshd/adb
- URL Scheme自动连接：支持通过 URL Scheme 自动连接
项目目录结构
Scrcpy-iOS/
├── Scrcpy/ # iOS应用程序主目录
│ ├── Assets.xcassets/ # 应用资源文件
│ ├── Base.lproj/ # 基础语言项目文件
│ ├── Info.plist # 应用配置文件
│ ├── LaunchScreen.storyboard # 启动屏幕
│ └── 多个ViewController文件 # 核心功能控制器
├── scrcpy-bridge/ # 桥接层代码
├── scrcpy-core/ # 核心功能模块
├── scrcpy-server/ # 服务器相关文件
├── Scripts/ # 构建脚本
├── ssh/ # SSH功能模块
└── Libs/ # 依赖库文件
安装与配置步骤
1. SSH服务器设置
在使用 Scrcpy 应用之前，需要设置一个安装了 android-platform-tools 的 SSH 服务器：
Mac作为SSH服务器：
- 在"系统偏好设置 > 共享"中启用"远程登录"
Docker容器作为SSH服务器：
- 选择包含 sshd 的容器镜像，推荐使用 Ubuntu 或 Debian 容器
Termux设置（Android设备）：
- 安装 Termux 应用
- 执行命令：
pkg install openssh android-tools - 设置用户密码：
passwd - 启动 sshd 服务：
sshd - 启用无线调试：
adb tcpip 5555
2. Android设备连接
确保已安装 android-platform-tools：
adb devices
可以通过USB端口或TCP网络连接Android设备，需要启用开发者模式。
3. Scrcpy应用连接
在应用中需要配置以下参数：
- SSH服务器地址
- SSH端口号
- SSH用户名
- SSH密码
点击"连接"按钮即可建立连接。
全屏手势操作
从 v1.2 版本开始支持全屏指示器手势：
- 单次滑动：触发Android导航手势
- 快速双击滑动：返回iOS主屏幕
注意：首次滑动后iOS主屏幕指示器会变黑，快速再次滑动将返回iOS主屏幕。如需继续Android导航手势，需等待指示器变灰。
URL Scheme自动连接
支持通过URL Scheme自动连接远程Android设备：
scrcpy://root:BASE64Password@192.168.0.101:8022?screenOff=1&bitRate=4M
密码使用Base64编码确保安全。可以通过右上角扩展菜单中的"复制URL Scheme"功能获取连接URL。
构建要求
构建Scrcpy需要ffmpeg、libsdl、libssh和scrcpy-server.jar等依赖，可以通过以下命令一键安装：
make all
注意：libssh是一个用Golang编写的框架，需要先安装Golang。
构建和运行
使用Xcode打开Scrcpy.xcodeproj工程文件，选择目标设备进行构建和运行。
技术支持
该项目已停止维护，新功能仅在支持ADB的Scrcpy Mobile中更新。由于不符合苹果的审核政策，Scrcpy-iOS.app无法在AppStore上架。
许可证
该项目基于Apache License 2.0许可证开源，允许商业使用和修改，但需保留版权声明。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
