使用 AntCubeTool

新建工程

act init：新建工程。

➜  ~ act init -h
Usage: act init [options]

在当前目录下初始化一个Cube应用

Options:
  -h, --help        display help for command

启动服务

act prepare：清理历史端口。

act server：开启连接监听。

➜  ~ act prepare --help
Usage: act prepare [options]

准备环境

Options:
  -h, --help  display help for command
  
➜  ~ act server --help
Usage: act server [options]

启动通信服务器

Options:
  -h, --help  display help for command

在 macOS 中一般会组合使用这两条命令。在终端中执行了这两条命令后，在启动成功前不可以关闭终端窗口。启动成功后，在终端可以看到以下信息。期间如需执行其他 act 命令，可打开新的终端窗口执行。

建立连接

• Android 真机预览

• iOS 真机预览

编译工程

act build：编译工程。

➜  ~ act build --help
Usage: act build [options] [path]

编译指定路径下的卡片应用，未指定路径时使用当前路径

Options:
  -p, --path [v]  待编译路径，兼容老版本工具【已废弃: 请直接使用 build [path] 】
  -a, --all <v>   批量编译，兼容老版本工具【已废弃: 请使用 build [path] --batch 】
  --batch         是否为批量处理模式 (default: false)
  --watch         是否打开实时编译，不支持批量处理模式 (default: false)
  -h, --help      display help for command

配置了 --watch 参数时，即打开了实时编译时，ACT 将监听整个工程目录内的文件变更，并在文件保存时自动触发编译。

预览工程

通过 蚂蚁动态卡片-开发工具 可以进行工程预览。更多详情，请参见：

• Android 真机预览

• iOS 真机预览

​实时预览

通过 蚂蚁动态卡片-开发工具 可以进行实时预览。更多详情，请参见：

• Android 真机预览

• iOS 真机预览

查看当前连接二维码

act qrcode：查看当前连接二维码。该命令用于需要重新连接 Playground 设备的场景。act server 长时间运行后，日志过多，无法看到 act server 之前输出的二维码内容，此时就可以通过 qrcode 命令再次查看二维码。

➜  ~ act qrcode --help
Usage: act qrcode [options]

显示可供连接的二维码

Options:
  -o, --onlyInfo  仅输出二维码内容，默认关闭，启用时不会输出二维码模拟图像内容 (default: false)
  -p, --pure      仅输出内容，不包含格式化信息（时间、前缀等） (default: false)
  -h, --help      display help for command

通过配置参数，可以仅输出二维码内容字符串。其他基于 ACT 的工具可以考虑通过这种方式获取到二维码内容。

act qrcode -o -p

查看当前连接设备

act device：查看当前连接设备。该命令主要用于查看当前的 server 上是否有已连接的 Playground 设备，设备未连接时 preview、alive 类预览功能无法工作。

➜  ~ act device --help
Usage: act device [options]

显示当前连接的设备列表

Options:
  -h, --help  display help for command

查看帮助

• 查看支持的指令集

act -h

• 查看指令相关参数

act [command] -h

查看信息

act info