新手学appium-java api

马琰的春天

也许你会问我，为什么会在robotium新手学习blog的过程中插入appium的java api，这完全是我即兴做的，
或许之后还会整理python的appium api，或者更多。最近恰巧跟测试同行在selenium谈起移动自动化，话
题自然而然地扯到了appium，robotium等等。
  3
  4     希望这个文档可以为正在学习的朋友带来帮助，python的api或许马上出炉
  5 */


  6 getAppStrings()
  7
  8 //默认系统语言对应的Strings.xml文件内的数据。
  9
10 driver.getAppStrings(String language)
11
12 //查找某一个语言环境对应的字符串文件Strings.xml内数据
13
14 sendKeyEvent(int key)
15
16 //按下某个键，具体哪个键由key值决定，key值定义在AndroidKeyCode类中
17
18 sendKeyEvent(int key, Integer metastate)
19
20 //按下某个键的同时按下附加键（Ctrl/Alt/Shift等），具体是哪些键，由key值（AndroidKeyCode类中定
义）和metastate（AndroidKeyMetastate类中定义）决定。
21
22 currentActivity()
23
24 //获取当前activity,比如（.ApiDemos）
25
26 isAppInstalled(String bundleId)
27
28 //根据bundleId来判断该应用是否已经安装
29
30 installApp(String appPath)
31
32 //安装app，appPath为应用的本地路径
33
34 removeApp(String bundleId)
35
36 //卸载app.bundleId在android中代表的是报名，而在ios中有专门的bundleId号。
37
38 closeApp()
39
40 //关闭应用，其实就是按home键把应用置于后台
41
42 launchApp()
43
44 //启动应用
45
46 resetApp()
47
48 //先closeApp然后在launchAPP
49
50 pushFile(String remotePath, byte[] base64Data)
51
52 //将字符数组用64位格式写到远程目录的某个文件中。也可以理解为把本地文件push到设备上。
53
54 pullFile(String remotePath)
55
56 //将设备上的文件pull到本地硬盘上
57
58 pullFolder(String remotePath)
59
60 //将设备上的文件夹pull到本地硬盘上，一般远程文件为/data/local/tmp下的文件。
61
62 setNetworkConnection(NetworkConnectionSetting connection)
63
64 //设置手机的网络连接状态，可以开关蓝牙、wifi、数据流量。通过NetworkConnectionSetting中的属性
来设置各个网络连接的状态。
65
66 getNetworkConnection()
67
68 //得到当前网络的状态
69
70 openNotifications()
71
72 //打开通知栏
73
74 runAppInBackground(int seconds)
75
76 //与resetApp类似，区别是resetApp关闭后立即启动，而这个方法是关闭后等待seconds秒后再启动。
77
78 hideKeyboard()
79
80 //ios隐藏键盘
81
82 hideKeyboard(String strategy, String keyName)
83
84 //隐藏键盘，只能用于ios上。
85
86 performTouchAction(TouchAction touchAction)
87
88 //执行一个touch动作，该touch动作是由TouchAction封装的。
89
90 performMultiTouchAction(MultiTouchAction multiAction)
91
92 //执行多步touch动作，由MultiTouchAction封装的多步操作。
93
94 tap(int fingers, WebElement element, int duration)
95
96 //点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。
97
98 tap(int fingers, int x, int y, int duration)
99
100 //点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。
101
102 swipe(int startx, int starty, int endx, int endy, int duration)
103
104 //从(startx,starty)滑到（endx,endy），分duration步滑，每一步用时是5毫秒。
105
106 pinch(WebElement el)
107
108 //2个手指操作控件，从对角线向中心点滑动。
109
110 pinch(int x, int y)
111
112 //以（x,y）为基准，计算得出（x,y-100）,(x,y+100)两个点，然后2个手指按住这两个点同时滑到（x,y）
113
114 zoom(WebElement el)
115
116 //与pinch(el)的动作刚好相反。两个手指由控件的中心点慢慢向控件的左顶点后右底点滑动。
117
118 zoom(int x, int y)
119
120 //和pinch(x,y)相反。两个手指从（x,y）点开始向（x,y-100）和（x,y+100）滑动。
121
122 getNamedTextField(String name)
123
124 //一般用在ios中。根据accessibility id获得控件对象。
125
126 endTestCoverage(String intent, String path)
127
128 //结束测试覆盖率的检测。（没用过，不太了解）path为.ec文件的路径。
129
130 lockScreen(int seconds)
131
132 //锁屏多少秒后解锁（使用的时候提示还没实现该方法）
133
134 shake()
135
136 //模拟摇晃手机（目前还没实现）
137
138 scrollTo(String text)
139
140 //滚动到某个text属性为指定的字符串的控件
141
142 scrollToExact(String text)
143
144 //滚动到某个text属性包含传入的字符串的控件
145
146 context(String name)
147
148 //设置上下文
149
150 getContextHandles()
151
152 //可用上下文
153
154 getContext()
155
156 //当前上下文
157
158 rotate(ScreenOrientation orientation)
159
160 //设置屏幕横屏或者竖屏
161
162 getOrientation()
163
164 //获取当前屏幕的方向
165
166 findElementByIosUIAutomation(String using)
167
168 //利用ios中的uiautomation中的属性来获取控件
169
170 findElementsByIosUIAutomation(String using)
171
172 //和上面一样，不过获得的是多个控件
173
174 findElementByAndroidUIAutomator(String using)
175
176 //利用android的uiautoamtor中的属性来获取单个控件。
177
178 findElementsByAndroidUIAutomator(String using)
179
180 //和上面一样，但是该方法获得是多个控件
181
182 findElementByAccessibilityId(String using)
183
184 //利用accessibility id来获取单个控件
185
186 findElementsByAccessibilityId(String using)
187
188 //利用accessibility id来获得多个控件
189
190 TouchAction
191
192 //AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等。TouchAction的原理是讲一系
列的动作放在一个链条中，然后将该链条传递给服务器。服务器接受到该链条后，解析各个动作，逐个执行。
193
194 press(WebElement el)
195
196 //在控件上执行press操作。
197
198 press(int x, int y)
199
200 //在坐标为（x,y）的点执行press操作
201
202 press(WebElement el, int x, int y)
203
204 //在控件el的左上角的x坐标偏移x单位，y左边偏移y单位的坐标上执行press操作。
205
206 release()
207
208 //释放操作，代表该系列动作的一个结束标志。
209
210 moveTo(WebElement el)
211
212 //以el为目标，从另一个点移动到该目标上
213
214 moveTo(int x, int y)
215
216 //以（x,y）点为目标，从另一个点移动到该目标上
217
218 moveTo(WebElement el, int x, int y)
219
220 //以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。以该点为目标，从另一个点移动到该点上。
221
222 tap(WebElement el)
223
224 //在控件的中心点上敲击一下
225
226 tap(int x, int y)
227
228 //在（x,y）点轻击一下
229
230 tap(WebElement el, int x, int y)
231
232 //以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。在该点上轻击。
233
234 waitAction()
235
236 //代表一个空操作，等待一段时间
237
238 waitAction(int ms)
239
240 //等待ms秒
241
242 longPress(WebElement el)
243
244 //控件长按
245
246 longPress(int x, int y)
247
248 //点长按
249
250 longPress(WebElement el, int x, int y)
251
252 //偏移点长按
253
254 cancel()
255
256 //取消执行该动作
257
258 perform()
259
260 //执行该动作