Appium之python API

webdriver

contexts(self)

說明：返回多個會話內容

使用：driver.contexts

 

current_context(self)

說明：返回單個會話的內容

使用：driver.current_context

 

context(self)

返回current_context(self)

使用方法：driver.context

 

find_element_by_ios_uiautomation(self,uia_string)

說明：經過uiautomation在iOS元素中查找uia_string

參數：uia_string ：iOS uiautomation庫元素名稱爲uia_string

使用：driver.find_element_by_ios_uiautomation('.elements()[1].cells()[2]')

 

find_elements_by_ios_uiautomation(self, uia_string)

說明：經過uiautomation在iOS多個重複元素uia_string中查找

參數：uia_string ：iOS uiautomation庫元素名稱爲uia_string

使用：driver.find_element_by_android_uiautomator('.elements()[1].cells()[2]')

 

find_element_by_android_uiautomator(self, uia_string)

說明：經過uiautomation在Android元素中查找uia_string

參數：uia_string ：Android uiautomation庫元素名稱爲uia_string

使用：driver.find_elements_by_android_uiautomator('.elements()[1].cells()[2]')

 

find_elements_by_android_uiautomator(self, uia_string)

說明：經過uiautomation在Android多個重複元素uia_string中查找

參數：uia_string ：Android uiautomation庫元素名稱爲uia_string

使用：driver.find_elements_by_android_uiautomator('.elements()[1].cells()[2]')

 

find_element_by_accessibility_id(self, id)

說明：可查找元素的ID

參數：id: 一個字符串對應一個遞歸元素的搜索使用

ID /名稱，當地的輔助功能選項利用

使用：driver.find_element_by_accessibility_id()

 

find_elements_by_accessibility_id(self, id)

說明：可查找元素多個相同的ID
參數：id: 一個字符串對應一個遞歸元素的搜索使用

ID /名稱，當地的輔助功能選項利用

使用：driver.find_element_by_accessibility_id()

 

scroll(self, origin_el, destination_el)

說明：滑動界面

參數：originalel -開始元素,destination_el:-結束元素

使用：driver.scroll(el1, el2)

 

drag_and_drop(self, origin_el, destination_el)
說明：拖拽到指定區域

參數：originalel ：開始元素

        destination_el: 結束元素

使用：driver. drag_and_drop( origin_el, destination_el)

 

swipe(self, start_x, start_y,end_x ,end_y, duration=None)

說明：屏幕滑動

參數：start_x-起始x座標，start_y-起始y座標，

         end_x-結束x座標，end_y結束y座標

使用：driver.swipe(100, 100, 100, 400)

 

flick(self, start_x, start_y, end_x,end_y)

說明：

參數：start_x-起始x座標，start_y-起始y座標，

         end_x-結束x座標，end_y結束y座標

用法：driver.flick(100,100,100,400)

 

pinch(self, element=None, percent=200,steps=50)

說明：縮放0x0到800x600的圖片

參數：element-縮放的元素，percent-縮放百分比，steps-縮放的步長

用法：driver.pinch(element)

 

zoom(self, element=None, percent=200,steps=50)

說明：縮放超過800x600的圖片

參數：element-縮放的元素，percent-縮放百分比，steps-縮放的步長

用法：driver.zoom(element)

 

app_strings(self, language=None)

說明：返回應用程序從設備指定的字符串語言

參數：language-字符串語言代碼

使用：driver.app_strings(language)

 

reset(self)

說明：重置當前設備上應用

參數：

使用：driver.reset()

 

hide_keyboard(self, key_name=None,key=None, strategy=None)

說明：隱藏設備上的軟鍵盤。在IOS使用」key_name」按某個鍵，或」策略」。使用Android，沒有參數

參數：key_name -按鍵名稱，key-按鍵編碼，strategy-關閉鍵盤

用法：driver.hide_keyboard(key_name=None,key=None, strategy=’tapOutside’)

 

keyevent(self, keycode, metastate=None)

說明：向設備發送一個鍵碼。Android。可能的鍵碼能夠發現

參數：keycode-被髮送到設備的鍵碼,metastate-關於發送的鍵碼元信息

使用：driver.keyevent(keycode, metastate=None)

 

press_keycode(self, keycode,metastate=None)

說明：向設備發送一個鍵碼。Android。

參數：keycode-被髮送到設備的鍵碼,metastate-關於發送的鍵碼元信息

使用：driver.press_keycode(keycode,metastate=None)

 

long_press_keycode(self, keycode,metastate=None)

說明：向設備發送一個鍵碼。Android。

參數：keycode-被髮送到設備的鍵碼,metastate-關於發送的鍵碼元信息

使用：driver.long_press_keycode(keycode,metastate=None)

 

current_activity(self)

說明：獲取當前應用的activity

參數：

使用：driver.current_activity()

 

set_value(self,element,value)

說明：設置應用中元素的值

參數：element-設置的元素，value-設置的值

使用：driver.set_value

 

pull_file(self, path)

說明：在「路徑」檢索文件。返回文件的內容做爲Base64編碼

參數：path-手機的路徑

