基于 UniApp 和腾讯云开发(CloudBase)的跨平台应用模板,目前已适配 H5 、 微信小程序 、 支付宝小程序 、 抖音小程序 以及 App (iOS/Android),其他端的适配正在开发中。为开发者提供了快速构建全栈跨平台应用的能力。
本项目基于 CloudBase AI ToolKit 开发,通过AI提示词和 MCP 协议+云开发,让开发更智能、更高效,支持AI生成全栈代码、一键部署至腾讯云开发(免服务器)、智能日志修复。
本项目使用了以下腾讯云开发(CloudBase)资源:
├── src/
│ ├── components/
│ │ ├── show-captcha.vue # 登录验证弹窗组件
│ ├── pages/ # 页面文件
│ │ ├── index/ # 首页
│ │ │ ├── index.vue
│ │ │ └── index.json
│ │ ├── demo/ # 云开发演示页面
│ │ │ ├── demo.vue
│ │ │ └── demo.json
│ │ ├── login/
│ │ │ ├── index.vue # 登录主页面
│ │ │ ├── phone-login.vue # 手机验证码登录页面
│ │ │ ├── email-login.vue # 邮箱验证码登录页面
│ │ │ └── password-login.vue # 密码登录页面
│ │ └── profile/ # 用户信息页面
│ │ └── profile.vue # 用户信息查看页面
│ ├── utils/ # 工具函数和云开发初始化
│ │ ├── cloudbase.ts # 云开发配置
│ │ └── index.ts # 通用工具函数
│ ├── static/ # 静态资源
│ ├── App.vue # 应用入口组件
│ ├── main.ts # 应用入口文件
│ ├── pages.json # 页面路由配置
│ └── manifest.json # 应用配置文件
├── cloudfunctions/ # 云函数目录
│ └── hello/ # 示例云函数
│ ├── index.js
│ └── package.json
├── index.html # H5 模板
├── vite.config.ts # Vite 配置
├── tsconfig.json # TypeScript 配置
├── package.json # 项目依赖
├── cloudbaserc.json # CloudBase CLI 配置
└── README.md # 项目说明
npm install
src/utils/cloudbase.ts 文件ENV_ID 变量的值修改为您的云开发环境 IDconst ENV_ID = 'your-env-id'; // 替换为您的云开发环境ID
在云开发控制台的【扩展能力】->【身份认证】->【登录方式】中开启
在云开发控制台的【环境配置】->【安全来源】->【安全域名】中添加:
http://localhost:5173(本地开发)在云开发控制台的【环境配置】->【安全来源】->【安全域名】中添加域名:
tmaservice.developer.toutiao.comdevappid.hybrid.alipay-eco.com在微信小程序管理后台的【开发】->【开发管理】->【开发设置】->【服务器域名】中配置:
request 合法域名:
https://tcb-api.tencentcloudapi.com
https://your-env-id.service.tcloudbase.com
uploadFile 合法域名:
https://cos.ap-shanghai.myqcloud.com
downloadFile 合法域名:
https://your-env-id.tcb.qcloud.la
https://cos.ap-shanghai.myqcloud.com
注意:请将
your-env-id替换为您的实际环境 ID,地域根据您的云开发环境所在地域调整。
在云开发控制台的【环境配置】->【安全来源】->【移动应用安全来源】中添加应用:
your-appSignyour-appAccessKey
在 src/utils/cloudbase.ts 文件中,找到 appConfig 对象,填入您获取到的凭证信息。const appConfig = {
env: config.env || ENV_ID,
timeout: config.timeout || 15000,
appSign: 'your-appSign', // 应用标识
appSecret: {
appAccessKeyId: 1, // 凭证版本
appAccessKey: 'your-appAccessKey' // 凭证
}
# H5 开发
npm run dev:h5
# 微信小程序开发
npm run dev:mp-weixin
# 抖音小程序开发
npm run dev:mp-toutiao
# 支付宝小程序开发
npm run dev:mp-alipay
# App (iOS/Android) 开发
# 1. 使用 HBuilderX 打开项目
# 2. 在顶部菜单栏选择【运行】->【运行到手机或模拟器】-> 选择您的设备
# 注意:目前仅支持 APP、H5、微信小程序、抖音小程序和支付宝小程序开发,其他平台适配开发中
# 构建 H5 版本
npm run build:h5
# 构建微信小程序
npm run build:mp-weixin
# 构建抖音小程序
npm run build:mp-toutiao
# 构建支付宝小程序
npm run build:mp-alipay
# 注意:目前仅支持 H5 、微信小程序、抖音小程序和支付宝小程序构建,其他平台适配开发中
通过 src/utils/cloudbase.ts 访问云开发服务:
import { app, ensureLogin } from './utils/cloudbase'
// 数据库操作
await ensureLogin();
const db = app.database();
const result = await db.collection('users').get(); // 查询数据
await db.collection('users').add({ name: 'test' }); // 添加数据
// 调用云函数
const funcResult = await app.callFunction({ name: 'hello' });
// 调用云托管
app.callContainer({
name: 'helloworld',
method: 'POST',
path: '/abc',
header:{
'Content-Type': 'application/json; charset=utf-8'
},
data: {
key1: 'test value 1',
key2: 'test value 2'
},
}).then((res) => {
console.log(res)
});
// 文件上传
const uploadResult = await app.uploadFile({ cloudPath: 'test.jpg', filePath: file });
// 文件下载
cloudbase.downloadFile({
fileID: "cloud://aa-99j9f/my-photo.png"
}).then((res) => {});
可以使用 CloudBase CLI 或 MCP 工具部署云函数:
# 使用 CloudBase CLI
tcb functions:deploy hello
npm run build:h5dist/build/h5 目录中的文件npm run build:mp-weixindist/build/mp-weixin 目录npm run build:mp-toutiaodist/build/mp-toutiao 目录npm run build:mp-alipaydist/build/mp-alipay 目录项目包含完整的云开发功能演示:
访问演示页面体验完整功能。
# 安装 CloudBase CLI
npm install -g @cloudbase/cli
# 登录
tcb login
# 部署到云开发
tcb framework deploy
欢迎提交 Issue 和 Pull Request 来改进这个模板!
MIT License