Appium-Perform Touch ID(执行触摸ID)

末蓝、 2022-11-18 13:38 109阅读 0赞

### Perform Touch ID ###

*   *   *   *   *  Example Usage
                 *  Description
                 *  Support
                 *   *  Appium Server
                     *  Appium Clients
                 *  HTTP API Specifications
                 *   *  Endpoint
                     *  URL Parameters
                     *  JSON Parameters
                     *  Response

Simulate a touch id event (iOS Simulator only) //模拟触摸id事件（仅限iOS模拟器）

##### Example Usage #####

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">driver.performTouchID(false); // Simulates a failed touch<br>driver.performTouchID(true); // Simulates a passing touch</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">self.driver.touch_id(false); # Simulates a failed touch<br>self.driver.touch_id(true); # Simulates a passing touch</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>driver.touchId(false); // Simulates a failed touch<br>driver.touchId(true); // Simulates a passing touch<br>// wd example<br>await driver.touchId(false); // Simulates a failed touch<br>await driver.touchId(true); // Simulates a failed touch</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># ruby_lib example<br>touch_id(false)<br>touch_id(true)<br># ruby_lib_core example<br>@driver.touch_id(false) # Simulates a failed touch<br>@driver.touch_id(true) # Simulates a passing touch</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">driver.PerformTouchID(false); // Simulates a failed touch<br>driver.PerformTouchID(true); // Simulates a passing touch</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left">// TODO PHP sample</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

To enable this feature, the `allowTouchIdEnroll` desired capability must be set to true and the Simulator must be [enrolled][]. //allow Touchldenroll所需功能设置为true

When you set `allowTouchIdEnroll` to true, it will set the Simulator to be enrolled by default. The enrollment state can be [toggled][] //此时可以默认注册

This call will only work if Appium process or its parent application (e.g. Terminal.app or Appium.app) has access to Mac OS accessibility in System Preferences > Security & Privacy > Privacy > Accessibility list //只有在Appium进程或其父应用程序（例如。终端.app或者应用程序.app)可以在“系统首选项”>“安全与隐私”>“隐私”>“辅助功能列表”中访问Mac OS辅助功能

Finger Print by Android is [here][]

##### Support #####

###### Appium Server ######

<table> 
 <thead> 
  <tr> 
   <th>Platform</th> 
   <th>Driver</th> 
   <th>Platform Versions</th> 
   <th>Appium Version</th> 
   <th>Driver Version</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>iOS</td> 
   <td>XCUITest</td> 
   <td>9.3+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UIAutomation</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td>Android</td> 
   <td>Espresso</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator2</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td>Mac</td> 
   <td>Mac</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td>Windows</td> 
   <td>Windows</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
 </tbody> 
</table>

###### Appium Clients ######

<table> 
 <thead> 
  <tr> 
   <th>Language</th> 
   <th>Support</th> 
   <th>Documentation</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td>All</td> 
   <td>appium.github.io</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td>All</td> 
   <td>appium.github.io</td> 
  </tr> 
  <tr> 
   <td>Javascript (WebdriverIO)</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Javascript (WD)</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td>All</td> 
   <td>www.rubydoc.info</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
 </tbody> 
</table>

##### HTTP API Specifications #####

###### Endpoint ######

`POST /session/:session_id/appium/simulator/touch_id`

###### URL Parameters ######

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>session_id</td> 
   <td>ID of the session to route the command to</td> 
  </tr> 
 </tbody> 
</table>

###### JSON Parameters ######

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>type</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>match</td> 
   <td><code>boolean</code></td> 
   <td>Are we simulating a successful touch (true) or a failed touch (false)</td> 
  </tr> 
 </tbody> 
</table>

###### Response ######

null

[enrolled]: https://support.apple.com/en-ca/ht201371
[toggled]: http://appium.io/docs/en/commands/device/simulator/toggle-touch-id-enrollment/index.html
[here]: http://appium.io/docs/en/commands/device/authentication/finger-print/