Appium-Running Tests

素颜马尾好姑娘i 2023-01-15 14:23 170阅读 0赞

### Running Tests ###

*   *   *   *   *  Preparing your app for test (iOS)
                 *  Preparing your app for test (Android)
                 *  Preparing your app for test (Windows)
                 *  Running your test app with Appium (iOS)
                 *  Running your test app with Appium (Android)
                 *  Running your test app with Appium (Windows)

##### Preparing your app for test (iOS) #####

Test apps run on the simulator have to be compiled specifically for the simulator, for example by executing the following command in the Xcode project (you can use `xcodebuild -showsdks` to see the list of available SDKs):

在模拟器上测试apps必须专门为模拟器编写
    例如通过根据Xcode项目执行以下命令
    （可以使用'xcodebuild -showsdks'命令查看可用SDK列表）

> xcodebuild -sdk iphonesimulator6.0

This creates a `build/Release-iphonesimulator` directory in your Xcode project that contains the `.app` package that you’ll need to communicate with the Appium server.

创建一个'build/Release-iphonesimulator'目录
    在你的Xcode项目包含
    你需要和Appium server通信的'.app'包

If you want, you can zip up the .app directory into a .zip file! Appium will unpack it for you. Nice if you’re not using Appium locally.

如果你需要，你可以将.app目录压缩到.zip文件中！
    Appium将会帮你打开.
    如果你不在本地使用Appium那就好了

##### Preparing your app for test (Android) #####

Nothing in particular needs to be done to run your .apk using Appium. If you want to zip it up, you can.

使用Appium运行你的.apk不需要特别做什么
    如果你想打开压缩包，你可以打开它

##### Preparing your app for test (Windows) #####

Nothing in particular needs to be done to run your test.

运行你的测试不需要特别的事情

##### Running your test app with Appium (iOS) #####

The best way to see what to do currently is to look at the example tests:

去查看测试用例最好的方式是：

`Node.js` | `Python` | `PHP` | `Ruby` | `Java`

Basically, first make sure Appium is running:

最基本的，首先要确保Appium正在运行

node .

Then script your WebDriver test, sending in the following desired capabilities:

然后编写你的WebDriver测试脚本，发送以下所需功能：

<table> 
 <thead> 
  <tr> 
   <th align="left"></th> 
   <th align="left"></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Java</td> 
   <td align="left">DesiredCapabilities capabilities = new DesiredCapabilities();<br>capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, <code>"iOS"</code>);<br>capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, <code>"7.1"</code>);<br>capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, <code>"iPhone Simulator"</code>);<br>capabilities.setCapability(MobileCapabilityType.APP, myApp);</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">Python</td> 
   <td align="left">{ <br> <code>'platformName'</code>: <code>'iOS'</code>,<br> <code>'platformVersion'</code>: <code>'7.1'</code>,<br> <code>'deviceName'</code>: <code>'iPhone Simulator'</code>,<br> <code>'app'</code>: myApp<br>}</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">Javascript</td> 
   <td align="left">{ <br> platformName: <code>'iOS'</code>,<br> platformVersion: <code>'7.1'</code>,<br> deviceName: <code>'iPhone Simulator'</code>,<br> app: myApp<br> }</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">PHP</td> 
   <td align="left">public static $browsers = array(<br> array(<br> <code>'desiredCapabilities'</code> =&gt; array(<br> <code>'platformName'</code> =&gt; <code>'iOS'</code>,<br> <code>'platformVersion'</code> =&gt; <code>'7.1'</code>,<br> <code>'deviceName'</code> =&gt; <code>'iPhone Simulator'</code>,<br> <code>'app'</code> =&gt; $myApp<br> )<br> )<br>);</td> 
   <td align="left"></td> 
  </tr> 
 </tbody> 
</table>

In this set of capabilities, `myApp` must be either:

在这里功能设置中，'myApp'必须是以下所有

*  A local absolute path to your simulator-compiled .app directory or .zip

本地绝对路径到你的模拟器编译的'.app'目录或'.zip'

*  A url of a zip file containing your .app package

你的 .app package zip file包含url

*  A path to one of the sample app relative to the appium install root

sample app的路径之一和Appium的安装根目录要关联

Using your WebDriver library of choice, set the remote session to use these capabilities and connect to the server running at port 4723 of localhost (or whatever host and port you specified when you started Appium). You should be all set now!

选择你所使用的WebDriver library,
    为使用这些功能设置远程会话
    并连接server运载端口4723
    （或你指定的主机或端口当你启动Appium时）.
    现在你应该一切准备就绪！

##### Running your test app with Appium (Android) #####

First, make sure you have one and only one Android emulator or device connected. If you run `adb devices`, for example, you should see one device connected. This is the device Appium will use for tests. Of course, to have a device connected, you’ll need to have made an Android AVD. If the Android SDK tools are on your path, you can simply run:

