前言:众所周知,万事开头难,而环境搭建就是我们的第一道坎,在版本选择及配置时总会遇到各种问题。这篇我尽可能详细的介绍了搭建过程中的步骤,希望对你有所帮助。
注意 appium已经更新到2.0版本了,文中下载的appium server gui仅支持1.x的版本,并且官方以后也不再进行维护升级,因此建议使用官方文档中的方法在命令行安装Appium。
目录
一、环境部署简图
基本工作流程就是:脚本访问 Appium 代理服务器 -->Appium 代理服务器将脚本的指令转化为手机端可以识别的内容发给我们手机 --> 手机运行之后将相关结果返回给 Appium–>Appium 最终将指令执行的结果返回给脚本。
二、Python 基础环境搭建
2.1、安装 Python
- 打开 Python 官网 Welcome to Python.org,点击 Download,下载最新版本的 Python。(Note:我用的是 Python 3.9.7,是之前装的。)
- 安装时记得第一个页面勾选 “Add python to PATH”,点击"install now",当出现 successful 时即安装完成。
- 安装完成之后,在 cmd 中输入 “python”, 如果能看到 Python 的版本号就说明安装成功。
2.2、安装 pycharm
- 打开 pycharm 官网 PyCharm: the Python IDE for Professional Developers by JetBrains,点击 download 会跳转到安装页面,下载免费的 community 社区版。
- 双击安装。
三、配置 JDK+SDK
由于 SDK 是使用 Java 语言编写的,所以它依赖于 JDK,我们需要首先安装 JDK 并配置 JDK 的环境。
3.1、配置 JDK
🍓3.1.1、下载 JDK
从官网 (点击跳转) 下载最新 JDK 的版本,但是官网下载 JDK 现在比较麻烦,且官网速度较慢,需要注册登录账号后才能下载。(我用的是 JDK1.8.0_321,就不换了)
Note: 当然我也是发现一个宝藏网址:JDK 下载 - 编程宝库 (codebaoku.com),可以找到自己想要的版本直接下载,很方便。
🍓3.1.2、安装 JDK
双击安装下载好的 exe 文件,过程默认安装即可。
🍓3.1.2、配置 JDK 环境变量(Win11)
新建 JAVA_HOME 以及添加 Path 路径
💡1、新建一个系统环境变量 JAVA_HOME
右键点击此电脑,点击属性
在弹出的系统设置界面选择高级系统设置,在打开的高级面板中然后选择环境变量
在系统环境变量下面新建 JAVA_HOME 变量,地址是之前安装 JDK 时候的默认路径。
变量名:JAVA_HOME
变量值:为你 JDK 的位置(即 jdk 安装位置)C:\Program Files\Java\jdk1.8.0_181
💡2、编辑变量名 “Path”
在原变量值的最后面加上 C:\Program Files\Java\jdk1.8.0_181\bin 或者 %JAVA_HOME%\bin 都行。
🍓3.1.3、检查安装是否成功
打开 cmd 窗口,输入 java -version 可以显示我们下载的版本号,输入 javac 有内容输出,就基本配置成功了。
3.2、配置 SDK
🍓3.2.1、下载 AndroidSDK
目前想要去官网下载的话,只有谷歌官网能下载包含有 Android SDK 的 Android Studio,但是谷歌需要 FQ 才能访问。
而我们这里使用 Appium 的话,只需要用到 SDK Tools 而已,所以推荐大家去国内的 Android 工具下载网站 AndroidDevTools 去下载。
🍍①进入国内下载网站,点击**【Android SDK 工具】按钮,在下拉选项中选择【SDK Tools】**,会自动跳转到 SDK 的下载界面。
🍍②选择一个最新的版本下载 (好像也就只有一个比较正常的版本…),注意我们下载的是 zip 压缩包。
🍍③解压刚刚下载的压缩包到指定路径,我就把它放在 D 盘根目录了,注意路径中不能有中文,解压后的文件目录如下:
🍓3.2.2、安装 Android SDK
接下来我们需要双击启动 “SDK Manager.exe”,下载一些必要组件,启动界面如下:
🍍①勾选组件,基本都是默认勾选的。
💦Tools 文件夹下默认勾选三项‘Android SDK Tools’,‘Android SDK Platform-tools’,‘Android SDKBuild-tools(默认勾选版本最新)’
💦API 默认勾选最新的即可,因为 Android 是向下兼容的。版本号带 rc 字样的是预览版
Android R 是预览版,Android 10 是最新版,都是默认勾选的。
💦Extras 文件夹下,一开始安装的话可以勾选两个‘Android Support Repository’’和‘Google USB Driver’。注意:有一个不是默认勾选的需要手动勾选。(理论上来说,extras 中的东西如果网速允许,时间充沛的话,可以都下载,因为都是好东西,或者以后有时间再慢慢下载。)
🍍②点击上图’Install 19 packages’,在弹出框中将左边全都选择 Accept License,然后点击 Install
💦等待下载进度条完成,安装成功的组件会显示 Installed,安装失败的仍然显示 Not installed。
**🍍③由于这些东西是在 Google 的服务器上下载的,可能会因网速下载失败,会跳出报错 log,不过不影响下载进度,可以等待其他组件下载完成后再重新多下载几次那几个下载失败的。**如图:
Note:可以尝试切换热点或其他网速较快的网络。(流量少的就不用试了,文件很大,毫不知情的我下完一看直接用了 18 个 G😭,吓得我赶紧关了。)
❗️如果一直下载失败,可以尝试换成其他有 Android SDK 的国内镜像服务器来下载安装,推荐几个镜像地址:
1、中科院开源协会镜像站地址:
IPV4/IPV6 : http://mirrors.opencas.ac.cn 端口:80
2、北京化工大学镜像服务器地址:
IPv4: http://ubuntu.buct.edu.cn/ 端口:80
IPv4: http://ubuntu.buct.cn/ 端口:80
IPv6: http://ubuntu.buct6.edu.cn/ 端口:80
3、大连东软信息学院镜像服务器地址:
🌿举一个例子,比如使用第三个大连东软的镜像地址,使用方法如下:
💦点击菜单栏【Tools】–>【Options】:
💦在弹出的对话框中,
- 【HTTP Proxy Server】填写的是镜像地址:mirrors.neusoft.edu.cn(注意前面不要加 http)
- 【HTTP Proxy Port】填写的是端口号:80
- 最后勾选下面的【Forcehttps://… sources to be fetched using http://…】复选框,如下图
💦接着点击 close,关闭对话框,再重新启动 SDK Manager 应该就会开始安装了。
**Note:**但是我在下载 android-R 时一直报错,换下载地址也不行,但是应该不影响配置,可以先略过。
🍍④最后下载成功之后的文件目录是这样的:
🍓3.2.3、配置 SDK 环境变量
新建 ANDROID_HOME 以及添加 Path 路径
**💡1、**新建一个系统环境变量 **ANDROID_HOME,**变量值为 SDK 安装路径
💡2、添加 Path 路径,这里需要添加**”\platform-tools“和”\tools”** 路径:
🍓3.2.3、检查安装是否成功
打开 cmd 窗口,输入 adb 命令,可以输出可以执行命令,说明前面的配置没有问题
四、配置 Appium
这里需要配置两样东西,一个是 Node,一个是 Appium。
4.1、安装 Node
Appium 测试工具是用 Node 语言编写的,所以需要把工具支持的语言包装上。
🍓4.1.1、下载并安装 Node
1、百度搜索 Node 即可,进入官网 Node.js (nodejs.org) 下载最新的 LTS(长期支持)版本,点击 Windows Installer(.msi) 对应的 64-bit 安装包。
2、双击刚刚安装的 node-v16.14.2-x64.msi,安装过程默认即可
🍓4.1.2、配置 Node 环境变量
添加 Path 路径:添加 Node 安装路径,默认安装路径为 C:\Program Files\nodejs
查看 Path 的时候发现已经被默认添加了,但还是需要检查一下,如果没加的话就手动添加一下。
🍓4.1.3、检查安装是否成功
打开 cmd 窗口,输入 node --version,能输出版本号,说明配置成功。
4.2、安装 Appium Server
🍓4.2.1、下载 Appium 1.22.2
下载地址 https://github.com/appium/appium-desktop/releases,找到 latest 版本下载 exe 安装包。
🍓4.2.2、安装 Appium
1、双击刚刚下载的 Appium-Server-GUI-windows-1.22.2.exe。
2、勾选所有用户,然后点击安装
3、等待安装完成,最后不要勾选运行选项,点击完成。默认的安装路径是在 C:\Program Files\Appium Server GUI
🍓4.2.3、检查安装是否成功
1、安装完成之后,桌面图标是这样的
2、双击打开,暂不改配置,只是验证一下安装是否成功。点击 Start Service.。
3、看到如下界面,说明安装没啥问题
4.3、安装 Appium Inspector
在 Appium1.22.2 中版本服务和元素查看器分家了,查看元素信息就必须下载 Appium Inspector
1、点击 Inspector 按钮会自动跳转到该网页 https://github.com/appium/appium-inspector,页面如下:
2、往下滑动,找到 Installation,点击 Releases。
3、下载 Latest 的版本,找到 exe 包,点击下载。
4、双击安装下载的 Appium-Inspector-windows-2022.2.1.exe。
5、安装成功之后桌面图标是
6、双击打开的界面如下,说明安装没问题。
4.4、安装 Appium-Python-Client
🍓4.4.1、pip 在线安装
打开 cmd 窗口,输入:pip install Appium-Python-Client,耐心等待安装完成。
**Note:**如果出现 time out 就换个热点吧。
🍓4.4.2、验证
打开 pycharm,新建一个 python 文件,输入 from appium.webdriver.webdriver import WebDriver 不报错说明 pip 安装成功。
**Note:**如果使用的是虚拟的 Python interpreter,那就在 pycharm 中重新导入一下类库,因为 pip 安装的是在本地。
五、安装模拟器
采用一款即适合小白又适合开发者使用的一款比较快的 Android 模拟器 Genymotion。当然夜神啥的也可以。
5.1、安装 Genymotion
官网下载地址:https://www.genymotion.com/download/。
💕1、点击链接进入官网下载(目前最新的是 3.2.1),因为 Genymotion 的运行需要依赖 VirtualBox 虚拟机,所以如果之前没有安装的话,可以选择第二个 with VirtualBox 的安装包。
💕2、双击安装 genymotion-3.2.1-vbox.exe,选择安装路径,可默认,点击 Next。
💕3、选择 Start Menu 文件目录,可默认,点击 Next。
💕4、创建桌面快捷方式,点击 Next。
💕5、确认信息,点击 Install,等待安装进度。
💕6、因为下载的安装包含有 VirtualBox,所以在安装过程中会自动跳出安装 VirtualBox 的操作界面,点击下一步。
💕7、选择安装功能及路径,可默认,点击下一步。
💕8、选择安装功能,默认勾选,点击下一步。
💕9、警告界面,点击是。
💕10、点击安装,就会开始安装了
💕11、期间会需要安装一个驱动程序,点击安装,否则会导致安装失败。
💕12、等待安装过程完成,VirtualBox 安装成功界面如下,点击完成。
💕13、Genymotion 安装成功界面如下,到此安装就算完成了。
Note:因为之前有装驱动,所以记得重启一下电脑,否则后面启动模拟机型时会报错。
5.2、注册 Genymotion
1、打开 Genymotion,点击右下角的 create account,会跳转到官网注册页面。或者点击链接 https://www-v1.genymotion.com/account/create/
2、填写注册信息
- email 和 password 自己填写
- Usage type:按需填写。因为我是要做测试,所以选了一个 Development and testing
- Company type:按需填写。因为我是个人使用,就选择 other 就行了。
- Country:选择 China。
- 勾选下面三个复选框,然后点击 create
3、之后去邮箱激活一下就行。
4、第一次打开,提示需要输注册码,我们这里选择 “personalUse”,这样就可以不用输入注册码,直接登录我们一开始在 genymotion 官网注册的账号就行。
5、登录之后的界面如下:
到这,Appium 的环境搭建算是基本完成了。下一篇再将其运用到实际操作中。