Skip to content

Latest commit

 

History

History
192 lines (134 loc) · 5.54 KB

README.md

File metadata and controls

192 lines (134 loc) · 5.54 KB
Raw

基于openstf二次开发的群控管理平台

English | 中文

| 本项目根据openstf以及openstf-ios二次开发。同时支持Android/iOS单体控制以及群体控制。
| 本项目可以兼容Linux/Mac，利用最新开源的tidevice实现wda快速编译运行，不一定需要Mac设备的支持，体验不一样的openstf.

  • 单控: 基于原生的openstf，操作便捷可使用文件安装，shell、剪贴板、日志等功能；
  • 群控: 批量支持机器同屏展示，一键home/移除等功能；

ScreenShot

快速开始

仅需两步快速安装 （Mac）：

  1. 准备一台 Mac 主机；

  2. 安装 brew 以及nodejs，运行以下命令
    pip3 install -U tidevice
    brew uninstall --ignore-dependencies libimobiledevice
    brew uninstall --ignore-dependencies usbmuxd
    brew install --HEAD usbmuxd
    brew unlink usbmuxd
    brew link usbmuxd
    brew install --HEAD libimobiledevice
    brew install --HEAD ideviceinstaller
    brew install carthage
    brew install socat
    brew install graphicsmagick zeromq protobuf yasm pkg-config
    brew cask install android-platform-tools

  3. 进入本项目目录,执行 cnpm install 或者 npm install

  4. 如需使用ios接入，配置WebDriverAgent,clone代码，clone完毕后进入目录，执行./Scripts/bootstrap.sh 下载 wda所需依赖库 安装xcode（版本< 10.3）,运行WebDriverAgent

  5. 如运行错误，检查stf doctor

Linux(centos):

  1. 基础环境准备
    pip3 install -U tidevice
    sudo -s
    yum update
    yum install git
    yum install yum
    yum -y install gcc patch yum install gcc-c++
    yum install gcc-gfortran
    yum install zeromq-devel

  2. 安装rethinkdb
    git clone https://github.com/rethinkdb/rethinkdb.git cd rethinkdb ./configure --allow-fetch make -j4 make install

    安装GraphicsMagick

    wget https://iweb.dl.sourceforge.net/project/graphicsmagick/graphicsmagick/1.3.36/GraphicsMagick-1.3.36.tar.gz
    tar -zxvf GraphicsMagick-1.3.36.tar.gz
    cd GraphicsMagick-1.3.36
    ./configure --prefix=/usr/local/gm
    make
    make install

    安装zeromq

    wget https://github.com/zeromq/libzmq/releases/download/v4.2.2/zeromq-4.2.2.tar.gz
    tar zxvf zeromq-4.2.2.tar.gz
    cd zeromq-4.2.2
    ./configure --prefix=/usr/local/zeromq
    make
    make install

    安装pkg-config

    wget http://pkgconfig.freedesktop.org/releases/pkg-config-0.29.2.tar.gz
    tar -zxvf pkg-config-0.29.2.tar.gz
    cd pkg-config-0.29.2
    ./configure --prefix=/usr/local/pkg-config --with-internal-glib
    make
    make intall

    安装yasm

    wget http://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz
    tar -zxvf yasm-1.3.0.tar.gz
    cd yasm-1.3.0
    ./configure --prefix=/usr/local/yasm
    make
    make install

    安装libsodium

    wget https://download.libsodium.org/libsodium/releases/libsodium-1.0.18.tar.gz
    tar -zxvf libsodium-1.0.18.tar.gz cd libsodium-1.0.18 ./autogen.sh
    ./configure --prefix=/usr/local/libsodium
    make
    make install

    安装protobuf

    wget https://github.com/google/protobuf/releases/download/v3.5.0/protobuf-cpp-3.5.0.tar.gz
    tar -zxvf protobuf-cpp-3.5.0.tar.gz
    cd protobuf-3.5.0
    ./configure --prefix=/usr/local/protobuf
    make
    make intall

    软链接

    ln -s /usr/local/gm/bin/* /usr/local/bin/
    ln -s /usr/local/yasm/bin/* /usr/local/bin/
    ln -s /usr/local/libsodium/bin/* /usr/local/bin/
    ln -s /usr/local/protobuf/bin/* /usr/local/bin/

    更新/etc/profile

    export PKG_CONFIG_PATH=/usr/local/pkg-config export PATH=$PKG_CONFIG_PATH:$PATH

    安装libimobiledevice、ideviceinstaller
    git clone https://github.com/libimobiledevice/libimobiledevice.git
    cd libimobiledevice
    ./autogen.sh --prefix=/opt/local --enable-debug
    make
    sudo make install
    git clone https://github.com/libimobiledevice/ideviceinstaller.git
    cd ideviceinstaller
    ./autogen.sh
    make
    sudo make install

  3. cd到目录执行cnpm install或者npm install + glup build

相关工具

测试使用版本

  • macOS Catalina 10.15.6
  • CentOS Linux release 7.8.2003 (Core)
  • xcode (10.0)
  • nodejs (8.9.0)
  • python (3.7.6)

产品优势

  • 开源：基于开源、只要你敢点赞，我就会一直迭代下去，遇到bug或建议请提issue；

技术栈

  • angularJS ，nodejs

致谢

  • openstf：感谢 openstf 作为基础引擎
  • stf：感谢 mrx1203 提供的iOS设计思路
  • tidevice：感谢 阿里 开源的iOS设备通信工具

如果觉得好用的话，请给我点个star，推荐chrome游览器，显示体验更佳，开源不易且赞且珍惜。

License & Copyright

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.