最新macos平台搭建基于Appium的IOS测试环境超详细

最新推荐文章于 2025-09-05 20:17:01 发布
原创 最新推荐文章于 2025-09-05 20:17:01 发布 · 3.3k 阅读 · 14 ·
CC 4.0 BY-SA版权
本文为博主原创文章版权归作者和优快云共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
文章标签：

#Appium #ios真机测试

本文详细介绍如何使用AppiumDesktop 1.15.0搭建iOS测试环境，包括安装AppiumDesktop、Xcode、JDK、brew、Node、ruby、git、carthage等工具，以及解决过程中遇到的问题。

说在前面的话

之前公司需要搭建一款Appium的ios测试环境，网上的也有不少相关教程，但是都基本都是早期的版本，此次将会使用最新版的·Appium Desktop 1.15.0 来总结此次搭建途中遇到的坑，希望可以帮助后面需要搭建此环境的同学们。

安装步骤

  • Appium Desktop
    截止今天最新版的版本是1.15.0，Appium-Desktop 如下图所示：
    在这里插入图片描述
    下载mac os平台的 appium，然后进行一路Next安装即可。
  • Xcode：10.3
    这里博主的mac系统版本为10.14.6如下图所示：
    在这里插入图片描述
    这里不建议使用最新版的mac catalina,笔者在此系统上遇到xcode编译项目失败的问题，而此版本的macos的xcode不存在此问题，因此下载此版本对应的Xcode版本即可，首先进入链接https://developer.apple.com/download/more/ 进入页面并使用apple id登录后可以看到如下画面：
    在这里插入图片描述
    找到并下载Xcode 10.3 以及对应版本的Command line Tools for Xcode如下图所示：
    在这里插入图片描述
    下载完毕后，先将Xcode 10.3.xip解压后的程序移动到mac的应用程序目录即可，然后在安装dmg文件。
  • JDK：1.8
    关于JDK安装可以参考我之前写过的一篇文章JDK安装教程 进行安装即可,然后配置一下JDK的环境变量即可，如下图所示：
    在这里插入图片描述
  • brew
    brew 是 Mac 下的一个包管理工具,类似于 centos 下的 yum，可以进行软件的安装、更新以及卸载等操作。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装过程如下图所示：
在这里插入图片描述
安装后查看安装brew版本：
在这里插入图片描述

  • Node
    AppiumDesktop是用Node.js编写的服务器，所以需要安装node。若你的电脑安装有brew环境直接输入下面命令行即可进行node的安装。
brew install node

完成执行node -v,查看安装node版本：
在这里插入图片描述
其中 NPM是Node.js包管理工具，下载安装Node.js会自动安装NPM,可以查看一下NPM的版本：
在这里插入图片描述

  • ruby
    一般macos自带ruby，如果没有请安装ruby环境，查看ruby的环境版本:
    在这里插入图片描述
  • git
    由于许多组件下载都需要git进行相关组件下载，这里也需要进行git的安装
brew install git
  • carthage
    类似于 java 的 maven，项目依赖管理，主要是 WebDriverAgent 使用
brew install carthage

在这里插入图片描述

  • npm appium doctor
    这个是检查Appium环境的一套组件，终端执行下面命令：
sudo npm install appium-doctor -g

在这里插入图片描述
安装完成后，终端输入下面命令以检查appium所需要的环境是否齐全。

 appium-doctor

有可能出现下面的错误✖ Error running xcrun simctl如下图所示：
在这里插入图片描述
解决方法：打开Xcode软件选中 Xcode>preferences>Locations里面，设置之后再重新运行检查命令即可。
在这里插入图片描述
在这里插入图片描述
这里有报错提升是由于安装是基于IOS版本的，所以android的SDK环境暂未下载。需要注意的是：网上有很多关于Face book的WebDriverAgent项目，但是这些项目已经很老且很久没有维护，而且存在很多的问题。这里推荐使用Appium Desktop自带的WebDriverAgent项目即可，打开Appium-Desktop的WebDriverAgent项目的路径
目录如下所示：

/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-webdriveragent

将目录copy到桌面。进入WebDriverAgent项目的根目录下执行下面命令：

# 进入到WDA 根目录
cd WebDriverAgent/
# 运行初始化脚本
./Scripts/bootstrap.sh

