Это приложение обеспечивает отображение и управление устройствами Android, подключенными к USB. Он не требует никакого корневого доступа. Он работает на GNU / Linux, Windows , MacOS.
Требования
Для части Android требуется как минимум API 21 (Android 5.0).
Вам нужен adb (достаточно недавно, чтобы реализовать adb reverse, он работает с 1.0.36).
Он доступен в инструментах платформы Android SDK в вашем дистрибутиве (Android-adb-tools).
В Windows просто загрузите инструменты платформы и извлеките следующие файлы в каталог, доступный из вашего пути:
adb.exe
AdbWinApi.dll
AdbWinUsbApi.dll
Убедитесь, что вы активировали отладку adb на своих устройствах.
Клиент требует FFmpeg и LibSDL2.
Сборка и установка
Системные шаги
Linux
Установите необходимые пакеты из диспетчера пакетов.
Debian / Ubuntu
# sudo apt install ffmpeg libsdl2-2.0.0 # sudo apt install make gcc pkg-config meson \ libavcodec-dev libavformat-dev libavutil-dev \ libsdl2-dev # server build dependencies sudo apt install openjdk-8-jdk
Fedora
# sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm # sudo dnf install SDL2-devel ffms2-devel meson gcc make # sudo dnf install java
Arch linux
Пользователями были созданы два пакета AUR:
scrcpy
scrcpy-prebuiltserver
Windows
Для Windows для простоты доступен готовый архив со всеми зависимостями (включая adb):
scrcpy-windows-with-deps-v1.0.zip
.
(SHA-256: bc4bf32600e8548cdce490f94bed5dcba0006cdd38aff95748972e5d9877dd62)
(Это просто переносная версия, включая dll, скопированная с MSYS2.)
Вместо этого вы можете создать его вручную.
Вам нужен MSYS2 для создания проекта.
С терминала MSYS2 установите необходимые пакеты:
# pacman -S mingw-w64-x86_64-SDL2 \ mingw-w64-x86_64-ffmpeg
# pacman -S mingw-w64-x86_64-make \ mingw-w64-x86_64-gcc \ mingw-w64-x86_64-pkg-config \ mingw-w64-x86_64-meson
Java (> = 7) недоступна в MSYS2, поэтому, если вы планируете строить сервер, установите его вручную и сделайте его доступным из PATH:
export PATH="$JAVA_HOME/bin:$PATH"
Mac OS
Используйте Homebrew для установки пакетов:
# brew install sdl2 ffmpeg
# brew install gcc pkg-config meson
Java (> = 7) недоступна в Homebrew, поэтому, если вы планируете строить сервер, установите его вручную и сделайте его доступным из PATH:
export PATH = "$ JAVA_HOME / bin: $ PATH"
Общие этапы
Установите Android SDK (Android Studio) и установите ANDROID_HOME в свой каталог. Например:
export ANDROID_HOME=~/android/sdk
Затем создайте scrcpy:
meson x --buildtype release --strip -Db_lto=true cd x ninja
Вы можете проверить это здесь:
# ninja run
Или вы можете установить его в систему:
# sudo ninja install
Это устанавливает два файла:
/usr/local/bin/scrcpy
/usr/local/share/scrcpy/scrcpy-server.jar
Просто удалите их, чтобы «удалить» приложение.
Предварительно построенный сервер
Поскольку двоичный файл сервера, который будет вытолкнут на устройство Android, не зависит от вашей системы и архитектуры, вы можете вместо этого использовать предварительно построенный бинарный файл:
scrcpy-server-v1.0.jar
.
(SHA-256: b573b06a6072476b85b6308e3ad189f2665ad5be4f8ca3a6b9ec81d64df20558)
В этом случае сборка не требует Java или Android SDK.
Загрузите предварительно построенный сервер где-нибудь и укажите его путь во время конфигурации Meson:
meson x --buildtype release --strip -Db_lto=true \ -Dprebuilt_server=/path/to/scrcpy-server.jar cd x ninja sudo ninja install
Запуск
Во время выполнения adb должен быть доступен из вашего PATH.
Если все в порядке, просто подключите Android-устройство и выполните:
# scrcpy
Он принимает аргументы командной строки, перечисленные в:
# scrcpy --help
Например, для уменьшения битрейта видео до 2 Мбит / с (по умолчанию 8 Мбит / с):
# scrcpy -b 2M
Чтобы ограничить размеры видео (например, если устройство имеет размер 2540 × 1440, но экран хоста меньше или не может декодировать такое высокое определение):
# scrcpy -m 1024
Если в устройствах adb указаны несколько устройств, вы должны указать серийный номер:
# scrcpy -s 0123456789abcdef</span>
Для запуска без установки:
# ./run x [опции]
(где x – ваш каталог сборки).
Быстрые клавиши
Действие | Горячая кнопка |
---|---|
включить полноэкранный режим | Ctrl +f |
изменить размер окна до 1: 1 | Ctrl +g |
изменить размер окна, чтобы удалить черные границы Ctrl + x | Ctrl +x |
нажать на HOME |
Ctrl +h |
нажать на BACK |
Ctrl +b |
нажать на APP_SWITCH |
Ctrl +m |
нажать на VOLUME_UP |
Ctrl ++ |
нажать наVOLUME_DOWN |
Ctrl +- |
нажать наPOWER |
Ctrl +p |
повернуть экран | Правый щелчок |
вставьте буфер обмена в компьютер на устройство | Ctrl +v |
включить / отключить счетчик FPS (на stdout) | Ctrl +i |