bmob-database-ios

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. 域名重置"。

常见问题

跨平台 Q&A：shared/faq.md。

反模式

见 shared/anti-patterns.md。本端重点：勿 commit 真实 AppKey；ATS 尽量 HTTPS。