Appium 客戶端類庫

Appium 支持以下語言的客戶端類庫：

注意，一些方法類似目前並不能完全支持。當這個問題被解決後，覆蓋率支持才會被添加。如果你仍然想使用這些方法，請參考 GitHub 上關於 bindings 的文檔。

鎖定

鎖定屏幕。

將應用切換至後台

將當前的應用切換到後台，然後可以讓其在指定時間內回到前台，或者讓它一直留在後台。

傳遞給這個方法的參數有兩種類型：

一個整型（秒）：表示後台狀態維持多久。-1 表示持續置於後台。這種風格的參數已經被廢棄。

一個看起來像的對象。裡面的是含義和第一個類型一樣的整型數字（即表示置於後台多少秒），或者為（表示持續置於後台）。

收起鍵盤

收起鍵盤。注意: 在 iOS，這輔助功能並不能保證一定有效。因為沒有用於隱藏鍵盤的自動化鉤子方法（譯者註：可以理解為 iOS 沒有提供隱藏鍵盤的 API），而且應用是允許用戶去使用各種策略去收起鍵盤的，無論是點擊鍵盤以外的區域，還是向下滑動諸如此類...相比於使用該方法，我們更加鼓勵你去思考用戶在應用中是如何收起鍵盤（如滑動，點擊一個固定的坐標，等等...），並讓 Appium 去執行這些方法，而不是調用這個 API 。話雖如此，但這裡默認的行為還是可能幫助到你的。

啟動 Activity

在當前 app 打開一個 activity，或者新打開一個應用並啟動一個 acticity，僅支持 Android。

打開通知欄

打開通知欄，僅支持 Android。

應用是否已安裝

檢測應用是否已被安裝。

安裝應用

在設備上安裝應用。

卸載應用

卸載設備上的應用。

搖一搖

模擬搖晃設備的操作。

關閉應用

關閉應用。

啟動（Launch）

為 desired capabilities 啟動一個 session。請注意只有設置了 autoLaunch=false 關鍵字時才會生效。這不是為了隨意啟動一個應用或 activities ——如果你想這麼做，請使用這個 desired capability 的參數。這個方法的使用場景是在你設置了 autoLaunch=false 後，用來繼續執行初始化（"launch"）流程的。（譯者註：舉個例子，國產系統經常會在應用安裝時彈出提示窗阻礙安裝，此時可以通過 autoLaunch=false 來讓應用安裝後先執行你的腳本來關掉彈窗，然後再用這個函數來繼續啟動應用。）

重置

重置應用。（譯者註：類似於清除緩存）

可用的上下文（Contexts）

列出所有可用的上下文（contexts）。

當前上下文（context）

列出當前的上下文（context）。

切換至默認的上下文（context）

切換回默認的上下文（context）。（譯者註：一般就是原生上下文 「NATIVE_APP」）

應用的字元串

獲得應用的字元串。（譯者註：這裡實際指的是返回應用的多語言文本，即每個 string 變數及在指定語言上的顯示內容。例如。在 android 上對應的是項目中的多語言配置文件）

按鍵事件

給設備發送按鍵事件。

當前 Activity

獲取當前的 Acticity。僅支持 Android。

當前包名（package）

獲取當前包名（package）。僅支持 Android 。

點擊操作 / 多點觸控操作

用於生成點擊操作的 API。這部分文檔的內容將會很快被補充進來。

滑動屏幕

模擬用戶滑動屏幕的操作。

捏（Pinch）手勢

在屏幕上使用捏（Pinch）手勢。

放大屏幕（Zoom）

在屏幕上使用放大手勢。

滾動到

滾動到指定的元素。

拉取（pull）文件

從設備上拉取文件。

推送（push）文件

推送文件到設備。

設置

在這你會找到關於獲取或設置 appium 伺服器設置的示例代碼。如果想了解工作原理，以及支持哪些設置，請查看設置文檔

Appium 桌面應用

Appium 的桌面應用支持 OS X, Windows 及 Linux.

Appium Desktop

END

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！