使用 Expo 快速启动 - React Native SDK
Atlas Device SDK Expo 模板 提供了一个完全正常运行的React Native应用程序,您可以使用该应用程序来引导使用Atlas Device SDK的应用开发项目。本指南介绍了如何初始化和使用模板。
Expo 模板使用:
Expo:用于开发、构建和部署 React Native 应用程序的框架。
@realm/react:一个 npm 包,提供易于使用的 API 来执行常见的 Realm 操作,例如查询或写入数据库以及监听数据库对象。
先决条件
Expo SDK v48 或更高版本
请查看兼容性图表,以确定哪个版本的 Expo SDK 与特定 React Native SDK 版本相兼容。
初始化模板
要初始化模板应用程序,请使用 create-expo-app
。传递标志 --template @realm/expo-template
以根据 Device SDK 模板初始化 React Native 应用程序。
在终端中运行以下命令:
npx create-expo-app AtlasDeviceSdkApp --template @realm/expo-template
安装应用依赖项:
npm install
探索文件结构
相关文件如下:
file | 用途 |
---|---|
Task.ts | 一种 TypeScript 文件,该文件定义任务对象模式并返回 RealmProvider 和钩子。 |
App.ts | 应用程序的入口点,其中包含用于创建、更新和删除任务的方法。 RealmProvider 组件包含 App 组件,为您的整个应用程序提供了访问 Realm 的权限。 |
TaskList.tsx | React 组件,从数据库获取 Task 对象列表并将每个对象呈现为 TaskItem 组件。 |
TaskItem.tsx | 一个用于显示任务描述的 React 组件、一个用于切换任务完成状态的复选框以及一个用于删除任务的按钮。 |
构建并运行应用程序
要在 Android 模拟器上运行应用程序,请从应用程序根目录运行以下命令:
npx expo run:android
要在 iOS 模拟器上运行应用程序,请从应用程序根目录运行以下命令:
npx expo run:ios
当您运行上述命令时,Expo 开发客户端 会自动启动。如果您关闭 Expo dev-client
并希望重新启动它,而无需再次等待原生构建过程,您只需运行:
npx expo start --dev-client
但是,如果您 对原生代码进行了任何更改 ,则必须重新运行npx
expo run:ios
或npx expo run:android
才能重新构建原生 iOS/Android 应用。
部署应用程序
如要部署您的应用程序,我们建议使用 Expo Application Services (EAS) ,这是一组适用于 Expo 和 React Native 应用程序的深度集成式云服务套件。EAS 允许您编译和签署应用,只需一条 CLI 命令即可将应用上传到 Apple App Store 或 Google Play Store,并直接向应用用户推送错误修复或小改动。
或者,请阅读 Expo 分发概述 指南,了解如何创建原生构建、部署到 App Store、避免常见的 App Store 拒绝问题,以及管理不同的发布环境。