FirebaseAuthUI 14.2.3

FirebaseAuthUI 14.2.3

×

由 Morgan Chen，Morgan Chen，Google 维护。

 
依赖项
FirebaseAuth< 12.0, >= 8.0
FirebaseCore>= 0
 

FirebaseAuthUI 14.2.3

  • 由
  • Firebase

FirebaseUI for iOS — Firebase 的 UI 绑定

Anonymous Auth Auth Database Email Auth Facebook Auth Firestore Google Auth OAuth Phone Auth Storage Samples

FirebaseUI 是一个用于 iOS 的开源库，可以快速将常见的 UI 元素连接到 Firebase 数据库，以实现数据存储，并允许视图在实时查看它们如何更改时进行更新，同时为显示列表或物品集合等常见任务提供简单的接口。

此外，FirebaseUI 通过提供易于使用的 auth 方法来简化 Firebase 认证，这些方法可以集成到常见的身份提供者（如 Facebook、Twitter 和 Google）中，并允许开发人员使用内置的头像 UI 以便于开发。

FirebaseUI 客户端也适用于 Android 和 Web。

为 iOS 安装 FirebaseUI

FirebaseUI 支持 iOS 10.0+ 和 Xcode 11+。我们建议使用 CocoaPods，将其添加到您的 Podfile

pod 'FirebaseUI', '~> 8.0'       # Pull in all Firebase UI features

如果您不想使用 FirebaseUI 的全部功能，有多个 subspec 可用来选择性地安装功能集的子集

# Only pull in Firestore features
pod 'FirebaseUI/Firestore', '~> 8.0'

# Only pull in Database features
pod 'FirebaseUI/Database', '~> 8.0'

# Only pull in Storage features
pod 'FirebaseUI/Storage', '~> 8.0'

# Only pull in Auth features
pod 'FirebaseUI/Auth', '~> 8.0'

# Only pull in Facebook login features
pod 'FirebaseUI/Facebook', '~> 8.0'

# Only pull in Google login features
pod 'FirebaseUI/Google', '~> 8.0'

# Only pull in Phone Auth login features
pod 'FirebaseUI/Phone', '~> 8.0'

如果您在 Swift 项目中包含 FirebaseUI，请确保您也具有

platform :ios, '11.0'
use_frameworks!

否则，您可以将此存储库中的 FirebaseUI Xcode 项目包含到您的项目中。您还需要 将 Firebase 框架添加到您的项目中。

文档

FirebaseUI 组件的 README 文件位于各自的工程文件夹中。

本地设置

如果您想为 FirebaseUI for iOS 贡献，您需要运行以下命令来设置环境

$ git clone https://github.com/firebase/FirebaseUI-iOS.git
$ cd FirebaseUI-iOS
$ cd Auth # or PhoneAuth, Database, etc
$ pod install

或者您可以使用 pod try FirebaseUI 来安装 Objective-C 或 Swift 示例项目。

示例项目配置

您需要配置您的 Xcode 项目才能运行示例。

  1. 您的 Xcode 项目应包含一个 GoogleService-Info.plist 文件，当您将应用程序添加到 Firebase 项目时从 Firebase 控制台 下载。
    将 GoogleService-Info.plist 复制到示例项目文件夹 (samples/obj-c/GoogleService-Info.plist 或 samples/swift/GoogleService-Info.plist) 中。

  2. 更新 URL 类型。
    转到 项目设置 -> 信息选项卡 -> URL 类型 并更新以下值：

    • REVERSED_CLIENT_ID（从 GoogleService-Info.plist 获取值）
    • fb{您的-app-id}（放置 Facebook AppId）

  3. 在 Info.plist 中添加 Facebook 配置值

    • FacebookAppID -> {您的-app-id}（放置 Facebook AppId）

  4. 启用密钥链共享。
    Facebook SDK 要求密钥链共享。
    可以在以下位置完成： 项目设置 -> 功能 -> 密钥链共享 -> 开启

  5. 不要忘记使用 Firebase 控制台 配置您的 Firebase 应用数据库。
    数据库应包含适当的读写权限和文件夹（分别为 objc_demo-chat 和 swift_demo-chat）

  6. 要使用 电话身份验证 提供程序，您应该 配置推送通知

配置苹果推送通知

在Xcode中启用静默推送通知
  • 推送通知 - 在您的应用目标中，在 功能 选项卡下选择 推送通知 并将开关拨至 开 位置。
  • 后台模式 - 在您的应用目标中，在 功能 选项卡下选择 后台模式 并将开关拨至 开 位置。在可用模式列表中，选择 后台获取 和 远程通知（如果有）。
将APNS证书上传到Firebase

  1. 按照以下链接中的步骤创建您的 Provisioning APNS SSL Certificates。 https://firebase.google.com/docs/cloud-messaging/ios/certs

  2. 将您的 APNS Certificate 上传到Firebase

    • 在Firebase控制台中，在您的项目中点击齿轮图标，选择 项目设置，然后选择 云消息 选项卡。
    • 为您的开发证书、生产证书或两者同时选择 上传证书 按钮。至少需要一个。
    • 对于每个证书，选择 .p12文件，如果有的话，提供密码。确保此证书的 bundle ID 与您的应用的 bundle ID 匹配。选择 保存。

为 FirebaseUI 做贡献

贡献者许可协议

我们非常乐意接受您的示例应用程序和补丁！在我们可以接受它们之前，我们必须克服几个法律障碍。

请填写个人或企业贡献者许可协议（CLA）。

  • 如果您是编写原创源代码的个人并且您确信您拥有知识产权，那么您需要签署一份[个人CLA](https://developers.google.com/open-source/cla/individual)。
  • 如果您在一家希望您能对其工作做出贡献的公司工作，那么您需要签署一份[企业CLA](https://developers.google.com/open-source/cla/corporate)。

通过以上两个链接之一访问相应的CLA以及签署和退回的说明。一旦我们收到它，我们就能接受您的pull请求。

贡献流程

  1. 提交一个问题描述您要对该repo提出的相关更改。
  2. repo所有者会及时回复您的issue。
  3. 如果您的建议更改被接受，并且您尚未这样做，请签署一份贡献者许可协议（参见上述详细信息）。
  4. 将所需的repo进行分支，开发和测试您的代码更改。
  5. 确保您的代码遵守您所贡献的库的现有风格。
  6. 确保您的代码有一套适当的单元测试，并且所有测试都通过。
  7. 提交一个pull请求