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

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。

相关推荐
小小王app小程序开发1 小时前
任务悬赏小程序深度细分分析:非技术视角下的运营逻辑拆解
大数据·小程序
2501_915918412 小时前
iOS 26 App 性能测试|性能评测|iOS 26 性能对比:实战策略
android·macos·ios·小程序·uni-app·cocoa·iphone
IT成长日记2 小时前
【Nginx开荒攻略】Nginx虚拟主机配置:从域名、端口到IP的完整指南
linux·运维·服务器·nginx·虚拟主机
瓯雅爱分享3 小时前
Java+Vue构建的采购招投标一体化管理系统,集成招标计划、投标审核、在线竞价、中标公示及合同跟踪功能,附完整源码,助力企业实现采购全流程自动化与规范化
java·mysql·vue·软件工程·源代码管理
光影少年3 小时前
angular生态及学习路线
前端·学习·angular.js
迎風吹頭髮4 小时前
UNIX下C语言编程与实践53-UNIX 共享内存控制:shmctl 函数与共享内存管理
服务器·c语言·unix
黑马金牌编程4 小时前
Linux 服务器常见的性能调优
linux·运维·服务器·性能优化
記億揺晃着的那天5 小时前
Vue + Element UI 表格自适应高度如何做?
javascript·vue.js·ui
无尽夏_5 小时前
HTML5(前端基础)
前端·html·html5
Jagger_5 小时前
敏捷开发流程-精简版
前端·后端