Skip to content

开始

uniapp 端是基于 开源项目项目 Unibest。这是我找了很多 uniapp 启动架子中,算是坑最少了。然后自带的工具也很齐全。包含

  • 请求
  • 状态
  • ui 框架
  • 多语言
  • 图标

等等,这些基本功能都不需要我们去手动开发。我自己使用下来也非常方便。当然目前他的一些代码细节还没有全部理出来。感兴趣的可以基于它深入开发。

warning
这个项目的依赖使用 pnpm,所以第一步你需要先安装 pnpm, 使用 `npm install -g pnpm` 安装

演示图

小程序端,目前配合微应用实现快速启动项目开发,类似 laravel start kit。下图仅作演示,不包含任何实际业务数据。但是基础的用户认证功能已经实现,可以专注于业务实现。

下载项目

个人中心 -> 授权仓库 下载 uniapp 版本,解压进入项目根目录之后,使用下面的命令安装命令

INFO

我建议你使用 pnpm。其实我自己使用 yarn 安装也是可行的。

使用下面的命令初始化安装依赖

shell
pnpm i

项目结构

shell
├── api # 存放接口目录
│   └── login.ts # 登录接口
├── env ## 存放环境变量文件
│   ├── .env
│   ├── .env.development
│   ├── .env.production
│   └── .env.test
├── env.d.ts # 存放环境变量类型定义文件
├── favicon.ico
├── hooks # 存放钩子目录
│   ├── .gitkeep
│   └── useNavbarWeixin.ts # 使用微信导航
├── index.html
├── interceptors # 存放拦截器目录
│   ├── index.ts # 拦截器
│   ├── request.ts # 请求拦截器
│   └── route.ts # 路由拦截器
├── layouts # 存放布局目录
│   ├── default.vue
│   └── demo.vue
├── pages # 存放页面目录
│   ├── index # 首页
│   │   └── index.vue
│   ├── login # 登录页面
│   │   └── index.vue
│   └── my # 个人中心
│       └── index.vue
├── pages-sub # 存放子页面目录
│   └── demo.vue
├── shell
│   └── postinstall.js
├── static # 存放静态资源目录
│   ├── logo.png
│   ├── logo.svg
│   └── tabbar
│       ├── example.png
│       ├── exampleHL.png
│       ├── home.png
│       ├── homeHL.png
│       ├── personal.png
│       └── personalHL.png
├── store # 存放 store 目录
│   ├── count.ts #
│   ├── index.ts #
│   └── user.ts #
├── utils # 工具目录
│   ├── http.ts # http 客户端
│   ├── index.ts # 工具函数
│   └── toPath.ts # 路径跳转
├── tsconfig.json
├── types
│   └── auto-import.d.ts
├── typing.ts
├── commitlint.config.cjs
├── uni.scss
├── uno.config.ts # unocss 配置
├── unocss.css # unocss 样式
├── pages.config.ts # 存放页面配置文件
├── project.config.json
├── project.private.config.json
├── App.vue # 主入口文件
├── main.js # 主入口文件
├── manifest.config.ts
├── package.json
├── .editorconfig
├── .eslintignore
├── .eslintrc-auto-import.json
├── .eslintrc.cjs
├── .gitignore
├── .npmrc
├── .prettierignore
├── .prettierrc.cjs
├── .stylelintignore
├── .stylelintrc.cjs
├── LICENSE
├── README.md
└── vite.config.ts # vite 配置

配置

在开发前,你还需要进行一些基本配置,打开专业版的后台管理。如下图所示,请配置对应的小程序的 appidappsecret小程序配置

然后配置请求的接口, 找到 env/.env 文件,添加以下内容

ts
VITE_APP_TITLE =  // 应用名称

VITE_SERVER_BASEURL =  // 请求的接口地址

开发使用

INFO

开发直接使用 vscode 即可

使用下面的命令启动开发模式

shell
pnpm dev:mp

启动之后打开小程序开发者工具,导入编译的目录,在项目根目录的 dist/dev/mp-weixin。可以看到下面的页面 小程序开发配置

打包

使用下面命令打包小程序

shell
pnpm build:mp-weixin

打包之后小程序在项目根目录 dist\build\mp-weixin,可以通过微信开发者工具上传打包目录