Web 脚手架使用说明

1. 生成 Web 应用代码框架

通过 Web 脚手架可以快速生成一个定制的 Web 项目框架, Web 脚手架支持自定义应用名称、应用版本、启动端口等信息,一键即能生成符合平台规范的应用包。

1.1 准备

web脚手架:web-app-scaffold-0.1.zip 开发环境:安装vscode(版本1.92.x)、pnpm(版本9.6.x)、node(版本v20.15.x)、python(版本3.9.x)

1.2 操作步骤

打开 web-app-scaffold-0.1.zip 所在的目录

main

打开终端

main

生成项目框架

下面使用命令创建新的 WEB APP:

cookiecutter web-app-scaffold-0.1.zip

main

命令执行过程中,会提示输入应用编号、应用名称、版本号等信息。

交互式输入应用信息

括号中所显示的值为默认值,不输入信息,直接回车时,使用默认值。

main

回答完后生成如下结构的应用项目目录:

├── build               # 构建脚本
├── dist                # 构建目录
├── src                 # 源码
  ├── bin              # 入口文件
  ├── components       # 组件
  ├── pages            # 页面
  ├── services         # 服务
  ├── utils            # 工具
  ├── app.js           # 应用入口
  ├── index.html       # 首页
  ├── index.js         # 入口文件目录
  ├── constants        # 常量
  ├── README.md        # 项目说明
  └── styles           # 样式
├──  package.json       # 依赖包配置
├── .gitignore          # git忽略文件
├── cookiecutter.json   # 模板配置文件
└── package.py          # 构建脚本

查看项目文件是否生成

当前目录下生成名为web-app的文件夹,此为依据脚手架生成的项目。

main

2. 开发 WEB 应用

使用 VS Code 打开项目

main

开发人员可以通过 VS Code 打开应用目录,编辑源代码,并使用 IDE 的调试工具完成开发和自测。

pnpm拉取依赖

新建终端,执行如下命令。

pnpm i

main

3. 编译打包 WEB 应用

完成开发后,可通过如下命令编译并打包,生成对应的 HOLLiMOS 应用。

python package.py

main

命令执行完成后,可以在目录找到对应的 .tar.gz 文件,即 HOLLiMOS 应用包文件,例如:web-app-0.1.1.tar.gz

查看目录下生成的应用包

main