【翻譯】appium-bindings

Appium 客戶端類庫

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

語言 源碼
Ruby GitHub
Python GitHub
Java GitHub
JavaScript GitHub
PHP GitHub
C# GitHub
Objective-C GitHub

注意稠项，一些方法類似 endTestCoverage() 目前并不能完全支持悴能。當(dāng)這個問題被解決后窃躲，適當(dāng)?shù)母采w率支持才會被添加嫂伞。如果你仍然想使用這些方法方椎，請參考 GitHub 上關(guān)于 bindings 的文檔崎苗。

鎖定

鎖定屏幕。

# ruby
lock 5

# python
driver.lock(5)

// java
driver.lockScreen(3);

// javascript
driver.lock(3)

// php
$this->lock(3);

// c#
driver.LockDevice(3);

// objective c
[driver lockDeviceScreen:3];

將應(yīng)用切換至后臺

將當(dāng)前的應(yīng)用切換到后臺幔亥。

# ruby
background_app 5

# python
driver.background_app(5)

// java
driver.runAppInBackground(5);

// javascript
driver.backgroundApp(5)

// php
$this->backgroundApp(5);

// c#
driver.BackgroundApp(5);

// objective c
[driver runAppInBackground:3];

收起鍵盤

收起鍵盤粪般。
注意: 在 iOS，這輔助功能并不能保證一定有效闸拿。因為沒有用于隱藏鍵盤的 automation hook空盼，而且應(yīng)用是允許用戶去使用各種策略去收起鍵盤的，無論是點擊鍵盤以外的區(qū)域新荤，還是向下滑動諸如此類...相比于使用該方法揽趾，我們更加鼓勵你去思考 用戶 在應(yīng)用中是如何收起鍵盤，并告訴 Appium 去執(zhí)行苛骨，代替掉內(nèi)些操作（滑動篱瞎，點擊一個固定的坐標(biāo)，等等...）痒芝。話雖如此俐筋，但默認(rèn)的行為是可能是最能幫助到你的。

# ruby
hide_keyboard

# python
driver.hide_keyboard()

// java
driver.hideKeyboard();

// javascript
driver.hideKeyboard()

// php
$this->hideKeyboard();
$this->hideKeyboard(array('strategy' => 'pressKey', 'key' => 'Done'));

// c#
driver.HideKeyboard("Done");

// objective c
[driver hideKeyboard];

啟動 Activity

在當(dāng)前 app 打開一個 activity严衬，或者新打開一個應(yīng)用并啟動一個 acticity澄者， 僅支持 Android。

// java
driver.startActivity("appPackage","com.example.android.apis", null, null);

// javascript
driver.startActivity({appPackage: 'com.example.android.apis', appActivity: '.Foo'}, cb);

# python
driver.start_activity('com.example.android.apis', '.Foo')

# ruby
start_activity app_package: 'io.appium.android.apis', app_activity: '.accessibility.AccessibilityNodeProviderActivity'

// c#
driver.StartActivity("com.example.android.apis", ".Foo");

// php
$this->startActivity(array("appPackage" => "com.example.android.apis",
                            "appActivity" => ".Foo"));

// objective c
[driver startActivity:@"com.example.android.apis" package:@".Foo"];

打開通知欄

打開通知欄，僅支持 Android粱挡。

// java
driver.openNotifications();

// javascript
driver.openNotifications(cb);

# python
driver.open_notifications()

# ruby
open_notifications

// c#
driver.OpenNotifications();

// php
$this->openNotifications();

// objective c
[driver openNotifications];

應(yīng)用是否已安裝

檢查應(yīng)用是否已被安裝赠幕。

# ruby
is_installed? "com.example.android.apis"

# python
driver.is_app_installed('com.example.android.apis')

// java
driver.isAppInstalled("com.example.android.apis")

// javascript
driver.isAppInstalled("com.example.android.apis")
  .then(function (isAppInstalled) { /*...*/ })

// php
$this->isAppInstalled('com.example.android.apis');

// c#
driver.IsAppInstalled("com.example.android.apis-");

// objective c
[driver isAppInstalled:@"com.example.android.apis-"];

安裝應(yīng)用

在設(shè)備上安裝應(yīng)用。

# ruby
install 'path/to/my.apk'

# python
driver.install_app('path/to/my.apk')

// java
driver.installApp("path/to/my.apk")

// javascript
driver.installApp("path/to/my.apk")

