FirebaseUI for iOS — Firebase 的 UI 绑定

FirebaseUI 是一个开源库，用于 iOS，可让您快速连接常见的 UI 元素到 Firebase 数据库以进行数据存储，允许视图在实时更新时进行更新，并简化了如显示列表或项目集合等常见任务的简单界面。

此外，FirebaseUI 通过提供易于使用的身份验证方法来简化 Firebase 身份验证，这些方法可以与 Facebook、Twitter 和 Google 等常见身份提供者集成，以及允许开发人员使用内置的头套 UI 以便于开发。

FirebaseUI 客户端亦适用于 Android 和 网络。

安装 FirebaseUI for iOS

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

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

如果您不打算使用 FirebaseUI 的全部功能，则有多个子规范可以有选择地安装功能集的子集

# 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 文件。

• 认证
• 电话认证
• 数据库
• Firestore
• 存储

本地设置

如果您想为 FirebaseUI 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 项目应包含一个从 Firebase 控制台 下载的 GoogleService-Info.plist 文件，当您将您的应用程序添加到 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{您的应用 ID}（输入 Facebook App Id）

3. 使用 Facebook 配置值更新 Info.plist

   • FacebookAppID -> {您的应用 ID}（输入 Facebook App Id）

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

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

6. 要使用 电话认证 提供商，您应该 配置推送通知

配置Apple推送通知

在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和如何签署以及返回的说明。

贡献流程

1. 提交一个问题，描述您对有关仓库存亡的提议更改。
2. 仓库存亡所有人将尽快回复您的问题。
3. 如果您的提议更改被接受，并且您尚未这样做，请签署贡献者许可协议（详情请见上文）。
4. 分支所需的仓库存亡，开发并测试您的代码更改。
5. 确保您的代码遵循您所贡献的库的现有风格。
6. 确保您的代码有一套合适的单元测试，并且所有测试都通过。
7. 提交一个pull请求