FirebasePhoneAuthUI 14.2.1

FirebasePhoneAuthUI 14.2.1

Morgan ChenMorgan ChenGoogle维护。



 
依赖项
FirebaseAuth>= 0
FirebaseAuthUI>= 14.2
 

  • Firebase

FirebaseUI for iOS — Firebase的UI绑定

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

FirebaseUI 是一个开源库,允许您快速将常见的UI元素连接到 Firebase 数据库进行数据存储,允许视图在更改时实时更新,并提供了显示列表或项目集合等常见任务的简单接口。

此外,FirebaseUI 通过提供易于使用的身份验证方法简化了Firebase身份验证,这些方法与Facebook、Twitter和Google等常见身份提供者集成,同时还允许开发者使用内置的头满UI来简化开发。

FirebaseUI 客户端也适用于 Androidweb

安装 FirebaseUI for iOS

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

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

如果您不希望使用FirebaseUI的所有功能,则存在多个子spec,可以选择性安装完整功能集的子集

# 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框架添加到您的项目中。添加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项目应该包含从Firebase控制台下载的 GoogleService-Info.plist,当您将应用程序添加到Firebase项目时下载。
    GoogleService-Info.plist 复制到示例项目目录中(samples/obj-c/GoogleService-Info.plistsamples/swift/GoogleService-Info.plist)。

  2. 更新URL类型。
    转到 Project Settings -> Info tab -> Url Types 并更新以下值

    • REVERSED_CLIENT_ID(从 GoogleService-Info.plist 获取值)
    • fb{您的-app-id}(输入Facebook App Id)
  3. 使用Facebook配置值更新 Info.plist

    • FacebookAppID -> {您的-app-id}(输入Facebook App Id)
  4. 启用密钥链共享。
    Facebook SDK需要密钥链共享。
    这可以在以下位置完成: Project Settings -> Capabilities -> KeyChain Sharing -> ON

  5. 别忘了使用Firebase控制台配置您的Firebase App数据库。
    数据库应包含适当的读写权限和文件夹(分别是 objc_demo-chatswift_demo-chat

  6. 为了使用 Phone Auth 提供商,您应该 配置推送通知

配置 Apple 推送通知

在 Xcode 中启用静默推送通知
  • 推送通知 - 在您的应用程序目标中的 能力 选项卡下选择 推送通知 并将开关置于 开启 位置。
  • 后台模式 - 在您的应用程序目标中的 能力 选项卡下选择 后台模式 并将开关置于 开启 位置。在可用模式列表中选择 后台获取远程通知(如果可用)。
将 APNS 证书上传到 Firebase
  1. 通过以下链接上的步骤创建您的 Provisioning APNS SSL Certificateshttps://firebase.google.com/docs/cloud-messaging/ios/certs

  2. 将您的 APNS 证书 上传到 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. 提交一个拉取请求