项目简介
本项目是基于Parcel的单页活动页自动化构建工具,为开发简单单页活动页而设计。采用TypeScript替代JavaScript、Sass替代CSS,并配置开发和生产两种模式。借助该工具,开发者可快速搭建、打包、测试和部署单页活动页,还支持自动化上传到FTP服务器以及使用Puppeteer进行界面自动化测试。
项目的主要特性和功能
- 开发与生产模式:支持开发和生产两种模式。开发模式下自动生成缓存文件提升热替换效率;生产模式可打包出适用于测试和生产环境的静态文件。
- 自动化构建与部署:具备一键打包、预览、上传FTP服务器功能,且支持测试和生产环境独立配置。
- 自动化测试:集成Puppeteer进行界面自动化测试,保障页面功能正常。
- 灵活的FTP配置:可通过配置文件自定义FTP上传路径和访问路径,方便部署到不同服务器环境。
- 图片优化:打包完成后自动进行图片优化处理,加快页面加载速度。
安装使用步骤
假设用户已下载本项目的源码文件。
1. 安装依赖
在项目根目录下运行以下命令安装项目依赖:
bash
npm install
国内推荐使用cnpm进行安装:
bash
cnpm install
2. 启动开发服务器
在项目根目录下运行以下命令启动开发服务器:
bash
npm start
3. 打包静态文件
根据项目需求打包测试环境或生产环境的静态文件:
- 打包测试环境:
bash
npm run build:test
- 打包生产环境:
bash
npm run build:prod
4. 预览打包文件
打包完成后,可通过以下命令预览打包好的静态文件:
- 预览测试环境:
bash
npm run preview:test
- 预览生产环境:
bash
npm run preview:prod
5. 上传FTP服务器
打包完成后,可直接将静态文件上传到FTP服务器:
- 上传测试环境:
bash
npm run upload:test
- 上传生产环境(建议手动上传或通过Jenkins发布):
bash
npm run upload:prod
6. 自动化测试
在打包完成后,可使用Puppeteer进行界面自动化测试:
bash
npm run test
7. 配置FTP信息
在项目根目录下创建 config.ftp.test.json
和 config.ftp.prod.json
文件,分别配置测试环境和生产环境的FTP信息。文件格式如下:
json
{
"host": "主机",
"user": "用户名",
"password": "密码",
"url": "访问路径",
"uploadPath": "上传路径"
}
确保在 .gitignore
文件中忽略这两个配置文件,避免敏感信息泄露。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】