Ir al contenido

React Native 和 Expo 与 PNPM 环境

使用 Expo CLI 和 PNPM 包管理器为 iOS 和 Android 配置专业的 React Native 开发环境。

0阅读

本指南详细说明了使用 Expo 和依赖管理器 PNPM 为 React Native 准备专业开发环境的标准技术流程。涵盖从系统先决条件到现代多平台(iOS 和 Android)项目的本地初始化和部署。


目前,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: 用于项目版本控制。
  1. JDK(Java 开发工具包): 安装 OpenJDK 17 或更高版本。
  2. Android Studio: 安装 Android Studio 并配置:
    • Android SDK: 确保已下载 Expo 最新版本推荐的 SDK 版本。
    • Android SDK Platform-Tools: 必须添加到系统环境变量(PATH)中。
    • 虚拟设备(AVD): 创建带有 Google Play Services 的模拟器用于本地测试。
  1. Xcode: 直接从 Mac App Store 下载。
  2. Xcode 命令行工具: 在终端中运行以下命令安装:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: iOS 依赖管理器(sudo gem install cocoapods)。

要使用PNPM在Expo中创建一个新的现代React Native项目,请在工作目录中运行官方交互命令:

Ventana de terminal
# Crear proyecto con la plantilla por defecto recomendada usando PNPM
pnpm dlx create-expo-app mi-app-ia --template tabs
mi-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完成依赖安装后,请进入项目文件夹并启动开发服务器:

Ventana de terminal
cd mi-app-ia
pnpm expo start

启动Expo服务器时,将显示二维码和交互式控制选项:

  • a 在Android上打开: 在Android Studio的活动模拟器或通过USB连接的设备上启动应用程序。
  • i 在iOS上打开: 在Xcode的iOS模拟器中启动应用程序(需要macOS)。
  • w 在Web上打开: 启动应用程序的网页版(适用于快速原型设计)。
  • r 重新加载应用程序: 强制刷新所有连接设备的UI界面。

在开始开发前确保环境状态正确。通过PNPM运行Expo的自动化诊断命令:

Ventana de terminal
pnpm dlx expo-doctor
  • ✓ Node.js LTS安装: 兼容且最优版本。
  • ✓ 环境变量: ANDROID_HOME 和 JAVA_HOME 已正确设置。
  • ✓ Android SDK: 已安装最低所需组件,并被 adb 识别。
  • ✓ Expo CLI: SDK 与 package.json 中声明的 React Native 版本保持同步。
  • ✕ Cocoapods(Windows 警告): 如果在此工作站不开发iOS应用,将成功被忽略。