在这里插入图片描述

  • ideviceinstaller
brew install ideviceinstaller

在这里插入图片描述

  • ios-deploy
    -ios-deploy是一个终端安装和调试iPhone应用的是第三方开源库
npm install -g ios-deploy

查看连接的设备：

ios-deploy -c

运行WebDriverAgent

上面的环境搭建好后,打开桌面的appium-webdriveragent的WebDriverAgent.xcodeproj文件
在这里插入图片描述
打开后需要做的就是配置Xcode的account添加你的apple Id,可以通过下面操作进行配置如下图所示：

  • 打开首选项

在这里插入图片描述

  • 添加apple id
    在这里插入图片描述
    配置这个原因是WebDriverAgent需要配置个人证书，通过我们的apple Id即可以生成。
  • 配置WebDriverAgentLib
    在这里插入图片描述
  • 配置WebDriverRunner
    在这里插入图片描述
    但是有可能会提示问题：
The app ID "com.facebook.WebDriverAgentRunner" cannot be registered 
to your development team. Change your bundle identifier
to a unique string to try again.

解决方法：WebDriverAgentRunner -> Build Settings设置中，找到Packaging中的选项，将其内容修改为唯一识别的字符串。
在这里插入图片描述
修改完毕后就不报错了。
在这里插入图片描述

  • iphone连接设置
    在这里插入图片描述
    选择 Proudct->Test如下图所示：
    在这里插入图片描述
    注意问题：This iPhone 7 (Model 1660, 1778, 1779, 1780) is running iOS 13.1.2 (17A860), which may not be supported by this version of Xcode. 如下图所示：
    在这里插入图片描述
    github下载相应版本IOS设备支持 IOS设备支持地址 如下图所示：
    在这里插入图片描述
    下载完成后将安装包解压到路径
    /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport下，如下图所示：
    在这里插入图片描述
    重启Xcode，再次运行Product->Test 运行完成可能会报以下的错误：
This application’s application-identifier entitlement does not match that of the installed application. These values must match for an upgrade to be allowed.

在这里插入图片描述
这是因为手机已经存在了一个WebDriverRunner，删除了app重新在运行就好，再次运行就会报以下错误。

Verify the Developer App certificate for your account is trusted on your device. Open Settings on iPhone and navigate to General -> Device Management, then select your Developer App certificate to trust it.Internal launch error: process launch failed: Security

在这里插入图片描述
解决方法：设置=》通用=》设备管理=》开发者应用=》验证应用 如下图所示：
在这里插入图片描述
点击信任即可如下图所示：
在这里插入图片描述
先删除之前的运行的 Product->Clean Build Folder， 再次运行Product->Test。

  • 安装libimobiledevice
 brew install libimobiledevice --HEAD

安装后可能报下面的这个错误：
在这里插入图片描述
原因是：由于系统要求的libusbmuxd 版本和所要安装的版本不一致的问题导致的，可使用下面命令进行解决。

brew uninstall --ignore-dependencies libimobiledevice
brew uninstall --ignore-dependencies usbmuxd
brew install --HEAD usbmuxd
brew unlink usbmuxd
brew link usbmuxd
brew install --HEAD libimobiledevice

打开控制台方法：选择view->Debug Area->Activate console打开底部控制台。然后控制台会输出IP地址和端口，例如：http://127.0.0.1:8100/status,输入在浏览器中，确认WDA是否运行成功,页面刷新出不来，再次输入下面命令开启代理：

iproxy 8100 8100

然后重新刷新浏览器如下图所示：
在这里插入图片描述

配置Appium-Desktop

在这里插入图片描述

  • 配置JAVA_HOME
    点击Edit Configuration 配置以下环境变量,如下图所示：
    在这里插入图片描述
  • 开启Inspector Session
    在这里插入图片描述
  • 允许未授权认证
    在这里插入图片描述
    通用配置对象如下图所示：
    在这里插入图片描述
    需要注意的是其中获取iphone的uuid，在终端输入：idevice_id -l 即可获取，而bundleId可以通过输入命令：ideviceinstaller -l出现如下图列表：
    在这里插入图片描述

更多配置请参考：https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md