// php
$this->installApp('path/to/my.apk');

// c#
driver.InstallApp("path/to/my.apk");

// objective c
[driver installAppAtPath:@"path/to/my.apk"];

卸載應(yīng)用

移除設(shè)備上的應(yīng)用询筏。

# ruby
remove 'com.example.android.apis'

# python
driver.remove_app('com.example.android.apis')

// java
driver.removeApp("com.example.android.apis")

// javascript
driver.removeApp("com.example.android.apis")

// php
$this->removeApp('com.example.android.apis');

// c#
driver.RemoveApp("com.example.android.apis");

// objective c
[driver removeApp:@"com.example.android.apis"];

搖一搖

模擬搖晃設(shè)備的操作劣坊。

# ruby
shake

# python
driver.shake()

// java
driver.shake()

// javascript
driver.shake()

// php
$this->shake();

// c#
driver.ShakeDevice();

// objective c
[driver shakeDevice];

關(guān)閉應(yīng)用

關(guān)閉應(yīng)用。

# ruby
close_app

# python
driver.close_app();

// java
driver.closeApp()

// javascript
driver.closeApp()

// php
$this->closeApp();

// c#
driver.CloseApp();

// objective c
[driver closeApp];

啟動（Launch）

為 desired capabilities 啟動一個 session屈留。請注意只有設(shè)置了 autoLaunch=false 關(guān)鍵字時才會生效局冰。使用 start_activity 這個參數(shù)不是為了隨意啟動一個應(yīng)用或 activities。這是在你設(shè)置了 autoLaunch=false 后灌危，用來繼續(xù)執(zhí)行初始化（"launch"）流程的康二。

# ruby
launch_app

# python
driver.launch_app()

// java
driver.launchApp()

// javascript
driver.launchApp()

// php
$this->launchApp();

// c#
driver.LaunchApp();

// objective c
[driver launchApp];

重置

重置應(yīng)用。

# ruby
driver.reset

# python
driver.reset()

// java
driver.resetApp()

// javascript
driver.resetApp()

// php
$this->reset();

// c#
driver.ResetApp();

// objective c
[driver resetApp];

可用的 Contexts

列出所有可用的 contexts勇蝙。

# ruby
context_array = available_contexts

# python
driver.contexts

// java
driver.getContextHandles()

// javascript
driver.contexts().then(function (contexts) { /*...*/ })

// php
$this->contexts();

// c#
driver.GetContexts()

// objective c
NSArray *contexts = driver.allContexts;

當(dāng)前 context

列出當(dāng)前的 context沫勿。

# ruby
context = current_context

# python
driver.current_context

// java
driver.getContext()

// javascript
driver.currentContext().then(function (context) { /*...*/ })

// php
$this->context();

// c#
driver.GetContext()

// objective c
NSString *context = driver.context;

切換至默認(rèn)的 context

切換回默認(rèn)的 context。

# ruby
switch_to_default_context

# python
driver.switch_to.context(None)

// java
driver.context();

// javascript
driver.context()

// php
$this->context(NULL);

// c#
driver.SetContext();

// objective c
[driver setContext:nil];

應(yīng)用的字符串

獲得應(yīng)用的字符串味混。

# ruby
app_strings

# python
driver.app_strings

// java
driver.getAppStrings();

// javascript
driver.getAppStrings().then(function (appStrings) { /*...*/ })

// php
$this->appStrings();
$this->appStrings('ru');

// c#
driver.GetAppStrings();

// objective c
[driver appStrings];
[driver appStringsForLanguage:"@ru"];

按鍵事件

給設(shè)備發(fā)送按鍵事件产雹。

# ruby
key_event 176

# python
driver.keyevent(176)

// java
driver.sendKeyEvent(AndroidKeyCode.HOME);

// javascript
driver.deviceKeyEvent(wd.SPECIAL_KEYS.Home)

// php
$this->keyEvent('176');

// c#
driver.KeyEvent("176");

// objective c
NSError *err;
[driver triggerKeyEvent:176 metastate:0 error:&err];

當(dāng)前 Activity

獲取當(dāng)前的 Acticity，但僅支持 Android翁锡。

# ruby
current_activity

# python
driver.current_activity

// java
driver.currentActivity();

// javascript
driver.getCurrentActivity().then(function (activity) { /*...*/ })

// php
$this->currentActivity();

// c#
driver.GetCurrentActivity();

// objective c
NSError *err;
[driver currentActivity];

