microservice / sl-express · Files

CLI_README.md 3.63 KB

神领物流快递员端 - Uni-CLI 项目

项目说明

本项目已从 HBuilderX 项目成功转换为 uni-cli 项目，现在支持在 Linux 环境下进行开发和打包。

项目结构

project-wl-kuaidiyuan-uniapp-vue3/
├── src/                    # 源代码目录
│   ├── pages/             # 页面文件
│   ├── components/        # 组件
│   ├── static/            # 静态资源
│   ├── store/             # Vuex 状态管理
│   ├── utils/             # 工具函数
│   ├── styles/            # 样式文件
│   ├── uni_modules/       # uni-app 插件
│   ├── App.vue            # 应用入口组件
│   ├── main.js            # 应用入口文件
│   ├── pages.json         # 页面配置
│   └── manifest.json      # 应用配置
├── package.json           # 项目依赖配置
├── vite.config.js         # Vite 构建配置
└── index.html             # HTML 模板

## 环境要求

- Node.js >= 16.0.0
- npm >= 7.0.0

## 安装依赖

```bash
npm install

开发命令

H5 开发

npm run dev:h5

小程序开发

# 微信小程序
npm run dev:mp-weixin

# 支付宝小程序
npm run dev:mp-alipay

# 百度小程序
npm run dev:mp-baidu

# QQ小程序
npm run dev:mp-qq

# 头条小程序
npm run dev:mp-toutiao

App 开发

# Android
npm run dev:app-android

# iOS
npm run dev:app-ios

# 通用 App
npm run dev:app

生产构建

H5 构建

npm run build:h5

小程序构建

# 微信小程序
npm run build:mp-weixin

# 支付宝小程序
npm run build:mp-alipay

# 其他小程序平台...

App 构建

# Android
npm run build:app-android

# iOS
npm run build:app-ios

# 通用 App
npm run build:app

构建输出

构建完成后，文件将输出到 dist/build/ 目录下：

  • H5: dist/build/h5/
  • 小程序: dist/build/mp-[平台]/
  • App: dist/build/app/

App 打包说明

Android 打包

  1. 执行构建命令：

    npm run build:app-android

  2. 构建完成后，打开 HBuilderX，导入 dist/build/app 目录

  3. 在 HBuilderX 中进行云打包或本地打包

Linux 环境下的替代方案

由于 App 的最终打包仍需要原生环境，在 Linux 下有以下选择：

  1. 使用 HBuilderX Linux 版本（推荐）

    • 下载 HBuilderX Linux 版本
    • 导入 dist/build/app 目录进行打包

  2. 使用离线打包

    • 将 dist/build/app 目录中的资源集成到原生 Android/iOS 工程
    • 使用 Android Studio 或 Xcode 进行打包

  3. CI/CD 集成

    • 在 CI/CD 流程中使用 uni-cli 构建
    • 构建产物可以上传到云打包服务

主要变更

从 HBuilderX 项目转换为 uni-cli 项目的主要变更：

  1. ✅ 添加了 package.json，包含完整的依赖和构建脚本
  2. ✅ 添加了 vite.config.js 配置文件
  3. ✅ 源代码移动到 src/ 目录
  4. ✅ 添加了 vuex 依赖（项目使用了状态管理）
  5. ✅ 配置了所有主流平台的开发和构建命令

依赖版本

  • Vue: 3.3.4
  • Vite: 5.2.8
  • Vuex: 4.0.2
  • @dcloudio/vite-plugin-uni: 3.0.0-alpha-4080720251125001

注意事项

  1. 构建时会有一些 SASS 弃用警告，这是 uni-app 内置样式库的问题，不影响功能
  2. 开发时建议使用 H5 模式进行快速调试：npm run dev:h5
  3. App 打包前请确保 manifest.json 中的配置正确
  4. 首次构建可能需要较长时间，请耐心等待

技术支持

如有问题，请参考：