Skip to content

Latest commit

 

History

History
136 lines (81 loc) · 4.34 KB

README_CN.md

File metadata and controls

136 lines (81 loc) · 4.34 KB
Raw

DroidCast

DroidCast

在 Android 设备上截屏并在浏览器上显示屏幕图像的一个实验性项目。该工具能兼容 Android 4.0 及以上系统版本。它支持按照多种图片格式和指定大小实时截屏，是批量截图，上报bug以及 演示 app 功能页面的首选工具。

⚠️ 代码中通过反射调用了一些系统隐藏的方法，相关功能可能会随着 Android 系统接口的变化而受到影响.

依赖

快速上手

  • 连接你的 Android 设备或是模拟器
  • 安装 Apk

从 这里 下载并安装应用，或是直接通过命令行安装:

./gradlew clean installDebug
  • 运行脚本 (Python3.6 及以上环境请使用 automation3.py)
python scripts/automation.py

然后，默认浏览器将会打开，你就能看到截屏了。

  • (可选) 指定已连接的单台设备以及设置截屏服务端口
python scripts/automation.py -p 12346 -s 'your-device-id'

详细请查看 python scripts/automation.py -h

同网段 WIFI 环境下无线配置使用：

  • 获取设备 IP 地址 (设置-系统-关于手机-状态) e.g : 192.168.x.x
  • 在设备上配置启用 adb 的 TCP/IP 模式 : adb tcpip 5555
  • 连接你的设备 : adb connect 192.168.x.x:5555(替换192.168.x.x为设备实际 IP)
  • 拔掉 USB 连接线
  • 按下面的 一般（USB 连线）使用说明 中的步骤完成设置

如需重置为默认的 USB 模式，请执行 : adb usb

一般（USB 连线）使用说明:

备注

一旦 APK 安装完成，你可以使用 python 脚本 来自动化完成以下 adb 命令相关的操作.

  • 执行以下命令在手机上安装 apk （不要通过 Android Studio Run 'app' 来安装）
./gradlew clean installDebug
  • 将 apk 文件 push 到手机的 tmp 文件夹下
adb push ${your-project-path}/DroidCast/app/build/outputs/apk/debug/DroidCast-debug-1.0.apk /data/local/tmp
  • 通过 app_process 启动内部的图片处理服务进程
$ adb shell
D1C:/ $ export CLASSPATH=/data/local/tmp/DroidCast-debug-1.0.apk
D1C:/ $ exec app_process /system/bin com.rayworks.droidcast.Main '$@'
>>> DroidCast main entry

  • 请注意: 在某些设备上, 如果你碰到类似 "appproc: ERROR: could not find class 'com.rayworks.droidcast.Main'的错误， 请把上面 shell 命令中的 CLASSPATH 值替换为执行命令 adb shell pm path com.rayworks.droidcast 后的实际返回值。

  • 使用 adb forward 命令将本地（PC）socket 连接重定向到远端已连接的设备（手机）上。
$ adb forward tcp:53516 tcp:53516

参考

vysor 原理以及 Android 同屏方案

scrcpy : Display and control your Android device

相关项目

scrcpy

web-adb

AndroidScreenShot_SysApi

赞助开发

请我喝杯咖啡 ☕️

License

Copyright (C) 2018 rayworks

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.