點擊操作 / 多點觸控操作

用于生成點擊操作的 API蔓挖。這部分文檔的內(nèi)容將會很快被補充進來。

# ruby
touch_action = Appium::TouchAction.new
element  = find_element :name, 'Buttons, Various uses of UIButton'
touch_action.press(element: element, x: 10, y: 10).perform

# python
action = TouchAction(driver)
action.press(element=el, x=10, y=10).release().perform()

// java
TouchAction action = new TouchAction(driver)
.press(mapview, 10, 10)
.release().
perform();

// javascript
var action = new wd.TouchAction(driver);
action
  .tap({el: el, x: 10, y: 10})
  .release();
return action.perform(); // returns a promise

// php
$action = $this->initiateTouchAction();
               ->press(array('element' => $el))
               ->release()
               ->perform();

$action1 = $this->initiateTouchAction();
$action1->press(array('element' => $els[0]))
        ->moveTo(array('x' => 10, 'y' => 0))
        ->moveTo(array('x' => 10, 'y' => -75))
        ->moveTo(array('x' => 10, 'y' => -600))
        ->release();

$action2 = $this->initiateTouchAction();
$action2->press(array('element' => $els[1]))
        ->moveTo(array('x' => 10, 'y' => 10))
        ->moveTo(array('x' => 10, 'y' => -300))
        ->moveTo(array('x' => 10, 'y' => -600))
        ->release();

$multiAction = $this->initiateMultiAction();
$multiAction->add($action1);
$multiAction->add($action2);
$multiAction->perform();

// c#
ITouchAction action = new TouchAction(driver);
action.Press(el, 10, 10).Release();
action.Perform ();

滑動屏幕

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

# ruby
swipe start_x: 75, start_y: 500, end_x: 75, end_y: 0, duration: 0.8

# python
driver.swipe(start_x=75, start_y=500, end_x=75, end_y=0, duration=800)

// java
driver.swipe(75, 500, 75, 0, 0.8)

// javascript
function swipe(opts) {
  var action = new wd.TouchAction(this);
  action
    .press({x: opts.startX, y: opts.startY})
    .wait(opts.duration)
    .moveTo({x: opts.endX, y: opts.endY})
    .release();
  return action.perform();
}
wd.addPromiseChainMethod('swipe', swipe);
// ...
return driver.swipe({ startX: 75, startY: 500,
  endX: 75,  endY: 0, duration: 800 });

// php
$this->swipe(75, 500, 75, 0, 800);

// c#
todo: c#

捏（Pinch）手勢

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

# ruby
pinch 75

# python
driver.pinch(element=el)

// java
driver.pinch(element);

// javascript
function pinch(el) {
  return Q.all([
    el.getSize(),
    el.getLocation(),
  ]).then(function(res) {
    var size = res[0];
    var loc = res[1];
    var center = {
      x: loc.x + size.width / 2,
      y: loc.y + size.height / 2
    };
    var a1 = new wd.TouchAction(this);
    a1.press({el: el, x: center.x, y:center.y - 100}).moveTo({el: el}).release();
    var a2 = new wd.TouchAction(this);
    a2.press({el: el, x: center.x, y: center.y + 100}).moveTo({el: el}).release();
    var m = new wd.MultiAction(this);
    m.add(a1, a2);
    return m.perform();
  }.bind(this));
};
wd.addPromiseChainMethod('pinch', pinch);
wd.addElementPromiseChainMethod('pinch', function() {
  return this.browser.pinch(this);
});
// ...
return driver.pinch(el);
// ...
return el.pinch();

$this->pinch($el);

// c#
driver.Pinch(25, 25)

放大屏幕（Zoom）

在屏幕上使用放大手勢。

# ruby
zoom 200

# python
driver.zoom(element=el)

// java
driver.zoom(element);

// javascript
function zoom(el) {
  return Q.all([
    this.getWindowSize(),
    this.getLocation(el),
  ]).then(function(res) {
    var size = res[0];
    var loc = res[1];
    var center = {
      x: loc.x + size.width / 2,
      y: loc.y + size.height / 2
    };
    var a1 = new wd.TouchAction(this);
    a1.press({el: el}).moveTo({el: el, x: center.x, y: center.y - 100}).release();
    var a2 = new wd.TouchAction(this);
    a2.press({el: el}).moveTo({el: el, x: center.x, y: center.y + 100}).release();
    var m = new wd.MultiAction(this);
    m.add(a1, a2);
    return m.perform();
  }.bind(this));
};
wd.addPromiseChainMethod('zoom', zoom);
wd.addElementPromiseChainMethod('zoom', function() {
  return this.browser.zoom(this);
});
// ...
return driver.zoom(el);
// ...
return el.zoom();

