===========分割线===========
20180121更新,升级到了Appium Desktop 1.3.1,详细更新内容见本文末,建议阅读本文前先看最近更新的内容。
===========分割线===========
百度google了一轮,最大的感触是:好多教程都不适用啊!要么是Appium版本旧,要么是iOS版本旧。想找一篇详细的“从入门到放弃”的教程都没有,之前搭Android环境的时候,能搜到很多十分详实的教程,而iOS的就有点蛋疼了。
然而,坑还是要入的,所以,就从搭环境开始吧。
环境搭建
1. Xcode
必须承认,我是Mac OS新手,有Linux的基础,用了几天Mac OS,算是基本会用了……
本文的系统版本为Mac OS 10.12.5,由于陪测的iOS用的是10.3.2,所以Xcode必须要装上新的8.3.2(不然没有SDK),Xcode在App Store里安装就好了。
2. Appium
Appium向来有命令行版的和GUI版的——我选择后者,到官网下载安装最新的Appium Desktop 1.0.2的dmg,里面带了1.6.4的Appium。
3. Appium客户端库
Python、Ruby、Java、Javascript、PHP、C#等,任君选择,去官网下载。
例如我用Python,就安装Appium-Python-Client,在终端运行
1
2
|
sudo
easy_install
pip
# 系统自带easy_install
pip
install
Appium
-
Python
-
Client
--
user
# 加上--user是因为Mac下有权限的问题
|
4. Homebrew
Homebrew相当于Linux下的apt-get、yum,要用它来安装node,在终端运行
1
2
|
/
usr
/
bin
/
ruby
-
e
"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew
-
v
# 显示版本,如Homebrew 1.2.1
|
5. node
1
2
|
brew
install
node
node
-
v
# e.g. v7.10.0
|
6. appium-doctor相关
用来检测Appium相关环境有没有装好的工具:
1
2
3
4
5
6
7
8
|
npm
install
-
g
appium
-
doctor
# 装好之后 检测一下iOS的环境有没有配置好 如果不加--ios 则检测Android和iOS
appium
-
doctor
--
ios
# 它提示我缺少Xcode Command Line Tools和Carthage,那就补上
xcode
-
select
--
install
brew
install
carthage
|
7. 还有一些库
1
2
|
brew
install
libimobiledevice
--
HEAD
npm
install
-
g
ios
-
deploy
# for iOS 10+
|
8. WebDriverAgent相关(大坑)
iOS 10+使用的是XCUITest,Appium使用的模块是appium-xcuitest-driver,其中引用了Facebook提供的WDA方案来驱动iOS的测试。
装Appium Desktop的时候,它里面带了一个WebDriverAgent,但是这个自带的是有问题的!会造成不能使用Inspector,卡了很久!从Facebook那里自己clone一份才是王道:
1
2
3
4
5
6
7
8
9
10
|
cd
~
git
clone
https
:
/
/
github
.com
/
facebook
/
WebDriverAgent
.git
cd
WebDriverAgent
mkdir
-
p
Resources
/
WebDriverAgent
.bundle
.
/
Scripts
/
bootstrap
.sh
# 开始下载并编译 编译不应该报错
cd
/
Applications
/
Appium
.app
/
Contents
/
Resources
/
app
/
node_modules
/
appium
/
node_modules
/
appium
-
xcuitest
-
driver
/
mv
WebDriverAgent
WebDriverAgent2
# 把自带的改名
ln
-
s
~
/
WebDriverAgent
WebDriverAgent
# 用facebook的原版替换回去
|
经过了baidu和google,用以上方法解决了不能Inspect的问题。
在使用Appium时,需要把WDA装到真机上,然后又会遇到证书的问题,我也不是很明白,总之跟provisioning profile有关。
用Xcode打开目录下的WebDriverAgent.xcodeproj,对于WebDriverAgentLib 和 WebDriverAgentRunner,勾选“Automatically manage signing”,把Team改成公司的,Bundle Identifier改成公司的证书可以接受的名字,具体可以参考官方文档操作,不懂的找开发同学协助。
然后就可以把WebDriverAgentLib和WebDriverAgentRunner都编译到真机运行一下了。正常来说,会在桌面生成一个没图标的WebDriverAgentRunner,点开之后不会有什么反应,这就对了。
写测试脚本
1. Appium server capabilities
要让App跑起来,还需要了解Appium server capabilities,它告诉Appium服务器很多信息,例如开哪个App、手机的系统/版本、在哪台设备上跑(真机还是模拟器等)等。
给出我用到的一些参数(in Python),其他capabilities请参考官方文档。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
# -*- coding: utf-8 -*-
from
time
import
sleep
from
appium
import
webdriver
desired_caps
=
{
}
desired_caps
[
'automationName'
]
=
'XCUITest'
# Xcode8.2以上无UIAutomation,需使用XCUITest
desired_caps
[
'platformName'
]
=
'iOS'
desired_caps
[
'platformVersion'
]
=
'10.3.2'
desired_caps
[
'deviceName'
]
=
'iPhone 7 Plus'
desired_caps
[
'bundleId'
]
=
'需要启动的bundle id, 去问开发者'
desired_caps
[
'udid'
]
=
'真机的udid 可在Xcode或iTunes里查看'
desired_caps
[
'newCommandTimeout'
]
=
3600
# 1 hour
# 打开Appium服务器,start server后,尝试启动被测App
driver
=
webdriver
.
Remote
(
'http://127.0.0.1:4723/wd/hub'
,
desired_caps
)
sleep
(
60
)
driver
.
quit
(
)
|
如果能跑起来,就是正常的,不然看一下报什么错。
2. Inspector
能跑起来只是第一步,更重要的是如何定位元素。
Inspector的使用方法很简单,之前运行driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub’, desired_caps)之后,连接就已经建立好了,只需在浏览器进入http://localhost:8100/inspector即可,之后就可以使用熟悉的driver.find_element_by_xxx方法来定位元素啦。
后记
Selenium的坑
后来又遇到了一点坑,例如使用send_keys方法时,报
Message: Parameters were incorrect. We wanted {“required”:[“value”]} and you sent [“text”,”sessionId”,”id”,”value”]
错误,google了一下发现是selenium新版导致的问题,降级后解决:
1
2
|
pip
uninstall
selenium
pip
install
selenium
==
3.3.1
|
手势操作
由于XCUI的原因,之前的一些手势操作如swipe、pinch、TouchAction等都不能用了,可以参考这篇官方文档,使用driver.execute_script方法代替。如
1
2
|
driver
.
execute_script
(
'mobile: scroll'
,
{
'direction'
:
'down'
}
)
# 向下滚动
driver
.
execute_script
(
'mobile: dragFromToForDuration'
,
{
'duration'
:
0
,
'fromX'
:
374
,
'fromY'
:
115
,
'toX'
:
200
,
'toY'
:
100
}
)
# 从右往左拖
|
对于直接用坐标的,还要注意逻辑分辨率的问题,如iPhone 7 Plus的逻辑分辨率是414×736。
结语
刚接触iOS的Appium,之后肯定还会遇到问题,会继续更新本文。
更新:最近更新到了Appium Desktop 1.1,里面带了1.6.5的Appium,使用起来暂时未发现明显区别。
20180121更新
最近更新了Mac OS到10.13.2,XCode到9.2,Appium Desktop到1.3.1。上文的一些步骤可以简化了。
例如,WebDriverAgent用自带的没有问题,不需要重新clone一个。在打开WebDriverAgent.xcodeproj,成功编译运行到真机后,就可以在Appium Desktop中使用“Start Inspector Session”,填入capabilities,即可新建一个session进行inspect;或者选“Attach to Session”复用正在运行的session来inspect。如图:
试了一下,内置的Inspector可以支持iOS和Android的App,比以前的版本好用多了。
最后附上一些参考:
1. http://www.cocoachina.com/ios/20170112/18518.html
2. http://blog.sina.com.cn/s/blog_b5a76ebd0102wuce.html
3. https://github.com/appium/appium/blob/master/docs/en/appium-setup/real-devices-ios.md
4. http://blog.csdn.net/achang21/article/details/70877583
5. https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md
6. https://github.com/appium/python-client
7. https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/appium-bindings.md
8. https://github.com/facebook/WebDriverAgent/issues/537
9. https://github.com/facebook/WebDriverAgent/wiki/Using-the-Inspector