虎牙开放平台文档

命令行工具

创建小程序项目的章节中我们接触到了命令行工具@hyext/cli的一些用法。作伪开发虎牙小程序最重要工具之一,在这个章节简单介绍一下这个命令行工具的作用。

注:最新版本为@hyext/cli version

创建虎牙小程序项目

$ npx hyext init

执行这个命令之后,会在当前目录,使用默认模版初始化一个虎牙小程序项目,并自动安装好对应的依赖,例如虎牙小程序组件库和虎牙小程序JS SDK等依赖库。

启动开发服务

$ npx hyext start

执行这个命令会根据project.config.json里面配置的主机名和端口启动开发服务,有几点要注意的:

  • 如果host配置成localhost
    • 且这台机器只有一个IP地址,则会拿这个IP地址作为host启动APP/助手使用的本地开发服务,以便手机能通过IP地址访问开发服务;
    • 反之,这台机器有多个IP地址,则要显式指定host
  • 如果需要在虎牙主站进行本地开发,需要把https设置成true

开发服务启动后,会在project.config.json里面outputPath(默认是dist)指定的目录生成终端配置文件,供开发者中心使用。

打包代码

$ npx hyext release

执行这个命令后,会在project.config.json里面releasePath(默认是release)指定的目录生成打包后的代码,包括:

  • ${projectConfig.name}目录:打包后的代码
  • ${projectConfig.name}.zip:压缩后的代码zip包,,供开发者中心使用。

理论上会把项目的源码和一部分node_modules里面的依赖代码进行打包,会忽略掉project.config.json里面ignore字段里面的相关代码。

配置终端类型

$ npx hyext config

执行这个命令后,会重新选择这个小程序项目支持的小程序类型,生成对应的入口和配置。我们也可以手动增加这个小程序支持的小程序类型,详情可以参考技术框架project.config.json相关的内容。