FirebaseUI for iOS — 为 Firebase 提供的 UI 绑定
FirebaseUI 是一个开源库,允许您快速将常见的 UI 元素连接到 Firebase 数据库以进行数据存储,允许视图在实时更新中更改,并为显示列表或项目集合等常见任务提供简单的接口。
此外,FirebaseUI 通过提供易于使用的认证方法简化了 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项目以运行示例。
-
您的Xcode项目应包含一个从将您的应用添加到Firebase项目时下载的Firebase控制台的
GoogleService-Info.plist
。
将GoogleService-Info.plist
复制到示例项目文件夹中(samples/obj-c/GoogleService-Info.plist
或samples/swift/GoogleService-Info.plist
)。 -
更新URL类型。
转到项目设置 -> 信息选项卡 -> URL类型
并更新以下值:REVERSED_CLIENT_ID
(从GoogleService-Info.plist
中获取值)fb{your-app-id}
(输入Facebook应用ID)
-
使用Facebook配置值更新
Info.plist
FacebookAppID -> {your-app-id}
(输入Facebook应用ID)
-
启用密钥链共享。
Facebook SDK需要密钥链共享。
这可以在以下位置完成:项目设置 -> 能力 -> 密钥链共享 -> 开启
-
别忘了使用Firebase控制台配置您的Firebase应用程序数据库。
数据库应包含适当的读写权限和文件夹(分别为objc_demo-chat
和swift_demo-chat
) -
为了使用
Phone Auth
提供程序,您应该 配置推送通知
配置 Apple 推送通知
在 Xcode 中启用静默推送通知
推送通知
- 在您的应用程序目标的功能
标签页下选择推送通知
,并将开关切换到开启
位置。后台模式
- 在您的应用程序目标的功能
标签页下选择后台模式
,将开关切换到开启
位置。在可用模式列表中选择后台获取
和远程通知
(如果可用)。
将 APNS 证书上传到 Firebase
-
按照以下链接中的步骤创建您的
Provisioning APNS SSL Certificates
。 https://firebase.google.com/docs/cloud-messaging/ios/certs -
将您的
APNS Certificate
上传到 Firebase- 在 Firebase 控制台中,您的项目内,选择齿轮图标,选择
项目设置
,然后选择云消息
选项卡。 - 为您的开发证书、生产证书或两者同时选择
上传证书
按钮。至少需要上传一个。 - 对于每个证书,选择
.p12 文件
,如果有的话,提供密码。确保此证书的bundle ID
与您的应用程序的bundle ID
一致。选择保存
。
- 在 Firebase 控制台中,您的项目内,选择齿轮图标,选择
贡献给 FirebaseUI
贡献者许可协议
我们非常希望能接收您的示例应用程序和补丁!在我们能接收它们之前,我们不得不跨越一些法律障碍。
请填写个人或企业贡献者许可协议(CLA)。
- 如果您是编写原创源代码的个人并且您确信您拥有知识产权,那么您需要签署一个[个人 CLA] (https://developers.google.com/open-source/cla/individual)。
- 如果您为一家希望允许您贡献工作的公司工作,那么您将需要签署一个[企业 CLA] (https://developers.google.com/open-source/cla/corporate)。
通过上面提供的两个链接中的任何一个来访问适当的 CLA 以及如何签署和退还的说明。一旦我们收到它,我们就能接受您的拉取请求。
贡献过程
- 提交一个描述您提议更改的 issue 到相关仓库。
- 仓库所有者会尽快响应您的 issue。
- 如果您的提议更改被接受,并且您尚未这样做,请签署一个贡献者许可协议(见上文详情)。
- 复制所需的仓库,开发和测试您的代码更改。
- 确保您的代码遵循您要贡献的库的现有风格。
- 确保您的代码有一组适当的单元测试并且所有测试都通过。
- 提交一个拉取请求