Ir al contenido

React NativeとExpoの環境 avec PNPM

React Nativeの開発環境のプロフェッショナルな設定方法をExpo CLIとパッケージマネージャーのPNPMを使用してiOSとAndroid向けに学習する。

0閲覧数

このガイドでは、React Native用のプロフェッショナルな開発環境を準備するための標準的な技術手順について説明します。ExpoとPNPM依存関係マネージャーを使用し、システムの要件からプロジェクトの初期化およびローカル配布に至るまで、クロスプラットフォームサポート(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): ハードリンクとコンテンツアドレス可能なストレージに基づくアーキテクチャによって、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)»
  1. JDK(Java Development Kit): OpenJDK 17以上をインストールしてください。
  2. 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)»
  1. Xcode: Mac App Storeから直接ダウンロードしてください。
  2. Xcode Command Line Tools: ターミナルで次を実行してインストール:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: iOS の依存関係マネージャー(sudo gem install cocoapods)。

3. PNPMによるプロジェクト初期化

Sección titulada «3. Inicialización del Proyecto con PNPM»

Expoを用いて< strong>PNPMで新しいモダンな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

4. デベロップメントモードでの実行

Sección titulada «4. Ejecución en Modo de Desarrollo»

PNPMを使用して依存関係のインストールが完了したら、プロジェクトフォルダーにアクセスし、開発サーバーを起動してください:

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

コンソールでのインタラクティブ起動オプション

Sección titulada «Opciones de Lanzamiento Interactivas en la Consola»

Expoサーバーを起動すると、QRコードとインタラクティブなコントロールオプションが表示されます:

  • a Androidで開く: 有効なAndroid StudioエミュレーターまたはUSB接続されたデバイスでアプリケーションを起動します。
  • i iOSで開く: Xcode iOSシミュレーターでアプリケーションを起動します(macOSが必要です)。
  • w Webで開く: アプリケーションの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開発をしていない場合、成功裏に無視されます。