使用：driver.pull_file(‘path)

 

push_file(self, path, base64data)

說明：把數據,以Base64編碼,文件指定的路徑

參數：path-手機的路徑,base64data- Base64編碼

使用：driver.push(path, base64data)

 

background_app(self, seconds)

說明：把設備上的當前應用置於後臺必定時間

參數：seconds-置於後臺時間

使用：driver.background_app(seconds)

 

is_app_installed(self, bundle_id)

用法：檢查是否「bundle_id」指定的應用程序安裝到設備上

參數：bundle_id-查詢應用程序的id

使用：driver.is_app_installed(bundle_id)

 

install_app(self, app_path)

用法：安裝應用到手機目錄

參數：app_path-應用程序的本地或遠程路徑安裝

使用：driver.install_app(path)

 

remove_app(self,app_id)

用法：刪除指定的應用程序從設備

參數：app_id-被刪除應用程序id

使用：driver.remove(app_id)

 

launch_app(self)

用法：設備中運行指定的應用程序

參數：

用法:driver.launch_app()

 

close_app(self)

用法：中止當前運行的應用程序

語法：

用法：driver.close_app()

 

start_activity(self, app_package,app_activity, app_wait_package='', app_wait_activity='')

用法：打開一個任意的活動的activity。等待下一個activity啓動。這是一個Android-only方法

參數：app_package-包名，app_activity-包啓動activity,app_wait_package-等待啓動包，app_wait_activity-等待啓動包的activity

用法：driver.start_activity(app_package,app_activity, app_wait_package='', app_wait_activity='')

end_test_coverage(self, intent, path)

參數：intent-描述要執行的操做,path-從設備下載覆蓋測試文件路徑

用法：driver.end_test_coverage(intent,path)

 

lock(self, seconds)

說明:鎖屏，只限ios

參數：seconds-鎖屏時長

用法：driver.lock()

 

shake(self)

說明：震動設備

參數：

用法：driver.shake()

 

open_notifications(self)

說明：打開通知欄

參數：

用法：driver.open_notifications()

 

network_connection(self)

說明：返回一個整數位掩碼指定網絡鏈接類型.只限於Android。可能的值能夠經過枚舉的appium.webdriver.ConnectionType

參數：

用法：driver. network_connection()

 

set_network_connection(self, connectionType)

說明：設置網絡鏈接類型。僅限Android。可能的值能夠經過枚舉的appium.webdriver.ConnectionType

Possible values:

           Value (Alias)      | Data | Wifi |Airplane Mode

           -------------------------------------------------

           0 (None)           | 0    | 0   | 0

           1 (Airplane Mode)   | 0     | 0    |1

           2 (Wifi only)       | 0     | 1    |0

           4 (Data only)      | 1     |0    | 0

           6 (All network on)  | 1     |1    | 0

參數：connectionType-枚舉成員appium.webdriver.ConnectionType.

用法：driver. set_network_connection(connectionType)

 

available_ime_engines(self)

說明：得到一個Android設備可用的輸入方法。包和activity(如返回。(' com.android.inputmethod.latin /.LatinIME '))，僅限安卓

參數：

使用：driver. available_ime_engines()

 

is_ime_active(self)

說明：檢查設備是否有輸入法服務活動。返回真或假；僅限安卓

參數：

使用：driver. is_ime_active()

 

activate_ime_engine(self, engine)

說明：激活設備上給定的啓動輸入法的包和acticity。僅限安卓

參數：engine-啓動輸入法的包和acticity(例如,

「com.android.inputmethod.latin /.LatinIME」)

使用：driver. activate_ime_engine( engine)

 

 

deactivate_ime_engine(self)

說明：取消激活設備上定的啓動輸入法的包和acticity。僅限安卓

參數：engine-啓動輸入法的包和acticity(例如,

「com.android.inputmethod.latin /.LatinIME」)

使用：driver. deactivate_ime_engine( engine)

 

active_ime_engine(self)

說明：返回當前活躍的activity和包輸入法引擎(例如,

「com.android.inputmethod.latin /.LatinIME」)

參數：

使用：driver. active_ime_engine()

get_settings(self)

說明：返回appium服務器設置爲當前會話。

不要設置與指望的功能混淆,他們是誰

單獨的概念。

參數：

用法：driver.get_settings()

 

update_settings(self, settings)

說明：設置當前會話的設置。

參數：settings-設置當前應用測試會話字典

用法:driver.update_settungs(setinngs)

 

toggle_location_services(self)

說明：開關設備上的定位服務。僅限安卓

參數：

用法：driver. toggle_location_services()

 

_addCommands(self)

說明：添加命令

參數：

用法：driver._addCommands()

 

set_value(self, value)

說明：在應用程序中設置值在這個元素

參數：

用法：driver.set_value(value)

 

 

tap(self, positions, duration=None)

說明：點擊特定的地方，特定的時間

參數：positions -一個數組的元組表明的x / y座標,長度可達5。

        duration-tap時間的長度，單位:ms

用法：driver.tap([(100, 20), (100, 60), (100,100)], 500)