Bmob Database — iOS Native SDK

iOS SDK 名为 BmobSDK，是 Objective-C 编写的 framework，Swift 项目通过 Bridging Header 桥接使用。SDK 数据模型以 BmobObject 为核心，不需要为每个表写子类（与 Android 不同）。

核心原则

1. 安装 SDK — 强推 CocoaPods：

# Podfile
target "你的项目名称" do
  platform :ios, "15.6"
  use_frameworks!
  pod 'BmobSDK'
end

pod install

> 装完后只打开 .xcworkspace，不要再打开 .xcodeproj，否则找不到 Pod 引入的库。

也可手动导入 BmobSDK.xcframework，并链接以下系统库（详见 references/install.md）。

2. Swift 必须桥接： 新建任意 .m 文件让 Xcode 弹"Create Bridging Header"，然后在生成的 项目名-Bridging-Header.h 加：

#import <BmobSDK/Bmob.h>

3. 初始化（OC） — AppDelegate.m：

- (BOOL)application:(UIApplication *)application
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // release 上线时启用备案域名，必须在 registerWithAppKey 之前
    // [Bmob resetDomain:@"https://你的备案域名"];
    [Bmob registerWithAppKey:@"你的Application ID"];
    return YES;
}

3. 初始化（Swift / SwiftUI） — AppApp.swift：

@main
struct MyApp: App {
    init() {
        Bmob.register(withAppKey: "你的Application ID")
    }
    var body: some Scene { WindowGroup { ContentView() } }
}

4. 域名重置（上线必做）： 工信部要求正式上线必须用备案域名：

Bmob.resetDomain("https://sdk.yourapp.com")    // 必须在 register 前
Bmob.register(withAppKey: "...")

OC 端用 [Bmob resetDomain:@"https://sdk.yourapp.com"];。

5. 不要硬编码 Master Key 到 App bundle。客户端只用 Application ID（必要时配 Secret Key + 加密授权）。

安全清单

• [ ] release 关闭调试输出：测试期 [Bmob setDebug:YES]，上架前删掉。
• [ ] App Transport Security（ATS）：如果备案域名是 HTTP（不推荐），需要在 Info.plist 加 NSAppTransportSecurity → NSAllowsArbitraryLoads = YES，但 App Store 审核可能拒；尽量用 HTTPS。
• [ ] 写入的表必须配 ACL：否则任意用户可改任意行。
• [ ] Bridging Header 不要 commit 真实 AppKey：用配置文件 / xcconfig / environment 注入。
• [ ] release 前替换备案域名：参见上面"4. 域名重置"。

单条 CRUD（Swift 现代写法）

添加

let gameScore = BmobObject(className: "GameScore")
gameScore.setObject("John Smith", forKey: "playerName")
gameScore.setObject(90, forKey: "score")
gameScore.setObject(false, forKey: "cheatMode")
gameScore.saveInBackground { (isSuccessful, error) in
    if let error = error {
        print("保存失败: \(error.localizedDescription)")
    } else {
        print("保存成功: \(gameScore.objectId ?? "")")
    }
}

查询单条

let bquery = BmobQuery(className: "GameScore")
bquery.getObjectInBackground(withId: "0c6db13c") { (object, error) in
    if let error = error { print(error); return }
    guard let object = object else { return }
    let playerName = object.object(forKey: "playerName") as? String
    let score = object.object(forKey: "score") as? NSNumber
    print(playerName ?? "", score ?? 0)
}

更新（按 objectId）

let gameScore = BmobObject(outDatatWithClassName: "GameScore", objectId: "0c6db13c")
gameScore.setObject(91, forKey: "score")
gameScore.updateInBackground { (isSuccessful, error) in
    if let error = error { print(error) }
}

> 注意 API 名称是 outDatatWithClassName（拼写历史遗留，不要改）——用这个方法获取的 BmobObject 不会先发 GET 查询，直接拿来 update / delete。

删除

let gameScore = BmobObject(outDatatWithClassName: "GameScore", objectId: "0c6db13c")
gameScore.deleteInBackground { (isSuccessful, error) in /* ... */ }

查询列表（带条件 + 排序 + 分页）

let query = BmobQuery(className: "GameScore")
query.whereKey("score", greaterThan: 100)
query.orderByDescending("createdAt")
query.limit = 20
query.skip = 0
query.findObjectsInBackground { (array, error) in
    guard let results = array as? [BmobObject] else { return }
    for obj in results {
        print(obj.objectId ?? "", obj.object(forKey: "playerName") ?? "")
    }
}

单条 CRUD（Objective-C）

// 添加
BmobObject *gameScore = [BmobObject objectWithClassName:@"GameScore"];
[gameScore setObject:@"小明" forKey:@"playerName"];
[gameScore setObject:@78 forKey:@"score"];
[gameScore setObject:[NSNumber numberWithBool:YES] forKey:@"cheatMode"];
[gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
    // ...
}];

// 查询单条
BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore"];
[bquery getObjectInBackgroundWithId:@"0c6db13c"
                              block:^(BmobObject *object, NSError *error) {
    if (object) {
        NSString *playerName = [object objectForKey:@"playerName"];
        BOOL cheat = [[object objectForKey:@"cheatMode"] boolValue];
        NSLog(@"%@ %d", playerName, cheat);
    }
}];

// 更新（不预先 GET，直接构造 + objectId）
BmobObject *gs = [BmobObject objectWithoutDatatWithClassName:@"GameScore" objectId:@"0c6db13c"];
[gs setObject:@91 forKey:@"score"];
[gs updateInBackground];

// 删除
BmobObject *gs = [BmobObject objectWithoutDatatWithClassName:@"GameScore" objectId:@"0c6db13c"];
[gs deleteInBackground];

与 MCP 联动

如已配置 Bmob MCP，先 get_project_tables 拿真实 schema，避免：

• 字段名拼错（setObject:forKey: 不校验 schema）
• BmobObject 与 BmobUser 混用

排错速查

进阶能力（按需读 references/）

参考

• OC 完整 API：develop_doc.md
• Swift 完整 API：swift_develop_doc.md
• Swift Quickstart：swift_quick_start.md
• SDK 源码：
• Swift Demo：
• 错误码：bmob-error-codes
• MCP 联动：bmob-mcp