atxserver2

Схема развёртывания 1 (способ docker-compose)

1. Скопируйте код на локальный компьютер.

2. Перейдите в каталог с кодом и выполните команду:

docker-compose up

Схема развёртывания 2 (ручное развёртывание)

Шаг 1

Подготовьте сервер rethinkdb (рекомендуется развернуть на Linux). Подробные инструкции см. в документации по установке RethinkDB.

Запустите контейнер Docker:

$ docker run -d -P --name rethink1 rethinkdb

Шаг 2

Установите и запустите сервер. Для этого потребуется Python версии 3.6 или выше.

Скопируйте код на локальную машину, затем установите зависимости с помощью следующей команды:

pip3 install -r requirements.txt

Самый простой способ запуска (по умолчанию используется адрес rethinkdb localhost:28015):

# Запуск — это самый простой способ
python3 main.py

# Указание метода аутентификации
python3 main.py --auth simple # По умолчанию это очень простой метод аутентификации, достаточно ввести адрес электронной почты
python3 main.py --auth openid # Используется внутри компании NetEase
# Другие методы аутентификации ещё предстоит добавить. Мы будем рады PR

# Настройка порта прослушивания
python3 main.ru --port 4000 # По умолчанию прослушивается этот порт

# По умолчанию поддерживается работа под Nginx, поддерживается X-Real-Ip/X-Forwarded-For
# Если вам это не нужно, вы можете отключить эту функцию с помощью --no-xheaders

С помощью переменных среды можно изменить адрес подключения к RethinkDB:

# В среде Linux
# Это значение по умолчанию
export RDB_HOST=localhost
export RDB_PORT=28015
export RDB_USER=admin
export RDB_PASSWD=
export RDB_DBNAME=atxserver2

python3 main.py

После запуска перейдите в браузере по адресу http://localhost:4000. После успешной аутентификации вы увидите страницу со списком устройств. Однако пока она пуста.

Шаг 3: Подключение Android-устройств

Теперь подключите устройства Android. Вам понадобится другой проект atxserver2-android-provider. Для запуска этого проекта требуется Python версии 3.6+ и NodeJS.

Если вы используете Linux, рекомендуется использовать Docker для развёртывания. На других платформах необходимо использовать исходный код, подробнее см. документацию atxserver2-android-provider.

SERVER_URL="http://10.0.0.1:4000" # Измените на свой адрес atxserver2
IMAGE="codeskyblue/atxserver2-android-provider"
docker pull $IMAGE
docker run --rm --privileged -v /dev/bus/usb:/dev/bus/usb --net host \
    ${IMAGE} python main.py --server ${SERVER_URL}

Этот образ отправит все необходимые ресурсы (atx-uiautomator.apk, minicap, minitouch, atx-agent) на телефон. Когда всё будет готово, вы сможете выполнять удалённые операции на реальном устройстве.

Шаг 3: Подключение iOS-устройств

См. введение в проект atxserver2-ios-provider.

Подключение частных устройств (бета)

В настоящее время реализовано только для Android.

При запуске atxserver2-android-provider можно передать параметр --owner=xingxing, чтобы объявить, что все подключённые устройства принадлежат группе xingxing. Или --owner=panpan@gmail.com, чтобы указать, что они принадлежат panpan.

Нажав на выпадающее меню навигации, а затем на «Информация о пользователе», вы получите токен для личного использования или управления группой. (В настоящее время функция управления группами отсутствует.)

Права администратора

По умолчанию первый пользователь, вошедший в систему, становится администратором.

Какие привилегии есть у администратора?

1. Может освободить устройство, которое использует другой человек. (Удерживая ALT, дважды нажмите кнопку «Используется».)
2. Может использовать личность другого человека для доступа к устройству. (См. API-документы.)
3. Может получить информацию об источнике устройства. (См. API-документы.)
4. Может сделать другого пользователя администратором. (На панели навигации появится ссылка «Управление бэкэндом».)
5. Имеет право изменять поле «Код актива».

Руководство по эксплуатации

Мышь:

• Right-Click: BACK
• Middle-Click: HOME

Разработчики

В настоящее время используется tornado + rethinkdb.

Структура каталогов основана на django, большая часть кода использует асинхронные функции.

|-- static  静态目录
|-- templates 前端界面
|-- web  网页代码
      |-- urls.py 路由整合文件
      |-- settings.py 配置文件
      |-- database.py 数据库操作相关
      |-- utils.py 常用配置
      |-- views 每个界面的逻辑
        |-- slave.py 与atxslave通信用
        |-- device.py 设备相关路由
        |-- base.py 基于RequestHandler的基类

Интерфейс

Подробности см. в разделе REST API (API.md).

Примеры:

• Установка приложения и запуск теста uiautomator2

Установка watchdog

watchdog требует поддержки gcc.

Спасибо

• https://github.com/openstf
• https://github.com/Genymobile/scrcpy
• https://www.easyicon.net
• https://github.com/mikusjelly/apkutils
• https://github.com/gtsystem/python-remotezip
• https://github.com/willerce/WhatsInput

ЛИЦЕНЗИЯ

MIT