APP——python——Appium中 setCapability的各种方法

た入场券 2023-10-03 16:57 24阅读 0赞

官方参考网址：[https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md][https_github.com_appium_appium_blob_master_docs_en_writing-running-appium_caps.md]

==========================================================================================================

示例：python脚本

#   adb    shell    dumpsys    window    w    |findstr   \/     |findstr    name=
    #     mSurface=Surface(name=     com.android.mms    /    com.android.mms.ui.ConversationList    )
    
    from appium import webdriver
    import  time
    
    desired_caps = {
        'platformName': 'Android',
        'deviceName':'8DF6R17503000072',
        'platformVersion': '8.0.0',
        'appPackage': 'com.android.mms',
        'appActivity': 'com.android.mms.ui.ConversationList',
         'automationName':'UiAutomator1',
    }
    
    driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)

DesiredCapabilities cap=new DesiredCapabilities(); //map 一组键值对

cap.setCapability("automationName", "Appium"); //appium做自动化

// cap.setCapability("app", "C:\\\\software\\\\jrtt.apk"); //安装apk

// cap.setCapability("browserName", "chrome"); //设置HTML5的自动化，打开谷歌浏览器

cap.setCapability("deviceName", "S4"); //模拟器设备名称 ————DF6R17503000072————adb devices

cap.setCapability("platformName", "Android"); //安卓自动化还是IOS自动化

cap.setCapability("platformVersion", "4.4"); //安卓操作系统版本————adb shell getprop ro.build.version.release————查询Android系统版本

cap.setCapability("udid", "192.168.56.101:5555"); //设备的udid (adb devices 查看到的)

cap.setCapability("appPackage", "com.android.calculator2"); //被测app的包名————adb shell dumpsys window w |findstr \\/ |findstr name=

cap.setCapability("appActivity", ".Calculator"); //被测app的入口Activity名称————adb shell dumpsys window w |findstr \\/ |findstr name=

cap.setCapability("unicodeKeyboard", "True"); //支持中文输入

cap.setCapability("resetKeyboard", "True"); //支持中文输入，必须两条都配置

cap.setCapability("noSign", "True"); //不重新签名apk

cap.setCapability("newCommandTimeout", "10"); //没有新命令，appium10秒退出

driver = new AndroidDriver(new URL("http://127.0.0.1:4723/wd/hub"),cap); //把以上配置传到appium服务端并连接手机

driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); //隐式等待

==============================================================================

Appium 服务关键字

