Bmob 多平台示例仓库

Bmob 后端云各平台 SDK 的最小可运行示例集合。每个 Demo 实现统一的 Todo CRUD 与 手机号验证码注册/登录，帮助新手快速跑通核心存储能力。

目录结构

bmob-examples/
├── Android-Kotlin/        # Android SDK 示例（开发中）
├── Android-Java/
├── iOS-ObjC/
├── iOS-Swift/
├── Flutter-Demo/
├── Vue3/                  # ✅ 已实现
├── React/                 # ✅ 已实现
├── Wechat-MiniProgram/    # ✅ 已实现
├── Alipay-MiniProgram/    # ✅ 已实现
├── Web-JS-SDK/             # ✅ 已实现
├── screenshots/           # 示例运行截图
├── NodeJS-Server-Demo/
├── Python-SDK-Demo/
├── PHP-SDK-Demo/
├── HarmonyOS-Demo/
├── Documents/             # 公共文档、环境配置教程
├── .github/               # CI、Issue/PR 模板
└── README.md              # 本文件

快速开始

本仓库提供共用测试应用，克隆后无需申请密钥即可体验。详见 Documents/TestCredentials.md。

配置项	测试值
Application ID	3bfc70f46b36e0d28e7594effbe3392c
REST API Key	3cd32e0ec2a3ca5fe8ffd6a6aa4bf41a

1. 克隆本仓库
2. 阅读 Documents/QuickStart.md 了解通用步骤
3. 进入已实现的平台目录，例如 Vue3/、React/、Web-JS-SDK/、Wechat-MiniProgram/ 或 Alipay-MiniProgram/

Web 端（Vue3 / React）：

cd Vue3   # 或 cd React
cp .env.example .env.local   # 已预填测试密钥，可直接使用
npm install
npm run dev

微信小程序：

cd Wechat-MiniProgram
cp config.example.js config.js   # 已预填测试密钥
npm install
# 微信开发者工具打开本目录 → 工具 → 构建 npm → 编译

支付宝小程序：

cd Alipay-MiniProgram
cp config.example.js config.js   # 已预填测试密钥
npm install
# 支付宝开发者工具打开本目录 → 修改 mini.project.json 中的 appid → 编译

纯 HTML Web JS SDK：

cd Web-JS-SDK
open index.html

或：

cd Web-JS-SDK
python3 -m http.server 8080

运行截图

Vue3 / React

微信 / 支付宝小程序

纯 HTML Web JS SDK

环境要求

平台	最低环境
Web（Vue3 / React）	Node.js 18+，npm / yarn / pnpm
Web（纯 HTML）	现代浏览器
Android	Android Studio，JDK 11+
iOS	Xcode 14+，iOS 15+
Flutter	Flutter 3.x，Dart 3.x
微信小程序	微信开发者工具
支付宝小程序	支付宝小程序开发者工具
Node.js 服务端	Node.js 18+
Python	Python 3.9+
PHP	PHP 7.4+

SDK 版本对应关系

平台	SDK	版本
Vue3 / React / Web / 小程序	hydrogen-js-sdk	3.0.2
Android	bmob-sdk	TBD
iOS (ObjC)	BmobSDK	TBD
iOS (Swift)	BmobSwiftSDK	TBD
Flutter	bmob_plugin	TBD
Python	bmobpy	TBD
PHP	bmob-php-sdk	TBD
HarmonyOS	TBD	TBD

分支说明

分支	说明
main	稳定可运行示例，推荐新手使用
dev	新平台示例开发中，可能不稳定

文档

• AI 协作指南 — 给 Cursor / Codex 等 agent 的项目规则
• 测试用密钥 — 共用测试应用，开箱即用
• 公共概念 — ACL、Pointer、实时、云函数
• 一分钟跑通
• 常见问题
• 贡献指南

实现状态

目录	状态
Vue3	✅ 已实现
React	✅ 已实现
Web-JS-SDK	✅ 已实现
Wechat-MiniProgram	✅ 已实现
Alipay-MiniProgram	✅ 已实现
其余平台	🚧 目录已预留，示例后续补充

License

MIT