此 SDK 从 Parse SDK 分支而来。经过了修改以访问 Backand 的后端服务而不是 Parse 后端。我的意图是与原始的 Parse SDK 保持源级别兼容,并尽可能保留最多功能。我的目标是尽量减少从 Parse 迁移到 Backand 的项目的代码更改。
这是一个库,它让您可以从您的 iOS 或 OS X 应用程序访问 Backand 云平台。有关 SDK 文档,目前请参阅原始的 Parse 文档。有关 Backand 及其功能的更多信息,请参阅网站和入门指南。
要使用此 SDK,请转到 版本 页面,并下载最新构建版本。
Parse.framework
替换为您上面下载的 Backand.framework
#import <Parse/*.h>
替换为 #import <Backand/*.h>
#import <Backand/Backand.h>
替换 #import <Parse/Parse.h>
。然后在项目中的其余部分将 import Parse
替换为 import Backand
到这一点,如果构建并运行您的应用程序,所有内容都应该与原始的 Parse.framework 相同。它仍在与 Parse.com的后端运行,*应该完全正常工作*。您应该看到的唯一区别是调试控制台中确认您现在正在使用 Parse SDK for Backand 的消息。[Parse setApplicationId:clientKey:]
的调用替换为 [Parse setBackandAppName:andSignupToken:]
的调用(您可以从您的 Backand 应用程序中获得这些信息)。(在 swift 中,调用 Parse.setBackandAppName(“BACKAND-APP-NAME”, andSignupToken: "BACKAND-APP-SIGNUP-TOKEN”)
而不是 Parse.setApplicationId(PARSE_APP_ID, clientKey: PARSE_CLIENT_KEY)
)现在您的应用程序正在针对 Backand.com 的后端运行,并且您应该会看到一些 API 调用引发异常(例如,未实现)。注意:您希望将应用程序/数据库从 Parse.com 迁移到 Backand.com。有关迁移说明,请参阅迁移说明
注意:尽管SDK的大部分已经准备好,但确实还有一些区域尚未启动。对于目前尚不支持的大多数场景,会抛出异常,所以您不会错过。请参考项目状态页面以获取最新准备就绪和未准备就绪的列表。如果您需要尚未准备好的SDK部分,请告知我,这将影响我的优先事项。
Backand
和Bolts
添加到您的项目中。SystemConfiguration
、AudioToolbox
和libsqlite3
#import <Backand/Backand.h>
application:didFinishLaunchingWithOptions:
中添加对[Parse setBackandAppName:andSignupToken:]
的调用(您可以从您的Backand应用中获取这些信息)。请参考原始的Parse文档以获取更多信息。
注意:您还需要在Backand UI中创建一个应用,并根据需要定义您的数据库表。与Parse不同,Backand不支持动态构建模式。
CocoaPods
将以下行添加到您的Podfile中
pod 'Backand'
运行pod install
,现在您应该有了最新的parse发布版本。
注意:如果您还使用ParseFacebookUtilsV4
,则需要将该pod替换为BackandParseFacebookUtilsV4
。这是完全相同的代码。唯一的区别是它依赖于Backand pod/framework。它只在构建项目时使用,但我不期望它现在就能工作,因为我没有修改Backand pod中的必要API。
手动编译SDK
如果您想手动编译SDK,请在本地的副本上克隆它,然后在仓库的根目录中运行以下命令
# To pull in extra dependencies (Bolts and OCMock)
git submodule update --init --recursive
# To install all the gems
bundle install
# Build & Package the Frameworks
rake package:frameworks
编译好的框架将在build/release
文件夹中的2个存档内:Backand-iOS.zip
和Backand-OSX.zip
,您可以根据需要链接它们。
将Parse作为子项目使用
您还可以将Parse作为子项目包含在您的应用程序中,尽管我们不推荐这样做,因为它将显著增加您的索引时间。要这样做,只需将Parse.xcodeproj文件拖放到您的工作区中。请注意,如果以这种方式使用Parse,将无法使用单元测试,因为OCMock将无法找到。
此SDK在Backand内部使用以下库作为依赖项