<table> 
 <thead> 
 <tr> 
 <td> 关键字 </td> 
 <td> 描述 </td> 
 <td> 实例 </td> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> automationName </td> 
 <td> 你想使用的自动化测试引擎 </td> 
 <td> Appium&nbsp;(默认)&nbsp;或&nbsp;Selendroid </td> 
 </tr> 
 <tr> 
 <td> platformName </td> 
 <td> 你要测试的手机操作系统 </td> 
 <td> iOS,&nbsp;Android,&nbsp;或&nbsp;FirefoxOS </td> 
 </tr> 
 <tr> 
 <td> platformVersion </td> 
 <td> 手机操作系统版本 </td> 
 <td> 例如：&nbsp;7.1,&nbsp;4.4 </td> 
 </tr> 
 <tr> 
 <td> deviceName </td> 
 <td> 使用的手机类型或模拟器类型 </td> 
 <td> iPhone Simulator,&nbsp;iPad Simulator,&nbsp;iPhone Retina 4-inch,&nbsp;Android Emulator,&nbsp;Galaxy S4,&nbsp;等。在&nbsp;iOS&nbsp;上，这个关键字的值必须是使用&nbsp;instruments -s devices&nbsp;得到的可使用的设备名称之一。在&nbsp;Android&nbsp;上，这个关键字目前不起作用。 </td> 
 </tr> 
 <tr> 
 <td> app </td> 
 <td> .ipa&nbsp;or&nbsp;.apk文件所在的本地绝对路径或者远程路径,也可以是一个包括两者之一的.zip。&nbsp;Appium会先尝试安装路径对应的应用在适当的真机或模拟器上。针对Android系统，如果你指定app-package和app-activity(具体见下面)的话，那么就可以不指定app。&nbsp;会与&nbsp;browserName&nbsp;冲突 </td> 
 <td> 比如/abs/path/to/my.apk或http://myapp.com/app.ipa </td> 
 </tr> 
 <tr> 
 <td> browserName </td> 
 <td> 需要进行自动化测试的手机&nbsp;web&nbsp;浏览器名称。如果是对应用进行自动化测试，这个关键字的值应为空。 </td> 
 <td> iOS&nbsp;系统上可以用&nbsp;'Safari'&nbsp;，Android&nbsp;系统上可以用&nbsp;'Chrome', 'Chromium',&nbsp;或&nbsp;'Browser'。 </td> 
 </tr> 
 <tr> 
 <td> newCommandTimeout </td> 
 <td> 设置命令超时时间，单位：秒。达到超时时间仍未接收到新的命令时&nbsp;Appium&nbsp;会假设客户端退出然后自动结束会话。 </td> 
 <td> 比如&nbsp;60 </td> 
 </tr> 
 <tr> 
 <td> autoLaunch </td> 
 <td> Appium是否需要自动安装和启动应用。默认值true </td> 
 <td> true,&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> language </td> 
 <td> (Sim/Emu-only)&nbsp;设定模拟器&nbsp;( simulator / emulator )&nbsp;的语言。 </td> 
 <td> 如：&nbsp;fr </td> 
 </tr> 
 <tr> 
 <td> locale </td> 
 <td> (Sim/Emu-only)&nbsp;设定模拟器&nbsp;( simulator / emulator )&nbsp;的区域设置。 </td> 
 <td> 如：&nbsp;fr_CA </td> 
 </tr> 
 <tr> 
 <td> udid </td> 
 <td> 连接的物理设备的唯一设备标识 </td> 
 <td> 如：&nbsp;1ae203187fc012g </td> 
 </tr> 
 <tr> 
 <td> orientation </td> 
 <td> (Sim/Emu-only)&nbsp;在一个设定的方向模式中开始测试 </td> 
 <td> LANDSCAPE&nbsp;(横向)&nbsp;或&nbsp;PORTRAIT&nbsp;(纵向) </td> 
 </tr> 
 <tr> 
 <td> autoWebview </td> 
 <td> 直接转换到&nbsp;WebView&nbsp;上下文。默认值&nbsp;false、 </td> 
 <td> true,&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> noReset </td> 
 <td> 不要在会话前重置应用状态。默认值false。 </td> 
 <td> true,&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> fullReset </td> 
 <td> (iOS)&nbsp;删除整个模拟器目录。(Android)&nbsp;通过卸载——而不是清空数据——来重置应用状态。在&nbsp;Android&nbsp;上，这也会在会话结束后自动清除被测应用。默认值&nbsp;false </td> 
 <td> true,&nbsp;false </td> 
 </tr> 
 </tbody> 
</table>

Android特有

