面板小程序命令行工具介绍
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 源码目录，默认值 src
--output 产物目录
--mini 启用压缩构建产物，默认值 true
--no-mini 禁用压缩构建产物
-t --target 目标平台
-a --analyze 开启 analyze 分析，默认值 false
--type 构建类型，可选值 app 和 component，默认值 app
--transform-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 源码目录，默认值 src
--output 产物目录
--mini 启用压缩构建产物，默认值 true
--no-mini 禁用压缩构建产物
-t --target 目标平台
-a --analyze 开启 analyze 分析，默认值 false
--type 构建类型，可选值 app 和 component，默认值 app
--transform-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。