Backand 0.1.3

Backand 0.1.3

测试已测试
Lang语言 Obj-CObjective C
许可证 BSD
发布最后发布2016年3月

Juddster 维护。



Backand 0.1.3

  • Backand(依靠 Parse 屹立)

Backand SDK for iOS/OS X/watchOS/tvOS

此 SDK 从 Parse SDK 分支而来。经过了修改以访问 Backand 的后端服务而不是 Parse 后端。我的意图是与原始的 Parse SDK 保持源级别兼容,并尽可能保留最多功能。我的目标是尽量减少从 Parse 迁移到 Backand 的项目的代码更改。

这是一个库,它让您可以从您的 iOS 或 OS X 应用程序访问 Backand 云平台。有关 SDK 文档,目前请参阅原始的 Parse 文档。有关 Backand 及其功能的更多信息,请参阅网站入门指南

入门

要使用此 SDK,请转到 版本 页面,并下载最新构建版本。

从 Parse 迁移现有项目到 Backand

  1. 将项目中的 Parse.framework 替换为您上面下载的 Backand.framework
  2. 在整个项目中,将 #import <Parse/*.h> 替换为 #import <Backand/*.h>
  3. 在 swift 项目中,在 bridging_header.h 中,使用 #import <Backand/Backand.h> 替换 #import <Parse/Parse.h>。然后在项目中的其余部分将 import Parse 替换为 import Backand 到这一点,如果构建并运行您的应用程序,所有内容都应该与原始的 Parse.framework 相同。它仍在与 Parse.com的后端运行,*应该完全正常工作*。您应该看到的唯一区别是调试控制台中确认您现在正在使用 Parse SDK for Backand 的消息。
  4. 在您的应用程序委托中,将 [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部分,请告知我,这将影响我的优先事项。

新项目

  1. 将您上面下载的框架BackandBolts添加到您的项目中。
  2. 此外,还需要添加框架: SystemConfigurationAudioToolboxlibsqlite3
  3. 在您的AppDelegate中添加 #import <Backand/Backand.h>
  4. 在您的application:didFinishLaunchingWithOptions:中添加对[Parse setBackandAppName:andSignupToken:]的调用(您可以从您的Backand应用中获取这些信息)。
  5. 您已经设置好了。运行您的应用,您将在调试控制台看到消息,确认您现在正在使用Backand的Parse SDK。

请参考原始的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.zipBackand-OSX.zip,您可以根据需要链接它们。

  • 将Parse作为子项目使用

    您还可以将Parse作为子项目包含在您的应用程序中,尽管我们不推荐这样做,因为它将显著增加您的索引时间。要这样做,只需将Parse.xcodeproj文件拖放到您的工作区中。请注意,如果以这种方式使用Parse,将无法使用单元测试,因为OCMock将无法找到。

依赖

此SDK在Backand内部使用以下库作为依赖项

  • Bolts,用于任务管理。
  • OCMock,用于单元测试。