FirebaseUI 14.2.0

FirebaseUI 14.2.0

×

测试已测试✗
Lang语言 Obj-CObjective C
许可协议 Apache-2.0
发布最后发布2024年7月

由Morgan Chen，Mike McDonald，David East，Matthew Tse，Ibrahim Ulukaya，Google，Yury R 维护。

FirebaseUI 14.2.0

  • 由
  • 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 通过提供易于使用的认证方法简化了 Firebase 认证，这些方法可以与 Facebook、Twitter、Google 等通用身份提供商集成，并且允许开发人员使用内置的完整 UI 来简化开发过程。

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

安装 FirebaseUI for iOS

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'

如果您正在将 FirebaseUI 集成到 Swift 项目中，请确保您已有了

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 App Id）

  3. 在Info.plist中更新Facebook配置值

    • FacebookAppID -> {你的-app-id}（输入Facebook App Id）

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

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

  6. 为了使用手机认证提供程序，您应该配置推送通知。

配置 Apple 推送通知

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

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

  2. 将您的 APNS 证书上传到 Firebase

    • 在 Firebase 控制台中，选择齿轮图标，选择项目设置，然后选择云消息标签页。
    • 选择您开发证书、生产证书或两者的上传证书按钮。至少需要一个。
    • 对于每个证书，选择.p12文件并提供密码（如果有的话）。确保此证书的包 ID与您应用的包 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. 提交一个拉取请求