<table> 
 <thead> 
 <tr> 
 <td> 关键字 </td> 
 <td> 描述 </td> 
 <td> 实例 </td> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> appActivity </td> 
 <td> 你要从你的应用包中启动的&nbsp;Android Activity&nbsp;名称。它通常需要在前面添加&nbsp;.&nbsp;(如：使用.MainActivity&nbsp;而不是&nbsp;MainActivity) </td> 
 <td> MainActivity,&nbsp;.Settings </td> 
 </tr> 
 <tr> 
 <td> appPackage </td> 
 <td> 你想运行的Android应用的包名 </td> 
 <td> 比如com.example.android.myApp,&nbsp;com.android.settings </td> 
 </tr> 
 <tr> 
 <td> appWaitActivity </td> 
 <td> 你想要等待启动的&nbsp;Android Activity&nbsp;名称 </td> 
 <td> SplashActivity </td> 
 </tr> 
 <tr> 
 <td> deviceReadyTimeout </td> 
 <td> 设置等待一个模拟器或真机准备就绪的超时时间 </td> 
 <td> 5 </td> 
 </tr> 
 <tr> 
 <td> androidCoverage </td> 
 <td> 用于执行测试的&nbsp;instrumentation&nbsp;类。作为命令&nbsp;adb shell am instrument -e coverage true -w&nbsp;的-w&nbsp;参数。 </td> 
 <td> com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation </td> 
 </tr> 
 <tr> 
 <td> enablePerformanceLogging </td> 
 <td> (仅适用于&nbsp;Chrome&nbsp;和&nbsp;webview)&nbsp;开启&nbsp;Chromedriver&nbsp;的性能日志。&nbsp;(默认&nbsp;false) </td> 
 <td> true,&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> androidDeviceReadyTimeout </td> 
 <td> 等待设备在启动应用后准备就绪的超时时间。以秒为单位。 </td> 
 <td> 如&nbsp;30 </td> 
 </tr> 
 <tr> 
 <td> androidDeviceSocket </td> 
 <td> 开发工具的&nbsp;socket&nbsp;名称。只有在被测应用是一个使用&nbsp;Chromium&nbsp;内核的浏览器时需要。&nbsp;socket&nbsp;会被浏览器打开，然后&nbsp;Chromedriver&nbsp;把它作为开发者工具来进行连接。 </td> 
 <td> 如&nbsp;chrome_devtools_remote </td> 
 </tr> 
 <tr> 
 <td> avd </td> 
 <td> 需要启动的&nbsp;AVD (安卓虚拟设备)&nbsp;名称。 </td> 
 <td> 如&nbsp;api19 </td> 
 </tr> 
 <tr> 
 <td> avdLaunchTimeout </td> 
 <td> 以毫秒为单位，等待&nbsp;AVD&nbsp;启动并连接到&nbsp;ADB&nbsp;的超时时间。(默认值120000) </td> 
 <td> 300000 </td> 
 </tr> 
 <tr> 
 <td> avdReadyTimeout </td> 
 <td> 以毫秒为单位，等待&nbsp;AVD&nbsp;完成启动动画的超时时间。(默认值&nbsp;120000) </td> 
 <td> 300000 </td> 
 </tr> 
 <tr> 
 <td> avdArgs </td> 
 <td> 启动&nbsp;AVD&nbsp;时需要加入的额外的参数。 </td> 
 <td> 如&nbsp;-netfast </td> 
 </tr> 
 <tr> 
 <td> useKeystore </td> 
 <td> 使用一个自定义的&nbsp;keystore&nbsp;来对&nbsp;apk&nbsp;进行重签名。默认值&nbsp;false </td> 
 <td> true&nbsp;or&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> keystorePath </td> 
 <td> 自定义&nbsp;keystore&nbsp;的路径。默认：&nbsp;~/.android/debug.keystore </td> 
 <td> 如&nbsp;/path/to.keystore </td> 
 </tr> 
 <tr> 
 <td> keystorePassword </td> 
 <td> 自定义&nbsp;keystore&nbsp;的密码。 </td> 
 <td> 如&nbsp;foo </td> 
 </tr> 
 <tr> 
 <td> keyAlias </td> 
 <td> key&nbsp;的别名 </td> 
 <td> 如&nbsp;androiddebugkey </td> 
 </tr> 
 <tr> 
 <td> keyPassword </td> 
 <td> key&nbsp;的密码 </td> 
 <td> 如&nbsp;foo </td> 
 </tr> 
 <tr> 
 <td> chromedriverExecutable </td> 
 <td> webdriver&nbsp;可执行文件的绝对路径&nbsp;(如果&nbsp;Chromium&nbsp;核心提供了对应的&nbsp;webdriver，应该用它代替&nbsp;Appium&nbsp;自带的&nbsp;webdriver) </td> 
 <td> /abs/path/to/webdriver </td> 
 </tr> 
 <tr> 
 <td> autoWebviewTimeout </td> 
 <td> 以毫秒为单位，等待&nbsp;Webview&nbsp;上下文激活的时间。默认值&nbsp;2000 </td> 
 <td> 如&nbsp;4 </td> 
 </tr> 
 <tr> 
 <td> intentAction </td> 
 <td> 用于启动&nbsp;activity&nbsp;的&nbsp;intent action。&nbsp;(默认值android.intent.action.MAIN) </td> 
 <td> 如&nbsp;android.intent.action.MAIN,android.intent.action.VIEW </td> 
 </tr> 
 <tr> 
 <td> intentCategory </td> 
 <td> 用于启动&nbsp;activity&nbsp;的&nbsp;intent category。&nbsp;(默认值android.intent.category.LAUNCHER) </td> 
 <td> 如&nbsp;android.intent.category.LAUNCHER,android.intent.category.APP_CONTACTS </td> 
 </tr> 
 <tr> 
 <td> intentFlags </td> 
 <td> 用于启动&nbsp;activity&nbsp;的标识&nbsp;( flags ) (默认值&nbsp;0x10200000) </td> 
 <td> 如&nbsp;0x10200000 </td> 
 </tr> 
 <tr> 
 <td> optionalIntentArguments </td> 
 <td> 用于启动&nbsp;activity&nbsp;的额外&nbsp;intent&nbsp;参数。请查看&nbsp;<a href="http://developer.android.com/tools/help/adb.html#IntentSpec" rel="nofollow">Intent&nbsp;参数</a> </td> 
 <td> 如&nbsp;--esn &lt;EXTRA_KEY&gt;,&nbsp;--ez &lt;EXTRA_KEY&gt; &lt;EXTRA_BOOLEAN_VALUE&gt; </td> 
 </tr> 
 <tr> 
 <td> stopAppOnReset </td> 
 <td> 在使用&nbsp;adb&nbsp;启动应用前停止被测应用的进程&nbsp;( process )&nbsp;。如果被测应用是被另一个应用创建的，当这个参数被设定为&nbsp;false&nbsp;时，允许另一个应用的进程在使用&nbsp;adb&nbsp;启动被测应用时继续存活。默认值&nbsp;true </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> unicodeKeyboard </td> 
 <td> 使用&nbsp;Unicode&nbsp;输入法。默认值false </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> resetKeyboard </td> 
 <td> 在设定了&nbsp;unicodeKeyboard&nbsp;关键字的&nbsp;Unicode&nbsp;测试结束后，重置输入法到原有状态。如果单独使用，将会被忽略。默认值&nbsp;false </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> noSign </td> 
 <td> 跳过检查和对应用进行&nbsp;debug&nbsp;签名的步骤。只能在使用&nbsp;UiAutomator&nbsp;时使用，使用&nbsp;selendroid&nbsp;是不行。默认值&nbsp;false </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> ignoreUnimportantViews </td> 
 <td> 调用&nbsp;uiautomator&nbsp;的函数setCompressedLayoutHierarchy()。由于&nbsp;Accessibility&nbsp;命令在忽略部分元素的情况下执行速度会加快，这个关键字能加快测试执行的速度。被忽略的元素将不能够被找到，因此这个关键字同时也被实现成可以随时改变的&nbsp;*设置&nbsp;( settings ) *&nbsp;。默认值&nbsp;false </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 </tbody> 
