bmob-database-flutter

# Bmob Database — Flutter / Dart SDK 官方 Flutter 插件 **[`bmob_plugin`](https://pub.dev/packages/bmob_plugin)**（源码 [`bmob-flutter-sdk/data_plugin`](https://github.com/bmob/bmob-flutter-sdk/tree/master/data_plugin)）。数据模型 **继承 `BmobObject` + JSON 序列化**（与 Android 类似），查询用泛型 **`BmobQuery<T>`**，异步返回 **`Future`** + `.then` / `.catchError`。 完整 API 以 [BmobDocs Flutter 文档](https://github.com/bmob/BmobDocs/blob/master/mds/data/flutter/index.md) 为准；agent 可直接 WebFetch `metadata.docs_raw`。 ## 核心原则 **1. 安装与引用** ```bash flutter pub add bmob_plugin ``` ```dart import 'package:bmob_plugin/bmob_plugin.dart'; ``` **2. 初始化** — 控制台 → 设置 → 应用密钥 → **Secret Key**、**API 安全码**；**不要**在客户端填 `masterKey`（第三个可选参数仅服务端场景）。 ```dart // main() 或 App 启动最早处 Bmob.initialize(secretKey, apiSafe); // 不推荐：Bmob.initialize(secretKey, apiSafe, masterKey); ``` **3. 上线换备案域名** — `resetDomain` 必须在 `initialize` **之前**（开发期内置测试域名有请求次数限制）： ```dart Bmob.resetDomain("http://api.yourdomain.com"); Bmob.initialize(secretKey, apiSafe); ``` **4. 自定义表模型** — 每张业务表一个 Dart 类 **extends `BmobObject`**，并实现 `fromJson` / `toJson`（见 [`references/model-and-init.md`](references/model-and-init.md)）。表名默认与类名一致（如 `Blog` → 表 `Blog`）。 **5. 错误处理** — 统一用 `BmobError.convert(e)` 取 `code` / `error`： ```dart }).catchError((e) { final err = BmobError.convert(e); print('${err.code}: ${err.error}'); }); ``` **6. 保留字段** — `objectId`、`createdAt`、`updatedAt`、`ACL` 由 SDK / 服务端维护；业务代码在更新 / 删除时必须设置 `objectId`。 ## 安全清单 - [ ] **客户端不要传 Master Key** 给 `Bmo...