乐于分享
好东西不私藏

appium 环境搭建(二)

appium 环境搭建(二)

一、Appium 生态核心工具详解

先明确每个工具的作用、定位和使用场景:

工具名称
核心作用
使用场景
ADB(Android Debug Bridge)
Android 官方调试桥,是电脑与 Android 设备(真机 / 模拟器)通信的核心工具
1. 查看已连接的设备(adb devices);2. 连接模拟器(adb connect);3. 安装 / 卸载 App;4. 获取设备日志 / 应用包名等
Appium Desktop
可视化桌面工具,内置「Appium Server」和「Appium Inspector」(元素定位器)
1. 快速启动 / 停止 Appium 服务;2. 可视化定位 App 元素(新手必备);3. 调试脚本时查看元素属性
Appium Server
Appium 的核心服务端(命令行版)
接收客户端脚本的指令,翻译成移动端可执行的操作,是脚本与设备通信的中间层;可通过命令行启动(appium
Appium Client
各编程语言的客户端库(Python/Java/JS 等)
编写自动化脚本时,通过 Client 库连接 Appium Server,发送操作指令(如启动 App、点击元素)
AppCrawler
自动化遍历测试工具
自动遍历 App 的所有页面和元素,快速发现 UI / 功能问题,无需编写大量脚本

二、Windows 系统 Appium 环境搭建(详细步骤)

环境搭建的核心是配齐「Java+Android SDK+Appium Desktop+Python+Appium Python Client + 模拟器」,且所有组件需配置环境变量,步骤如下:

步骤 1:安装 Java 1.8(必装,Android SDK 依赖)

①,下载地址:

官网下载 JDK 1.8(https://www.oracle.com/java/technologies/downloads/#java8-windows),选择对应系统版本(Windows x64 Installer)。

②,安装:

双击安装包,按向导完成安装(建议安装路径不要有中文 / 空格,如D:\Java\jdk1.8.0_301)。

③,配置环境变量:

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 「系统变量」中新建:
    1. 变量名:JAVA_HOME,变量值:JDK 安装路径(如D:\Java\jdk1.8.0_301
  3.  编辑「Path」变量,新增 2 条:
    1. %JAVA_HOME%\bin
    2. %JAVA_HOME%\jre\bin
4. 验证:
    打开 CMD,输入java -version,输出 Java 1.8 版本信息即成功。

步骤 2:安装 Android SDK(或 Android Studio,推荐后者)

Android SDK 是操作 Android 设备的核心依赖,直接安装 Android Studio 会自动配套 SDK,更省心:

1.下载 Android Studio:

官网(https://developer.android.com/studio)下载最新版,双击安装。

2.安装与配置 SDK

  1. 安装时勾选「Android SDK」选项,安装路径建议无中文(如D:\Android\Sdk)。

  2. 安装完成后,打开 Android Studio→「More Actions」→「SDK Manager」:

    1. 选择对应 Android 版本的 SDK Platform(如 Android 6.0/7.0,与模拟器版本匹配)。

    2. 勾选「SDK Tools」中的「Android SDK Build-Tools」「Android SDK Platform-Tools」(包含 ADB),点击「Apply」安装。

3. 配置环境变量:

  1. 系统变量新建:ANDROID_HOME,值为 SDK 安装路径(如D:\Android\Sdk)。

  2. 编辑「Path」变量,新增 2 条:

    1. %ANDROID_HOME%\platform-tools(ADB 所在路径)

    2. %ANDROID_HOME%\tools

4. 验证

CMD 输入adb version,输出 ADB 版本信息即成功。

步骤 3:安装 Appium Desktop

  1. 下载

    GitHub Releases(https://github.com/appium/appium-desktop/releases),选择 Windows 版本(.exe 安装包)。

  2. 安装

    双击安装包,按向导完成(路径无中文),安装后桌面会生成快捷方式。

步骤 4:安装 Python 3

  1. 下载

    官网(https://www.python.org/downloads/windows/)下载 Python 3.7+(推荐 3.8/3.9,兼容性好)。

  2. 安装

    1. 勾选「Add Python 3.x to PATH」(自动配置环境变量)。

    2. 选择「Customize installation」,安装路径建议无中文(如D:\Python38)。

  3. 验证

    CMD 输入python –version,输出 Python 版本信息即成功。

步骤 5:安装 Appium Python Client(Python 版客户端库)

有 2 种方式,推荐方式一(更简单):

方式一:pip 安装(推荐)

打开CMD,输入

pip install appium-python-client

(若提示 pip 版本低,先执行python -m pip install –upgrade pip)

方式二:手动安装(备用)

  1. 下载源码:GitHub(https://github.com/appium/python-client)或 PyPI(https://pypi.org/project/Appium-Python-Client/#files)。

  2. 解压到本地(如D:\python-client-master)。

  3. CMD 进入解压目录(cd D:\python-client-master),执行:

    python setup.py install

4. 验证:

CMD 输入python -c “import appium; print(appium.__version__)”,输出版本号即成功。

步骤 6:安装 MuMu 模拟器(可选,无真机时用)

  1. 下载

    官网(https://mumu.163.com/)下载 Windows 版模拟器,安装(路径无中文)。

  2. 启动模拟器

    打开 MuMu 模拟器,等待完全启动(进入主界面)。

  3. 连接模拟器

    CMD 输入adb connect 127.0.0.1:7555(MuMu 模拟器默认端口 7555),提示「connected to 127.0.0.1:7555」即成功。

三、环境验证(核心步骤,确保所有组件正常工作)

按以下步骤验证,确保能成功启动 App 并执行脚本:

步骤 1:启动 Appium Desktop 服务

  1. 打开 Appium Desktop,默认端口是 4723(无需修改)。

  2. 点击「Start Server」按钮,若控制台无红色报错(显示「Appium REST http interface listener started on 0.0.0.0:4723」),说明服务启动成功。

步骤 2:确认设备连接

  1. 确保模拟器 / 真机已连接电脑:

    1. 模拟器:已执行adb connect 127.0.0.1:7555。

    2. 真机:开启「开发者选项」→「USB 调试」,用数据线连接电脑。

  2. CMD 输入adb devices,输出列表中能看到设备名称(如127.0.0.1:7555 device),说明设备连接成功。

步骤 3:编写并运行验证脚本

新建appium_test.py文件,粘贴以下代码(注释已补充关键说明):

from appium import webdriverimport time# 配置设备和应用信息(Desired Capabilities)desired_caps = {}# 指定平台类型(Android/iOS)desired_caps['platformName'] = 'Android'# 设备系统版本(可在模拟器设置中查看,如MuMu默认6.0)desired_caps['platformVersion'] = '6.0'# 设备名称(adb devices输出的名称,如127.0.0.1:7555)desired_caps['deviceName'] = '127.0.0.1:7555'# 要启动的App包名(设置应用的包名)desired_caps['appPackage'] = 'com.android.settings'# 要启动的App主Activity(设置应用的主界面)desired_caps['appActivity'] = 'com.android.settings.Settings'# 可选:防止App重启动(新手可加)desired_caps['noReset'] = Truetry:    # 连接Appium Server,启动应用    driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)    print("✅ 成功启动【设置】应用")    # 等待5秒,查看模拟器是否打开设置界面    time.sleep(5)except Exception as e:    print(f"❌ 启动失败:{e}")finally:    # 关闭应用    driver.quit()    print("✅ 已关闭应用")

步骤 4:运行脚本

  1. 打开 CMD,进入脚本所在目录(如cd D:\test)。

  2. 执行命令:python appium_test.py。

  3. 预期效果:

    1. 模拟器自动打开「设置」应用,5 秒后关闭。

    2. CMD 输出「✅ 成功启动【设置】应用」「✅ 已关闭应用」,无报错。

四、Mac 系统环境搭建补充(核心差异)

Mac 版搭建逻辑与 Windows 一致,仅以下几点不同:

  1. Java/Android SDK 安装:

    1. Java 1.8 可通过brew install openjdk@8安装(需先装 Homebrew)
    2. Android Studio 安装后,SDK 路径默认在/Users/你的用户名/Library/Android/sdk。
2. 环变量配置:

打开终端,编辑.bash_profile或.zshrc文件(如vim ~/.zshrc),添加:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Homeexport ANDROID_HOME=/Users/你的用户名/Library/Android/sdkexport PATH=$PATH:$JAVA_HOME/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools
3.MuMu 模拟器连接:

Mac 版 MuMu 模拟器默认端口仍是 7555,连接命令相同:adb connect 127.0.0.1:7555。

总结

  1. 核心依赖:Appium 环境搭建的关键是配齐「Java 1.8+Android SDK+Appium Server + 对应语言 Client」,且必须配置环境变量。

  2. 验证逻辑:先确保 Appium Server 启动无报错,再确认设备连接正常,最后通过脚本验证能否启动 App。

  3. 关键注意点:所有安装路径避免中文 / 空格,设备版本、包名 / Activity 需与实际设备匹配,否则脚本会报错。

本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » appium 环境搭建(二)

评论 抢沙发

2 + 8 =
  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
×
订阅图标按钮