FirebaseUI for iOS — Firebase的UI绑定
FirebaseUI 是一个开源库,允许您快速将常见的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的所有功能,则存在多个子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项目才能运行示例。
-
您的Xcode项目应该包含从Firebase控制台下载的
GoogleService-Info.plist
,当您将应用程序添加到Firebase项目时下载。
将GoogleService-Info.plist
复制到示例项目目录中(samples/obj-c/GoogleService-Info.plist
或samples/swift/GoogleService-Info.plist
)。 -
更新URL类型。
转到Project Settings -> Info tab -> Url Types
并更新以下值REVERSED_CLIENT_ID
(从GoogleService-Info.plist
获取值)fb{您的-app-id}
(输入Facebook App Id)
-
使用Facebook配置值更新
Info.plist
FacebookAppID -> {您的-app-id}
(输入Facebook App Id)
-
启用密钥链共享。
Facebook SDK需要密钥链共享。
这可以在以下位置完成:Project Settings -> Capabilities -> KeyChain Sharing -> ON
-
别忘了使用Firebase控制台配置您的Firebase App数据库。
数据库应包含适当的读写权限和文件夹(分别是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 证书
上传到 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和如何签署及退回的说明。一旦我们收到它,我们就能接受您的拉取请求。
贡献流程
- 提交一个问题描述您对所需存储库提出更改。
- 存储库所有者将迅速回应您的问题。
- 如果您的建议更改已被接受,并且您尚未这么做,则需要签署贡献者许可协议(请参阅上面的细节)。
- 分支所需的存储库,开发和测试您的代码更改。
- 确保您的代码符合您所贡献的库的现有样式。
- 确保您的代码拥有一组适当的单元测试,并且所有测试都通过。
- 提交一个拉取请求