要尝试示例应用程序(NB Sample),请按以下步骤操作。
请确保克隆此代码库并下载 Xcode。您最终需要运行和构建 NBClientExample 项目。在之前,您需要安装一些依赖项
~> sudo gem install -N cocoapods
nationbuilder-ios> pod install
打开 NBClient.workspace
。确保删除位于 ./NBClientExample/NBClientExample/NationBuilder-Info-Local.plist
的配置文件。使用 NBClientExample
方案进行构建和运行。
使用 NationBuilder 控制面板,转到 设置
> 应用
> 安装新应用
。为您所在的国度安装 NBClientExample
应用。
在 iOS 模拟器中打开之前构建的 NB Sample
应用。
在应用中,单击左上角的登录按钮。提供您国度的别名。在应用内 Safari 窗口(SFSafariViewController
)中,登录您的账号并授权此应用。
有关如何使用 SDK 构建您的应用程序的说明,请参阅文档部分和实现清单。请注意,示例应用旨在成为使用 NBClient 库的一个适度示例。它旨在使用现代 iOS 习惯,没有外部依赖项,并且使用标准的 UIKit 类。
如果示例应用中的代码太多,我们提供了含样本 UIAppDelegate
子类的 Objective-C 和 Swift 代码示例。
现在支持 Swift。它已在 Xcode 6.3+ 上进行测试。在使用 SDK 与 Swift 一起使用时,还需要执行一些额外操作,这些操作已在代码示例中列出。
通过应用内的 Safari 窗口(SFSafariViewController
),登录您的国家并授权应用程序。
登录多个国家或同一国家的不同账户。账户会在应用中使用过程中被保存并保持持久。
使用客户端通过NationBuilder API获取和操作数据,以便您有更多时间专注于构建您应用的其他部分。
NBClient可通过CocoaPods获取。要安装它,只需将以下行添加到Podfile文件中:
pod 'NBClient', '~> 1.3.0'
SDK需要iOS 9或更高版本。所有包含的UI组件(账户组件,示例应用)都是通用的,支持iPhone和iPad。
详细指南和代码示例可在NationBuilder的iOS开发者文档中找到。或者,如果你更喜欢在Github上阅读或希望提交修改,可在Github上找到指南。
您可以通过将参数传递到.travis.yml
中,并使用xctool
(brew install xctool
)运行来手动运行测试。更简单的替代方法是运行位于NBClient
方案的Xcode中的测试。
NBClient在MIT许可下可用。有关更多信息,请参阅LICENSE文件。
NBClient/UI组件使用了Pixeden的Stroke 7图标字体集合。