Appium-Get App State(获取应用程序状态)

秒速五厘米 2022-11-18 01:48 126阅读 0赞

### Get app state ###

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

Get the given app status on the device //获取设备上给定的应用程序状态

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

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">driver.queryAppState(<code>'com.apple.Preferences'</code>);<br>driver.queryAppState(<code>'io.appium.android.apis'</code>);</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">driver.query_app_state(<code>'com.apple.Preferences'</code>)<br>driver.query_app_state(<code>'io.appium.android.apis'</code>)</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>driver.queryAppState(null, ‘com.apple.Preferences’)<br>driver.queryAppState(<code>'io.appium.android.apis'</code>)<br>// wd example<br>// Supports only <code>mobile: queryAppState</code> for iOS, XCUITest</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># ruby_lib example<br>app_state(<code>'com.apple.Preferences'</code>)<br>query_app_state(<code>'io.appium.android.apis'</code>) # <code>query_</code> prefix is also available<br># ruby_lib_core example<br>@driver.app_state(<code>'com.apple.Preferences'</code>)<br>@driver.query_app_state(<code>'io.appium.android.apis'</code>) # <code>query_</code> prefix is also available</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">// Supports only <code>mobile: queryAppState</code> for iOS, XCUITest</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left">// Supports only <code>mobile: queryAppState</code> for iOS, XCUITest</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

iOS tests with XCUITest can also use the mobile: queryAppState method. See detailed documentation.

##### Support #####

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

[详见][Link 1]

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

[详见][Link 1]

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

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

`POST /session/:session_id/appium/device/app_state`

###### 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>bundleId or appId</td> 
   <td><code>string</code></td> 
   <td>BundleId for iOS. Package name for Android.</td> 
  </tr> 
 </tbody> 
</table>

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

Current the target app status. (Clients wrap the response properly) `0` is not installed. `1` is not running. `2` is running in background or suspended. `3` is running in background. `4` is running in foreground. (`number`) //当前目标应用程序状态。（客户端正确包装响应）未安装0。1未运行。2正在后台运行或挂起。3正在后台运行。4正在前台运行。（数字）

[Link 1]: https://blog.csdn.net/weixin_45576146/article/details/115521459?spm=1001.2014.3001.5501