一、基础环境安装配置准备
1.1 安装Homebrew工具
(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
检验:
$ brew -v
提示Homebrew版本,则表示安装完成。
1.2 安装node.js
建议通过官网下载安装,打开https://nodejs.org/dist/,选择合适的版本(14.1.0)进行下载安装。
安装完成打开电脑终端,执行:
$ node -v
v14.1.0
$ npm -v
6.14.4
OK,node环境安装完成。
1.3 安装Android-SDK
一、安装sdk
1、安装好brew后,通过以下命令进行sdk的安装
brew install android-sdk
2、查看是否已安装成功,在终端执行:android
二、配置sdk
1、查看sdk安装路径
brew list android-sdk
2、配置sdk环境变量
(1)进入.bash_profile文件
sudo vim .bash_profile
(2)配置环境变量
export ANDROID_HOME=/opt/homebrew/Caskroom/android-sdk #注意:⚠️这个是sdk的安装路径,根据步骤1查看到的路径写。
export PATH=ANDROID_HOME/tools
export PATH=ANDROID_HOME/platform-tools
(3)输入:source ~/.bash_profile,使配置立即生效
adb version
1.4 安装python3
brew install python3
1.5 安装Carthage:
brew install Carthage
二、安装rethinkdb
2.1 安装rethinkdb
brew install rethinkdb
2.2 启动rethinkdb
rethinkdb
三 、安装atxserver2
3.1 下载ATX2项目文件到本地
下载地址:https://github.com/openatx/atxserver2
3.2 安装依赖
打开命令终端切换到该目录下,然后执行命令 pip3 install -r requirements.txt
3.3 启动服务,命令如下:
默认方式启动,使用默认的登录方式,默认端口
python3 main.py
指定认证方式启动
python3 main.py --auth simple #默认是一个非常simple的认证,输入邮箱就可以
设置监听端口启动
python3 main.py --port 4000 # 默认监听4000端口
打开页面
启动之后,浏览器打开http://localhost(本机ip也可以):4000,登录之后就可以顺利的看到设备列表页了,由于还没有接入设备所以设备列表为空。
四、接入Android设备
4.1 下载atxserver2-android-provider项目文件到本地
下载地址:https://github.com/openatx/atxserver2-android-provider
4.2安装依赖
cd atxserver2-android-provider
npm install
准备Python虚拟环境(可选)
python3 -m venv venv
. venv/bin/activate
安装依赖
pip install -r requirements.txt
启动
需要指定atxserver2的地址, 假设地址为 http://localhost:4000
python3 main.py --server localhost:4000
命令行参数
--port 本地监听的端口号
--server atxserver2的地址,默认localhost:4000
--allow-remote 允许远程设备,默认会忽略类似10.0.0.1:5555的设备
--owner, 邮箱地址或用户所在Group名,如果设置了,默认连接的设备都为私有设备,只有owner或管理员账号能看到
五、接入iOS设备
4.1 安装WebDriverAgent
4.1.1 下载WebDriverAgent项目文件到本地
WDA(WebDriverAgent)是适用于iOS的WebDriver服务器实现,可用于远程控制iOS设备允许启动和终止应用程序,点击和滚动视图或确认屏幕上的视图存在。
下载地址:https://github.com/appium/WebDriverAgent
4.1.2 初始化WDA
进入到WebDriverAgent目录,使用如下命令初始化WDA,该脚本会使用Carthage下载所有的依赖,使用npm打包响应的js文件
brew install carthage
./Scripts/bootstrap.sh
4.1.3 使用Xcode将WebDriverAgent应用安装到手机上
4.2 安装atxserver2-ios-provider
4.2.1 安装libimobiledevice工具包
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 ideviceinstaller
brew link --overwrite ideviceinstaller
4.2.2 下载atxserver2-ios-provider项目文件到本地
下载地址:https://github.com/openatx/atxserver2-ios-provider
cd atxserver2-ios-provider
4.2.2.1 安装依赖
pip3 install -r requirements.txt
npm install # 如遇到错误,请检查是否是NodeJS 8
4.2.2.2 启动
安装tidevice
pip3 install -U "tidevice[openssl]"
检查 tidevice 可用
tidevice -v
启动应用
SERVER_URL="http://localhost:4000" # 这里修改成atxserver2的地址
WDA_BUNDLE_PATTERN="WebDriverAgent" # WDA bundle id 通配符
python3 main.py -s WDA_BUNDLE_PATTERN