</table>

iOS特有

<table> 
 <thead> 
 <tr> 
 <td> 关键字 </td> 
 <td> 描述 </td> 
 <td> 实例 </td> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> calendarFormat </td> 
 <td> (Sim-only)&nbsp;为iOS的模拟器设置日历格式 </td> 
 <td> 如&nbsp;gregorian&nbsp;(公历) </td> 
 </tr> 
 <tr> 
 <td> bundleId </td> 
 <td> 被测应用的&nbsp;bundle ID&nbsp;。用于在真实设备中启动测试，也用于使用其他需要&nbsp;bundle ID&nbsp;的关键字启动测试。在使用&nbsp;bundle ID&nbsp;在真实设备上执行测试时，你可以不提供&nbsp;app&nbsp;关键字，但你必须提供&nbsp;udid&nbsp;。 </td> 
 <td> 如&nbsp;io.appium.TestApp </td> 
 </tr> 
 <tr> 
 <td> udid </td> 
 <td> 连接的真实设备的唯一设备编号&nbsp;( Unique device identifier ) </td> 
 <td> 如&nbsp;1ae203187fc012g </td> 
 </tr> 
 <tr> 
 <td> launchTimeout </td> 
 <td> 以毫秒为单位，在&nbsp;Appium&nbsp;运行失败之前设置一个等待&nbsp;instruments&nbsp;的时间 </td> 
 <td> 比如：&nbsp;20000 </td> 
 </tr> 
 <tr> 
 <td> locationServicesEnabled </td> 
 <td> (Sim-only)&nbsp;强制打开或关闭定位服务。默认值是保持当前模拟器的设定 </td> 
 <td> true&nbsp;或&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> locationServicesAuthorized </td> 
 <td> (Sim-only)&nbsp;通过修改&nbsp;plist&nbsp;文件设定是否允许应用使用定位服务，从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时，你同时需要使用&nbsp;bundleId&nbsp;关键字来发送你的应用的&nbsp;bundle ID。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> autoAcceptAlerts </td> 
 <td> 当&nbsp;iOS&nbsp;的个人信息访问警告&nbsp;(如位置、联系人、图片)&nbsp;出现时，自动选择接受( Accept )。默认值&nbsp;false。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> autoDismissAlerts </td> 
 <td> 当&nbsp;iOS&nbsp;的个人信息访问警告&nbsp;(如位置、联系人、图片)&nbsp;出现时，自动选择不接受( Dismiss )。默认值false。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> nativeInstrumentsLib </td> 
 <td> 使用原生&nbsp;intruments&nbsp;库&nbsp;(即关闭&nbsp;instruments-without-delay ) </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> nativeWebTap </td> 
 <td> (Sim-only)&nbsp;在Safari中允许"真实的"，非基于&nbsp;javascript&nbsp;的&nbsp;web&nbsp;点击&nbsp;(tap)&nbsp;。默认值：&nbsp;false。注意：取决于&nbsp;viewport&nbsp;大小/比例，点击操作不一定能精确地点中对应的元素。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> safariInitialUrl </td> 
 <td> (Sim-only) (&gt;= 8.1)&nbsp;初始化&nbsp;safari&nbsp;的时使用的地址。默认是一个本地的欢迎页面 </td> 
 <td> 如https://www.github.com </td> 
 </tr> 
 <tr> 
 <td> safariAllowPopups </td> 
 <td> (Sim-only)&nbsp;允许&nbsp;javascript&nbsp;在&nbsp;Safari&nbsp;中创建新窗口。默认保持模拟器当前设置。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> safariIgnoreFraudWarning </td> 
 <td> (Sim-only)&nbsp;阻止&nbsp;Safari&nbsp;显示此网站可能存在风险的警告。默认保持浏览器当前设置。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> safariOpenLinksInBackground </td> 
 <td> (Sim-only) Safari&nbsp;是否允许链接在新窗口打开。默认保持浏览器当前设置。 </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> keepKeyChains </td> 
 <td> (Sim-only)&nbsp;当&nbsp;Appium&nbsp;会话开始/结束时是否保留存放密码存放记录&nbsp;(keychains) (库(Library)/钥匙串(Keychains)) </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> localizableStringsDir </td> 
 <td> 从哪里查找本地化字符串。默认值&nbsp;en.lproj </td> 
 <td> en.lproj </td> 
 </tr> 
 <tr> 
 <td> processArguments </td> 
 <td> 通过&nbsp;instruments&nbsp;传递到&nbsp;AUT&nbsp;的参数 </td> 
 <td> 如&nbsp;-myflag </td> 
 </tr> 
 <tr> 
 <td> interKeyDelay </td> 
 <td> 以毫秒为单位，按下每一个按键之间的延迟时间。 </td> 
 <td> 如&nbsp;100 </td> 
 </tr> 
 <tr> 
 <td> showIOSLog </td> 
 <td> 是否在&nbsp;Appium&nbsp;的日志中显示设备的日志。默认值false </td> 
 <td> true&nbsp;或者&nbsp;false </td> 
 </tr> 
 <tr> 
 <td> sendKeyStrategy </td> 
 <td> 输入文字到文字框的策略。模拟器默认值：oneByOne(一个接着一个)&nbsp;。真实设备默认值：grouped&nbsp;(分组输入) </td> 
 <td> oneByOne,&nbsp;grouped&nbsp;或setValue </td> 
 </tr> 
 <tr> 
 <td> screenshotWaitTimeout </td> 
 <td> 以秒为单位，生成屏幕截图的最长等待时间。默认值：&nbsp;10。 </td> 
 <td> 如&nbsp;5 </td> 
 </tr> 
 <tr> 
 <td> waitForAppScript </td> 
 <td> 用于判断&nbsp;"应用是否被启动”&nbsp;的&nbsp;iOS&nbsp;自动化脚本代码。默认情况下系统等待直到页面内容非空。结果必须是布尔类型。 </td> 
 <td> 例如&nbsp;true;,target.elements().length &gt; 0;,&nbsp;$.delay(5000); true; </td> 
 </tr> 
 </tbody> 
</table>

[https_github.com_appium_appium_blob_master_docs_en_writing-running-appium_caps.md]: https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md