Para 的 iOS 客户端

这是什么？

Para 被设计为一个简单且模块化的后端框架，用于对象持久化和检索。它通过处理后端来帮助您更快地构建应用程序。它在三个级别上工作 - 对象存储在 NoSQL 数据存储或任何旧的 关系型数据库中，然后自动由搜索引擎索引，最后进行缓存。

这是 Para 的 Swift 客户端，适用于 iOS、tvOS、macOS 和 watchOS。

快速入门

Swift 包管理器

将 ParaClient 添加为依赖项到 Package.swift。例如

let package = Package(
    name: "YourPackageName",
    dependencies: [
        .Package(url: "https://github.com/Erudika/para-client-ios.git", majorVersion: 1)
    ]
)

使用方法

按如下方式在代码中初始化客户端

import ParaClient
// avoid using the secret key on mobile devices
let client = ParaClient(accessKey: "ACCESS_KEY", secretKey:"")
client.signIn("facebook", providerToken: "fb_access_token", callback: { user in
    if user != nil {
        // success! user is authenticated, JWT token is saved on the device
        // you can now call the API methods
    }
})

在代码中硬编码您的 Para 秘密密钥不是一个好主意，因为它将在一个不安全的客户端环境中运行。相反，使用 signIn() 方法获取带有有限客户端权限的访问令牌 (JWT)。想想看：API 密钥+秘密 = 完全的 API 访问，paraClient.signIn() = 为具有 JWT 令牌的客户端提供 有限 API 访问。您可以创建一个专门用于您 iOS 应用程序的特殊用户对象，并分配特殊的权限，这样您的应用程序就可以在验证其他真实用户之前访问 Para API 的一部分。有关客户端权限的更多信息，请参阅文档。为了授予客户端用户的资源权限，请前往 console.paraio.org，您可以在那里编辑您的应用程序对象，并允许您的用户调用特定的 API 方法。

要求

• iOS 9.2+ / macOS 10.10+ / tvOS 9.2+ / watchOS 2.2+
• Xcode 7.3+、Swift 2.2+、CocoaPods 1.0+

感谢

特别感谢 Christopher Sexton 将AWS Signature 4 算法移植到 Swift。他的代码被用于本项目中，并且也遵循 Apache 2.0 许可。

文档

阅读文档

贡献

1. 将此仓库Fork，并在您的机器上克隆Fork
2. 创建一个分支（git checkout -b my-new-feature）
3. 实现一个新功能或修复一个bug，并添加一些测试
4. 提交您的更改（git commit -am '添加了一个新功能'）
5. 将分支推送到GitHub上的您的Fork（git push origin my-new-feature）
6. 从您的Fork创建新的Pull Request

更多详细信息请见 CONTRIBUTING.md

许可证

Apache 2.0