面板小程序命令行工具介绍

Ray 体系提供配套的工程化解决方案。

由于多端构建的一些客观原因，在构建流程的设计上，必须将工程套件安装在项目内。

项目内的依赖至少包含以下内容：

{
  "dependencies": {
    "@ray-js/ray": "latest"
  },
  "devDependencies": {
    "@ray-js/cli": "latest"
  }
}

并且安装的版本一致。注意由于?yarn.lock?等其他锁版本的配置造成影响。

提示：如无法确定，可删除?node_modules?和?yarn.lock?后重装依赖。

命令行调用

在项目内安装完成后，可通过?npx?在终端调用唤起。

{
  "devMode": "ray"
}

# 终端调用
npx ray start -t tuya

也可在?package.json?文件的?scripts?中直接使用。

{
  "scripts": {
    "start:web": "ray start -t web",
    "start:wechat": "ray start -t wechat",
    "build:web": "ray build -t web",
    "build:wechat": "ray build -t wechat"
  }
}

注意事项

• 务必保证?@ray-js/*?依赖的版本最新，否则可能出现 bug。
• 可使用命令?yarn upgrade --scope @ray-js --caret?进行更新操作。

start?启动/预览

启动构建/预览服务，并实时监听项目文件变更。

Tuya MiniApp Tools 自动化执行 start

Tuya MiniApp Tools 可配置启动项目时自动执行 start ，不需要手动在控制台执行?ray start。?project.tuya.json?中配置?devMode: ray，即可在启动项目时关联ray start。

{
  "devMode": "ray"
}

命令说明

ray start ./my-app

注意：其中?my-app?表示项目所在目录。

Usage: ray-start [options] [cwd]
 
启动实时编译/预览。
 
Options:
  --source <folder>        源码目录，默认值 src
  --output <folder>        产物目录
  --mini                   启用压缩构建产物，默认值 true
  --no-mini                禁用压缩构建产物
  -t --target <target>     目标平台
  -a --analyze             开启 analyze 分析，默认值 false
  --type <type>            构建类型，可选值 app 和 component，默认值 app
  --transform-mode <mode>  组件转换类型，可选值 auto 和 pure，默认值 auto
  -h, --help               Display help for this command

Options

source

项目源码目录，默认为?src。

output

构建产物生成目录。

mini

开启后会将生成文件进行一定程度的压缩，会牺牲一定的编译时间。由于 Tuya MiniApp Tools 的限制，启用压缩后一般可符合上传要求。build?模式下默认开启?mini。

注意：?dev?模式下的压缩不等同于?build?模式，实际应用体积大小应以?build?结果为准。

no-mini

禁用压缩构建产物。

target

目标平台，可选值?web、wechat、tuya、ios?和?android。

analyze

启用?analyze?可视化分析。详细信息，参考?Webpack Bundle Analyzer。

type

构建类型，可选值?app?和?component。

transform-mode

组件转换类型，仅在类型为?component?下有效。 可选值?auto?和?pure。

build?构建/预览

生成可用于生产环境部署的代码。

Tuya MiniApp Tools 自动化执行 build

Tuya MiniApp Tools 可配置打包时自动执行 build 的功能，不需要手动在控制台执行?ray build。?project.tuya.json?中配置?devMode: ray，即可在上传项目时关联ray build。

{
  "devMode": "ray"
}

命令说明

ray build ./my-app

注意：其中?my-app?表示项目所在目录。

Usage: ray-build [options] [cwd]
 
执行构建应用/组件
 
Options:
  --source <folder>        源码目录，默认值 src
  --output <folder>        产物目录
  --mini                   启用压缩构建产物，默认值 true
  --no-mini                禁用压缩构建产物
  -t --target <target>     目标平台
  -a --analyze             开启 analyze 分析，默认值 false
  --type <type>            构建类型，可选值 app 和 component，默认值 app
  --transform-mode <mode>  组件转换类型，可选值 auto 和 pure，默认值 auto
  -h, --help               Display help for this command

Options

source

项目源码目录，默认为?src。

output

构建产物生成目录。

mini

开启后会将生成文件进行一定程度的压缩，会牺牲一定的编译时间。由于?Tuya MiniApp Tool?的限制，启用压缩后一般可符合上传要求。build?模式下默认开启?mini。

注意：?dev?模式下的压缩不等同于?build?模式，实际应用体积大小应以?build?结果为准。

no-mini

禁用压缩构建产物。

target

目标平台，可选值?web、wechat、tuya、ios?和?android。

analyze

启用?analyze?可视化分析。详细信息，参考?Webpack Bundle Analyzer。

type

构建类型，可选值?app?和?component。

transform-mode

组件转换类型，仅在类型为?component?下有效。可选值?auto?和?pure。