使用Parse React Native实时更新实现最佳实践
欢迎使用 Parse React Native 库!在本指南中,您将了解 Parse React 库是什么,如何在您的 React Native 项目中安装和开始使用它。
将 Parse/Back4App 集成到基于 Javascript 的项目中最简单的方法是通过 Parse Javascript SDK. 该库适用于多种 Javascript 环境,如 NodeJS、ReactJS、VueJS、AngularJS、React-Native,并为您提供对 Back4App 功能的访问。
Parse React Native 的目标是通过提供一个轻量级且易于使用的层,使 React Native 开发者的体验更好,该层提供最小的配置、代码重用和 Android 和 iOS 的原生优化。
使用此包将确保设置凭据、HTTP 请求、实时同步、离线优先交互等项目自动可用于您的 React Native 应用。该库完全用 Typescript 编写,基于 Parse Javascript SDK, 目前处于 Alpha 版本。
在本初始指南中,您将安装并设置 @parse/react-native 库在您的 React Native 项目中。
Parse React Native 目前处于 Alpha 版本。该库正在测试中,因此我们建议谨慎使用。我们非常感谢您的反馈,因此请随时使用该库,并通过发送电子邮件至 [email protected] 向我们提出您的问题和初步印象。
要完成本教程,您需要:
如果您没有 React Native 应用,请使用以下命令行创建一个新项目,使用 npx 包运行器:
在您的 React Native 应用中安装 @parse/react-native 及其对等依赖 parse:
为了让应用安全地连接到 Back4App 服务器,您必须向 Parse JavaScript SDK 提供应用的凭据。
你可以找到你的应用程序 ID 和 JavaScript 密钥 凭据,通过打开你的应用程序 仪表板 在 Back4App 网站 并点击 应用程序设置 > 核心设置, 在 服务器设置 下.
你的子域名必须在 应用程序设置 > 核心设置 > 服务器 URL 和实时查询. 有关更多信息,请查看此指南 这里.
接下来,你将构建你的第一个查询并在你的应用程序中显示它。 @parse/react-native 库导出了一个 useParseQuery 钩子,因此你不会浪费时间去研究如何实现离线支持、实时更改等功能.
它需要一个 Parse.Query 并返回一个对象,其中包含一些属性,您可以使用这些属性访问查询返回的数据:
在将查询传递给钩子时,它将首先查找可能已存储的缓存结果。然后,它创建一个 WebSocket 连接与 Back4app LiveQuery 服务器进行通信,该服务器会自动同步。换句话说,离线优先的方法和实时更改默认启用。
要检查查询状态,请使用 props 钩子返回的内容:
- IsLive: 如果true, 表示查询已订阅实时更新。
- isLoading: 如果true, 查询正在获取结果。
- isSyncing: 如果true, 查询正在从 Back4app 服务器获取更新结果。
- results: 这是查询返回的数据。
- count: 表示与查询匹配的对象数量。
- error: 当查询出现问题时,它会返回一个错误。
- reload: 重新加载您的查询结果。
该 useParseQuery 接受任何 Parse.Query,您可以查看 完整文档,其中包含有关 Parse 查询的示例。
现在您应该能够运行您的 React Native 应用程序并查看结果。
请记住,您应该向您的 Back4app 项目添加一些数据,以便在您的应用中看到一些项目。
此时,您已经在项目中安装了 @parse/react-native,配置了与 Back4App 的连接,并编写了您的第一个查询。在下一个指南中,您将看到这个库的主要功能之一,如何使用它。让我们继续到 “实时变化” 开始编写更多查询。