// php
$this->zoom($el);

// c#
driver.Zoom(100, 200);

滾動到

滾動到某個元素角溃。

# ruby
element = find_element :name, "Element Name"
execute_script "mobile: scroll", direction: "down", element: element.ref

# python
driver.execute_script("mobile: scroll", {"direction": "down", "element": element.id})

// java
JavascriptExecutor js = (JavascriptExecutor) driver;
HashMap<String, String> scrollObject = new HashMap<String, String>();
scrollObject.put("direction", "down");
scrollObject.put("element", ((RemoteWebElement) element).getId());
js.executeScript("mobile: scroll", scrollObject);

// javascript
return driver.elementByName().then(function (el) {
  driver.execute("mobile: scroll", [{direction: "down", element: el.value}]);
});

// php
$els = $this->elements($this->using('class name')->value('android.widget.TextView'));
$this->scroll($els[count($els) - 1], $els[0]);

// c#
Dictionary<string, string> scrollObject = new Dictionary<string, string>();
scrollObject.Add("direction", "down");
scrollObject.Add("element", <element_id>);
((IJavaScriptExecutor)driver).ExecuteScript("mobile: scroll", scrollObject));

拉出（pull）文件

從設(shè)備上拉出文件拷获。

# ruby
pull_file 'Library/AddressBook/AddressBook.sqlitedb'

# python
driver.pull_file('Library/AddressBook/AddressBook.sqlitedb')

// java
driver.pullFile("Library/AddressBook/AddressBook.sqlitedb");

// javascript
driver.pullFile("Library/AddressBook/AddressBook.sqlitedb")
  .then(function (base64File) { /*...*/ })

// php
$this->pullFile('Library/AddressBook/AddressBook.sqlitedb');

// c#
driver.PullFile("Library/AddressBook/AddressBook.sqlitedb");

推送（push）文件

推送文件到設(shè)備。

# ruby
data = "some data for the file"
path = "/data/local/tmp/file.txt"
push_file path, data

# python
data = "some data for the file"
path = "/data/local/tmp/file.txt"
driver.push_file(path, data.encode('base64'))

// java
byte[] data = Base64.encodeBase64("some data for the file".getBytes());
String path = "/data/local/tmp/file.txt";
driver.pushFile(path, data)

// javascript
driver.pushFile(path, data)

// php
$path = 'data/local/tmp/test_push_file.txt';
$data = 'This is the contents of the file to push to the device.';
$this->pushFile($path, base64_encode($data));

// c#
driver.PushFile("/data/local/tmp/file.txt", "some data for the file");

設(shè)置

在這你會找到關(guān)于獲取或設(shè)置 appium 服務(wù)器設(shè)置的示例代碼减细。如果想了解工作原理匆瓜，以及支持哪些設(shè)置，請查看設(shè)置文檔

# ruby
current_settings = get_settings
update_settings someSetting: true

# python
current_settings = driver.get_settings()
driver.update_settings({"someSetting": true})

// java
JsonObject settings = driver.getSettings()
// java-client doesn't support setting arbitrary settings, just settings which are already provided by appium.
// So for the 'ignoreUnimportantViews' setting, the following method exists:
driver.ignoreUnimportantViews(true);

// javascript
var settings = driver.settings();
browser.updateSettings({'someSetting': true});

// php
$settings = $this->getSettings();
$this->updateSettings(array('cyberdelia' => "open"));

// c#
Dictionary<String, Object>settings = driver.GetSettings();
// dotnet-driver doesn't support setting arbitrary settings, just settings which are already provided by appium.
// So for the 'ignoreUnimportantViews' setting, the following method exists:
driver.IgnoreUnimportantViews(true);

Appium 桌面應(yīng)用