第一，确保你有且只有一个Android模拟器或设备连接.
    如果你运行'adb devices',你应该可以看到一个设备已连接.
    这是将用于Appium device测试的.
    当然，要连接设备，
    你将需要制作一个Android AVD.
    如果在你的Android SDK工具在你的路径中，
    你仅需运行：

emulator -avd <MyAvdName>

And wait for the android emulator to finish launching. Sometimes, for various reasons, adb gets stuck. If it’s not showing any connected devices or otherwise failing, you can restart it by running:

等待Android完成启动.
    有时候，处于各种原因，
    adb接收卡顿.
    如果它没有显示任何连接的设备或其他失败，
    你可以运行以下命令重启

adb kill-server && adb devices

Now, make sure Appium is running:

现在，确保Appium正在运行

node .

There are several ways to start an Appium application (it works exactly the same as when the application is started via adb):

这启动Appium application的一些方法

*  apk or zip only, the default activity will be launched (‘app’ capability)
 *  apk + activity (‘app’ + ‘appActivity’ capabilities)
 *  apk + activity + intent (‘app’ + ‘appActivity’ + ‘appIntent’ capabilities)
 *  …

Activities may be specified in the following way:

活动可按以下方式规定

*  absolute (e.g. appActivity: ‘com.helloworld.SayHello’).
 *  relative to appPackage (e.g. appPackage: ‘com.helloworld’, appActivity=’.SayHello’)  
    If the ‘appWaitPackage’ and ‘appWaitActivity’ caps are specified, Appium automatically spins until those activities are launched. You may specify multiple wait activities for instance:

如果明确指定了'appWaitPackage' and 'appWaitActivity'，
    Appium会自动返回直到活动开始.
    你可以指定多个等待活动，例如：

*  appActivity: ‘com.splash.SplashScreen’
 *  appPackage: ‘com.splash’ appActivity: ‘.SplashScreen’
 *  appPackage: ‘com.splash’ appActivity: ‘.SplashScreen,.LandingPage,com.why.GoThere’

If you are not sure what activity are configured in your apk, you can proceed in one of the following ways:

如果你不确定你的apk activity是什么配置，
    你可以通过以下方式之一继续：

*  Mac/Linux: ‘adb shell dumpsys window windows | grep mFocusedApp’
 *  In the Ruby console: ‘adb shell dumpsys window - windows\`.each\_line.grep(/mFocusedApp/).first.strip’
 *  In Windows terminal run ‘adb shell dumpsys window windows’ and manually look for the mFocusedApp line.

Then script your WebDriver test, sending in the following desired capabilities:

然后编写你的WebDriver test脚本，发送以下所需功能：

<table> 
 <thead> 
  <tr> 
   <th align="left"></th> 
   <th align="left"></th> 
   <th align="left"></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Java</td> 
   <td align="left">DesiredCapabilities capabilities = new DesiredCapabilities();<br>capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, <code>"Android"</code>);<br>capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, <code>"4.4"</code>);<br>capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, <code>"Android Emulator"</code>);<br>capabilities.setCapability(MobileCapabilityType.APP, myApp);</td> 
   <td align="left"></td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">Python</td> 
   <td align="left">{ <br> <code>'platformName'</code>: <code>'Android'</code>,<br> <code>'platformVersion'</code>: <code>'4.4'</code>,<br> <code>'deviceName'</code>: <code>'Android Emulator'</code>,<br> <code>'app'</code>: myApp<br>}</td> 
   <td align="left"></td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">Javascript</td> 
   <td align="left">{ <br> platformName: <code>'Android'</code>,<br> platformVersion: <code>'4.4'</code>,<br> deviceName: <code>'Android Emulator'</code>,<br></td> 
   <td align="left"></td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">app: myApp<br> }</td> 
   <td align="left"></td> 
   <td align="left"></td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">PHP</td> 
   <td align="left">public static $browsers = array(<br> array(<br> <code>'desiredCapabilities'</code> =&gt; array(<br> <code>'platformName'</code> =&gt; <code>'Android'</code>,<br> <code>'platformVersion'</code> =&gt; <code>'4.4'</code>,<br> <code>'deviceName'</code> =&gt; <code>'Android Emulator'</code>,<br> <code>'app'</code> =&gt; $myApp<br> )<br> )<br>);</td> 
   <td align="left"></td> 
   <td align="left"></td> 
  </tr> 
 </tbody> 
</table>

In this set of capabilities, myApp must be either:

功能设置里，myApp必须包含以下：

*  A local absolute path to your .apk or a .zip of it
 *  A url of a zip file containing your .apk
 *  A path to one of the sample app relative to the appium install root  
    Using your WebDriver library of choice, set the remote session to use these capabilities and connect to the server running at port 4723 of localhost (or whatever host and port you specified when you started Appium). You should be all set now!

##### Running your test app with Appium (Windows) #####

Simply ensure that Appium is listening, and run your test with your test runner of choice.

仅需确保Appium是监听状态，并手动选择运行你的测试

See our samples for details.