React Native 和 Expo 与 PNPM 环境
使用 Expo CLI 和 PNPM 包管理器为 iOS 和 Android 配置专业的 React Native 开发环境。
0阅读
本指南详细说明了使用 Expo 和依赖管理器 PNPM 为 React Native 准备专业开发环境的标准技术流程。涵盖从系统先决条件到现代多平台(iOS 和 Android)项目的本地初始化和部署。
1. Expo 和 PNPM:终极组合
Sección titulada «1. Expo y PNPM: La Combinación Definitiva»目前,React 官方文档和技术社区推荐 Expo 和 PNPM 组合作为绝对标准工作环境:
- Expo Router: 基于文件的路由(类似 Next.js/Astro),完全集成并带有类型支持。
- PNPM(高性能 NPM): 通过物理链接(hard links)和内容寻址存储解决 NPM 的历史性能和漏洞问题。
- EAS Build/Submit: 在云端编译原生二进制文件(
.apk、.aab、.ipa),无需昂贵的本地硬件。
在初始化任何应用程序之前,系统必须安装以下工具:
- Node.js(LTS): 推荐使用活跃的长期支持版本。
- 包管理器:
pnpm(通过npm i -g pnpm或corepack enable全局安装)。 - Git: 用于项目版本控制。
Android 模拟(Windows/macOS/Linux)
Sección titulada «Para Emulación Android (Windows/macOS/Linux)»- JDK(Java 开发工具包): 安装 OpenJDK 17 或更高版本。
- Android Studio: 安装 Android Studio 并配置:
- Android SDK: 确保已下载 Expo 最新版本推荐的 SDK 版本。
- Android SDK Platform-Tools: 必须添加到系统环境变量(
PATH)中。 - 虚拟设备(AVD): 创建带有 Google Play Services 的模拟器用于本地测试。
iOS 模拟(仅限 macOS)
Sección titulada «Para Emulación iOS (Exclusivo en macOS)»- Xcode: 直接从 Mac App Store 下载。
- Xcode 命令行工具: 在终端中运行以下命令安装:
Ventana de terminal xcode-select --install - Cocoapods: iOS 依赖管理器(
sudo gem install cocoapods)。
3. 使用 PNPM 初始化项目
Sección titulada «3. Inicialización del Proyecto con PNPM»要使用PNPM在Expo中创建一个新的现代React Native项目,请在工作目录中运行官方交互命令:
# Crear proyecto con la plantilla por defecto recomendada usando PNPMpnpm dlx create-expo-app mi-app-ia --template tabsmi-app-ia/├── app/ # Directorio de rutas (Expo Router)│ ├── (tabs)/ # Grupo de pestañas de navegación inferior│ │ ├── _layout.tsx # Definición del enrutador de pestañas│ │ ├── index.tsx # Pantalla de inicio│ │ └── explorar.tsx # Pantalla de exploración│ ├── _layout.tsx # Enrutador raíz (Modales, Autenticación, etc.)│ └── +not-found.tsx # Pantalla 404 de respaldo├── assets/ # Imágenes, fuentes y recursos multimedia├── components/ # Componentes UI reutilizables├── constants/ # Colores, configuraciones globales y APIs├── package.json # Dependencias y scripts del ciclo de vida└── app.json # Configuración nativa del manifiesto de Expo在使用PNPM完成依赖安装后,请进入项目文件夹并启动开发服务器:
cd mi-app-iapnpm expo start启动Expo服务器时,将显示二维码和交互式控制选项:
- a 在Android上打开: 在Android Studio的活动模拟器或通过USB连接的设备上启动应用程序。
- i 在iOS上打开: 在Xcode的iOS模拟器中启动应用程序(需要macOS)。
- w 在Web上打开: 启动应用程序的网页版(适用于快速原型设计)。
- r 重新加载应用程序: 强制刷新所有连接设备的UI界面。
在开始开发前确保环境状态正确。通过PNPM运行Expo的自动化诊断命令:
pnpm dlx expo-doctor- ✓ Node.js LTS安装: 兼容且最优版本。
- ✓ 环境变量:
ANDROID_HOME和JAVA_HOME已正确设置。 - ✓ Android SDK: 已安装最低所需组件,并被
adb识别。 - ✓ Expo CLI: SDK 与
package.json中声明的 React Native 版本保持同步。 - ✕ Cocoapods(Windows 警告): 如果在此工作站不开发iOS应用,将成功被忽略。

