Appium-Set Context(设置上下文)

悠悠 2022-11-19 04:23 80阅读 0赞

### Set Current Context ###

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

Set the context being automated //设置要自动的上下文

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

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">Set contextNames = driver.getContextHandles();<br>driver.context(contextNames.toArray()[1]);<br>// …<br>driver.context(<code>"NATIVE_APP"</code>);</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">webview = driver.contexts[1]<br>driver.switch_to.context(webview)<br># …<br>driver.switch_to.context(<code>'NATIVE_APP'</code>)</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>let contexts = driver.getContexts();<br>driver.switchContext(contexts[1]);<br>// …<br>driver.switchContext(<code>'NATIVE_APP'</code>);<br><br>// wd example<br>let contexts = await driver.contexts();<br>await driver.context(contexts[1])<br>// …<br>await driver.context(<code>'NATIVE_APP'</code>);</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># ruby_lib example<br>webview = available_contexts[1]<br>set_context(webview)<br># …<br>set_context(<code>'NATIVE_APP'</code>)<br><br># ruby_lib_core example<br>webview = @driver.available_contexts[1]<br>@driver.set_context(webview)<br># …<br>@driver.set_context(<code>'NATIVE_APP'</code>)</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">List AllContexts = new List();<br>foreach (var context in (driver.Contexts))<br> { <br> AllContexts.Add(context);<br> }<br> driver.Context = (AllContexts[1]);<br> // Switch to NATIVE_APP<br> driver.Context = (<code>"NATIVE_APP"</code>);</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left"><code>$</code>contexts = <code>$</code>driver-&gt;contexts();<br><code>$</code>driver-&gt;context(<code>$</code>contexts[1]);<br>// …<br>$driver-&gt;context(<code>'NATIVE_APP'</code>);</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

Set the current context to that passed in. If this is moving into a web view context it will involve attempting to connect to that web view:

iOS - attempt to connect to the application through the remote debugger  
Android - start a Chromedriver process and begin a session to connect to the web view  
For information on contexts, see Appium’s hybrid automation docs.  
/\* 将当前上下文设置为传入的上下文。如果这是移动到web视图上下文中，则将涉及尝试连接到该web视图：  
iOS-尝试通过远程调试器连接到应用程序  
Android-启动Chromedriver进程并开始一个会话以连接到web视图  
有关上下文的信息，请参阅Appium的混合自动化文档 \*/

##### 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>8.0 to 9.3</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Android</td> 
   <td>Espresso</td> 
   <td>?+</td> 
   <td>1.9.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator2</td> 
   <td>?+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator</td> 
   <td>4.3+</td> 
   <td>All</td> 
   <td>All</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>seleniumhq.github.io</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td>All</td> 
   <td>selenium-python.readthedocs.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/context`

###### 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>name</td> 
   <td>String</td> 
   <td>The name of the context to which to change</td> 
  </tr> 
 </tbody> 
</table>

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

null