配置完成后点击Start Session的时候报端口占用的错误如下图所示：
在这里插入图片描述
解决方法：重启appium-desktop软件编辑修改ios的WebDriverAgent的端口号入下图所示：
在这里插入图片描述
设置完成后在重新Start Session如果可以看到下面的页面就证明安装已经成功。
在这里插入图片描述

MacOS系统搭建Appium自动化测试环境
xiangzhihong8的专栏
06-16 495
APPium是一个开源测试自动化框架，适用于原生、混合或移动Web应用程序的自动化测试工具。APPium使用WebDriver协议驱动iOS、Android等应用程序。
2024主流技术 Appium+IOS 自动化测试环境搭建_ios自动化测试环境搭建
2401_86950019的博客
09-04 1723
IOS 9.3之后Appium就开始采用WebDriverAgent方案了需要注意的是：目前官方Facebook已经没有在维护WebDriverAgent了，所以如果使用Facebook的WebDriverAgent有可能不适配后续的IOS版本及AppiumAppium项目有内置了WebDriverAgent，而且也在同步修复BUG更新中，所以强烈建议使用Appium内置的WebDriverAgent ：环境部署。
APP自动化(1)——搭建Appium自动化测试平台环境（基于python&android）
qianbingbing的博客
04-11 2000
由于是基于python与android。所以前面的步骤1-3是搭建Android和python的环境的。从步骤4才是搭建Appium环境1、安装并配置JDK，JRE1) 安装JDK,JRE 下载地址： http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html 2) 在环境变量中添加相应的变量名
03-MacOS上搭建Appium的iOS测试环境
小白的博客
03-20 1036
目录 准备环境和文件 相关库安装 验证安装 在 iOS 设备上安装 WebDriverAgent 1. 更新 WebDriverAgent依赖 2.使用 Xcode 打开 WebDriverAgent 项目 3. 在 Xcode 中添加开发者账号 4. 编译 WebDriverAgentLib 5.编译 WebDriverAgentRunner 6. 编译 IntegrationApp： 7.将 WebDriverAgentRunner 安装到 iOS...
全网最详细的Mac下搭建Appium环境文档
最新发布
2301_79535544的博客
09-05 1187
服务端的版本分为，两者有些区别，两者都要安装首先必须有mac电脑，在app store中搜索xcode并安装，安装完成后一定记得打开一次，会自动安装xcode的的一些工具以下步骤均是在mac电脑终端下执行有可能会报错 SSL certificate problem: certificate has expired，那么就执行如下指令后再次执行上述命令执行结果中没有error即可appium如果是ios模拟器，那么webdriveragent无需处理appium版本的webdriveragent源码路径。
mac appium 1.6.4 环境搭建和问题解决详解
07-10
在搭建mac ios自动化 appium 1.6.4 以及调用 facebook webdriveragent框架 详解
移动端自动化测试-Mac-IOS-Appium环境搭建
yuer011的博客
08-12 949
第一步 安装JDK，本机如果带有1.7及以上版本的，则可忽略此安装步骤。 百度下载JDK，并配置环境变量 vim ~/.bash_profile 检查是否安装成功 java -version 第二步 检查brew的版本，brew -v（brew是mac os上的软件包管理工具） 如果Mac不带brew工具，则可以访问下载地址，根据官网操作安装即可。 下载地址：https://brew.sh/index_zh-cn.html 第三步 检查是否安装Git，git --version 如果没有git，则可以通
解决低版本Xcode不支持高版本iOS真机调试
st646889325的博客
04-07 1242
其实每次iOS SDK版本升级都会遇到相同的问题，之前遇到过相同的问题，我都是直接更新Xcode。（提示：要在应用程序中找到Xcode，右键点击 -> 显示包内容，以前Xcode版本的iOS SDK有的保存在系统根目录下）见文知意，主要原因是在调试前我将iOS 升级到了最新版10.2版本，而我的Xcode8.1支持的最高版本是10.1的。我在网上找到了iOS10.2的真机调试包,命名为真机需要的版本10.2(14C89)1、复制一份旧的SDK，并重新命名为真机测试需要的SDK版本。
Appium ios环境搭建
05-14
为了能够在iOS平台上进行自动化测试，首先需要搭建一套完整的Appium测试环境。以下为详细的步骤。 ##### 安装Xcode - **方法一**：直接在Mac App Store搜索“Xcode”并下载安装。 - **方法二**：访问Apple开发者...
灵活运用Appium+Python实现iOS自动化测试~环境搭建
m0_64706429的博客
09-05 2209
Appium是一款开源的跨平台测试自动化工具，适用于本地，混合和移动网络和桌面应用程序。支持模拟器（iOS、Android）和真实设备（iOS，Android，Windows，Mac）。
最新最简单 Mac M1 + Appium + iOS最新真机环境搭建
liuage_的博客
04-24 1191
iii.配置完成使用快捷键（command+u）编译webDriverAgent到真机上，需要编译两次，第一编译需要到真机设置→通用→VPN与设备管理中信任它，第二次编译后有个Automation Running蒙层显示在真机上即成功；它是基于Apple的XCUITest框架构建的，旨在提供更高效、可靠的iOS应用自动化测试体验。Homebrew是一个包管理器，用于管理Mac上安装和管理软件包。本篇文章主要讲解appium2.0之后版本和真机之间的环境搭建，一些其它的环境安装中遇到问题可以去我。
IOS13.1(17A860).zip
11-20
IOS 13.1(17A860)真机调试，大家请下载。 把解压后的镇及调试包 放在 /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport 目录下
xcode配置iOS 13.1 开发包
03-30
将Xcode适配可以调试、编译、运行、打包系统版本号为iOS 13.1 版本的设备，解决"Could not find Developer Disk Image"问题 使用详情 请前往https://blog.youkuaiyun.com/u010731949/article/details/52576792
让xcode支持所有iOS版本的真机调试
zard_0_的博客
08-24 1088
找到新版本的xcode，查看路径： /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport 把旧版本xcode不支持的iOS系统文件夹拷贝到就版本xcode的同样路径里面，重启旧版本xcode，应该就可以了，再不行就clean一下之前build生成的文件。 ...
2022主流技术 Appium+IOS 自动化测试环境搭建
主要分享测试的学习资源，帮助快速了解测试行业，帮助想转行、进阶、小白成长为高级测试工程师。
07-20 3240
其中包括了有基础知识、Linux必备、Shell、互联网程序原理、Mysql数据库、抓包工具专题、接口测试工具、测试进阶-Python编程、Web自动化测试、APP自动化测试、接口自动化测试、测试高级持续集成、测试架构开发测试框架、性能测试、安全测试等。不依赖任何已有的私有库，不需要越狱。此工具用于在真机上运行测试，默认是都安装的。Homebrew是Mac平台的软件管理软件，它可以使我们更加容易安装一些其他软件，仅需要执行简单的安装命令，就能下载安装所需要的软件，省去了下载、解压、拖拽等繁琐的步骤。...
检查Appium-doctor提示WARN，解决的方案
xujiuba的博客
07-10 3675
大家有没有在最后一步安装appium-doctor，如果全都打勾，就很完美的安装成功，可偏偏就是遇到很多的问题，有部分问题都是打叉。就像我这样的，各位可以看看有没有遇到像我这样的问题，以下的图： 解决方法????： ...
mac在使用appium-doctor检查时遇到的问题及解决方法
u010708426的博客
11-14 2430
在终端输入：sudo npm i -g mjpeg-consumer 或者npm i -g mjpeg-consumer 或者 pm i -g mjpeg-consumer。打开Xcode --->左上角Xcode--->选择Preferences-->选择弹框中的Locations-->在Command Line Tools 下拉框中选择版本号。在终端输入：sudo npm -g install opencv4nodejs --ignore-scripts。中下载bundletool.jar。
检查appium环境报错Error running xcrun simctl
专研技术结交志同道合的朋友
11-14 491
在终端输入appium-doctor检查环境 报错：Error running xcrun simctl 如下图： 这个是由于Xcode没有选择版本号导致的 解决方案： 1、这个是Xcode的问题，Xcode安装之后，simctl可以用xcrun命令来执行； 打开Xcode-->Preferences-->Locations-->Command Line Tools 选择版本号...
Failed to create provisioning profile. The app ID "com.facebook.WebDriverAgentRunner" cannot be regi
Lily77821的博客
03-13 7156
报错，id不唯一 1.搜索Product Bundle Identifier 改成自己的 点击BuildSettings查看更改是否完成 2.更改WebDriverAgentRunner，双击要修改的字段 3.依此类推，将其他包名都改掉，再run一下 ...
评论 7
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值