Appium 的桌面應(yīng)用支持 OS X 與 Windows未蝌。

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 人面猴
    序言：七十年代末驮吱，一起剝皮案震驚了整個濱河市，隨后出現(xiàn)的幾起案子树埠，更是在濱河造成了極大的恐慌糠馆，老刑警劉巖嘶伟，帶你破解...
    沈念sama閱讀 206,482評論 6贊 481
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件怎憋，死亡現(xiàn)場離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機绊袋，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,377評論 2贊 382
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進店門毕匀，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人癌别，你說我怎么就攤上這事皂岔。” “怎么了展姐？”我有些...
    開封第一講書人閱讀 152,762評論 0贊 342
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵躁垛，是天一觀的道長。 經(jīng)常有香客問我圾笨，道長教馆，這世上最難降的妖魔是什么？ 我笑而不...
    開封第一講書人閱讀 55,273評論 1贊 279
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任擂达，我火速辦了婚禮土铺，結(jié)果婚禮上，老公的妹妹穿的比我還像新娘板鬓。我一直安慰自己悲敷，他們只是感情好，可當(dāng)我...
    茶點故事閱讀 64,289評論 5贊 373
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布俭令。 她就那樣靜靜地躺著后德，像睡著了一般。 火紅的嫁衣襯著肌膚如雪抄腔。 梳的紋絲不亂的頭發(fā)上探遵，一...
    開封第一講書人閱讀 49,046評論 1贊 285
  • 城市分裂傳說
    那天，我揣著相機與錄音妓柜，去河邊找鬼箱季。 笑死，一個胖子當(dāng)著我的面吹牛棍掐，可吹牛的內(nèi)容都是我干的藏雏。 我是一名探鬼主播，決...
    沈念sama閱讀 38,351評論 3贊 400
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼作煌，長吁一口氣：“原來是場噩夢啊……” “哼掘殴！你這毒婦竟也來了？” 一聲冷哼從身側(cè)響起粟誓，我...
    開封第一講書人閱讀 36,988評論 0贊 259
  • 萬榮殺人案實錄
    序言：老撾萬榮一對情侶失蹤奏寨，失蹤者是張志新（化名）和其女友劉穎，沒想到半個月后鹰服，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體病瞳，經(jīng)...
    沈念sama閱讀 43,476評論 1贊 300
  • ?護林員之死
    正文 獨居荒郊野嶺守林人離奇死亡揽咕，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,948評論 2贊 324
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年，在試婚紗的時候發(fā)現(xiàn)自己被綠了套菜。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片亲善。...
    茶點故事閱讀 38,064評論 1贊 333
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖逗柴，靈堂內(nèi)的尸體忽然破棺而出蛹头，到底是詐尸還是另有隱情，我是刑警寧澤戏溺，帶...
    沈念sama閱讀 33,712評論 4贊 323
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布渣蜗，位于F島的核電站，受9級特大地震影響旷祸，放射性物質(zhì)發(fā)生泄漏袍睡。R本人自食惡果不足惜，卻給世界環(huán)境...
    茶點故事閱讀 39,261評論 3贊 307
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一肋僧、第九天 我趴在偏房一處隱蔽的房頂上張望斑胜。 院中可真熱鬧，春花似錦嫌吠、人聲如沸止潘。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,264評論 0贊 19
  • 一樁弒父案辫诅，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽凭戴。三九已至，卻和暖如春炕矮，著一層夾襖步出監(jiān)牢的瞬間么夫，已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,486評論 1贊 262
  • 情欲美人皮
    我被黑心中介騙來泰國打工肤视， 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留档痪，地道東北人。 一個月前我還...
    沈念sama閱讀 45,511評論 2贊 354
  • 代替公主和親
    正文 我出身青樓邢滑，卻偏偏與公主長得像腐螟，于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子困后，可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,802評論 2贊 345

推薦閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 171,510評論 25贊 707
  • ￥開啟￥ 【iAPP實現(xiàn)進入界面執(zhí)行逐一顯】 〖2017-08-25 15:22:14〗 《//首先開一個線程乐纸，因...
    小菜c閱讀 6,358評論 0贊 17
  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫、插件摇予、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 12,025評論 4贊 62
  • 撕下最頂一頁的備忘卡 用毛巾拂去桌面的灰塵 文檔汽绢、筆記本都塞進書架 ———— 年歲不知不覺間來到臘月 炮竹聲在看不...
    Hua一閱讀 233評論 0贊 2
  • 鏡前表演是模特培訓(xùn)中的關(guān)鍵環(huán)節(jié)宁昭，其中跌宛，最重要的就是面部表情、眼神運用和整體造型設(shè)計久窟。羽翼國際模特學(xué)校的模特老師在鏡...
    彩虹姐教你玩時髦閱讀 1,666評論 0贊 4