start*aut

start*aut 程序将启动一个 Squish 将附加到的 AUT

• androidobserver 启动 Android AUT
• startaut 启动 Qt、macOS 和 Tk AUT
• startjavaaut 启动 Java AUT
• startwinaut 启动本地Windows AUT

请参阅连接到运行中的应用程序，了解启动AUT的示例。

startaut

用法

startaut [--verbose] [--wrapper=toolkit] [--cwd=working目录] [--capture-output] --port=端口号 aut [aut命令行选项]

或者

startaut [--verbose] [--wrapper=toolkit] [--cwd=working目录] --uses-builtin-hook aut [aut命令行选项]

• --verbose参数用于在命令行中显示Squish内部日志消息。

  日志消息输出到标准错误通道。

• --wrapper参数用于指定AUT的GUI工具包，它必须是Qt、Mac或Tk之一。

  如果没有指定--wrapper，默认为Qt。

• --cwd参数用于指定AUT的工作目录。
• --capture-output参数用于抑制所有AUT输出。

  当环境变量SQUISH_NO_CAPTURE_OUTPUT设置不为0时，此选项无效。

  在组合使用--uses-builtin-hook时，此选项无效。

• --port参数用于指定Squish与AUT通信应使用的端口号。

  此参数不应与--uses-builtin-hook一起使用。

• --uses-builtin-hook参数用于指定AUT使用可附加的内置钩子。

  此参数不应与--port一起使用。

• aut参数用于指定AUT的可执行文件。
• 任何aut命令行选项选项都会传递给AUT。

androidobserver

用法

androidobserver [--device serialNumber] [--port 端口号] [--clear-app-settings] [--force-rotation rotation] [--attach-port attachPort] [--no-autostart-observer] [--no-ui-automation] [--web-hookup-timeout msec] [-e key value]* aut

aut

aut是Android包名，是必选参数。包必须在之前由squishide或使用单独的测试包进行仪器化和部署。使用adb启动aut。

–device

当同时连接多个Android设备或运行多个模拟器时，必须使用--device选项，否则该选项是可选的。

–clear-app-settings

在使用--clear-app-settings之前，它会运行Android包管理器的清除命令。

–force-rotation

当截屏被旋转或倒置时，可以使用--force-rotation作为解决方案。旋转值必须是0、1、2或3，分别代表0度、90度、180度或270度。

–port

当需要从命令行启动多个同时测试时，使用--port选项。每个androidobserver将此TCP端口转发到设备或模拟器。默认值为37090。

–attach-port

--attach-port选项用于指定Squish应使用用于与AUT通信的端口号。

–no-autostart-observer

此选项将显著缩短Android应用的启动时间。它跳过部分连接过程。测试脚本必须包含startObserver()函数以完成测试。它可以用来克服启动超时。在ApplicationContext startApplication(autName)与startObserver()之间，对象识别有限。

–no-ui-automation

此选项将禁用AndroidUIAutomation支持（技术上，不使用等待选项运行Squish仪器运行程序）。在Squish版本6.1之前，这默认为启用。Squish版本6.1自动启用UiAutomation（Android 4.3或更高版本）。

–web-hookup-timeout

此选项设置Squish在页面完成事件之后等待多长时间以执行WebView控件连接。

-e 键值

此选项允许将键/值对传递给AndroidIntent。

示例

androidobserver.exe --attach-port 4444 com.froglogic.addressbook

端口号4444必须在与Squish服务器注册为可附加的AUT。

startjavaaut

用法

startjavaaut [--verbose] [--cwd=directory] --port=port aut [aut-command-line-options]

--verbose选项仅用于调试工具本身，通常不使用。--cwd选项用于指定AUT的工作目录。--port选项用于指定Squish应使用该端口号与AUT通信。当然，必须指定aut，并且它必须是一个已映射AUT名称。任何aut-command-line-options选项选项将在startjavaaut程序启动AUT时传递给它。

startwinaut

使用startwinaut作为子进程启动AUT或根据您设置的选项连接到已运行的AUT。

用法

startwinaut --port=port [--aut-timeout=seconds] (--window-title=窗口标题 | --pid=AUT进程ID | [--cwd=directory] 命令 [{命令行选项}])

• --port是必需的，用于指定Squish应用于通信的端口号。
• --aut-timeout可以用来自指定等待给定程序显示GUI的秒数。增加此可以用于显示主窗口需要超过20秒的应用程序。
• --pid选项用于指定要附加的AUT的进程ID。
• --window-title选项用于指定要附加的AUT的窗口标题。值可能使用简单的glob样式通配符（*代表任意字符，?代表任意单个字符）。在这种情况下无法转义*和?字符的特殊意义。
• 命令可能是一个AUT或一个启动AUT的批处理文件。如果在startwinaut程序以这种方式启动时，将传递任何命令行选项选项。
• --cwd用于指定命令的工作目录。

当在控制台窗口（例如 cmd.exe 的窗口）中启动 startwinaut 并使用 --window-title 选项和通配符时，可能会意外找到控制台窗口而不是期望的目标窗口。这是因为控制台窗口标题可能会更改为执行命令。可以通过使用 cmd.exe 内置的 start 命令来克服这个问题，以启动具有新、独立控制台窗口的 startwinaut，该窗口没有动态窗口标题

c:\> start $SQUISHDIR/bin/startwinaut --window-title=somewindow