RN3 Docker镜像文档

概述

RN3 Docker镜像是一个专为React Native 3应用开发设计的完整开发环境。该镜像集成了开发React Native应用所需的全部工具和依赖，让开发者可以快速开始项目开发，无需繁琐的本地环境配置。

核心功能和特性

• 预安装React Native 3及相关依赖包
• 包含Node.js环境，支持JavaScript开发
• 集成Android SDK，支持Android应用构建
• 内置代码热重载功能，加速开发迭代
• 包含常用开发工具：npm、yarn、react-native-cli
• 支持iOS模拟器（需配合宿主机Xcode环境）

使用场景和适用范围

• React Native初学者快速入门环境
• 团队协作时的统一开发环境
• CI/CD流程中的构建环境
• 教学和培训环境
• 多项目并行开发时的环境隔离

安装和使用方法

基本使用

bash
# 拉取镜像
docker pull rn3:latest

# 运行容器
docker run -it --name rn3-dev rn3:latest /bin/bash

开发新应用

bash
# 创建新的React Native项目
docker run -it -v $(pwd):/app rn3:latest react-native init MyApp

# 进入项目目录
cd MyApp

# 启动开发服务器
docker run -it -v $(pwd):/app -p 8081:8081 rn3:latest npm start

运行Android应用

bash
# 确保宿主机已安装Android Studio并配置ADB
# 连接Android设备或启动模拟器

# 构建并运行Android应用
docker run -it -v $(pwd):/app --network host rn3:latest react-native run-android

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  rn3-dev:
    image: rn3:latest
    volumes:
      - ./my-react-native-app:/app
    ports:
      - "8081:8081"
    environment:
      - NODE_ENV=development
      - REACT_NATIVE_PACKAGER_HOSTNAME=192.168.1.100
    network_mode: "host"

注意事项

• 运行iOS应用需要宿主机为macOS系统并安装Xcode
• 首次运行可能需要下载额外的SDK组件，请确保网络通畅
• 为获得最佳性能，建议将项目目录挂载为卷，而非复制到容器内
• 生产环境部署时，请使用专门的生产构建镜像

维护和更新

bash
# 更新镜像
docker pull rn3:latest

# 查看容器日志
docker logs rn3-dev

# 停止容器
docker stop rn3-dev