StartupJS Docker开发镜像

镜像概述和主要用途

StartupJS是一个全栈框架，包含React Native/React Web前端、ExpressJS后端、MongoDB协作数据库。本Docker镜像提供本地开发环境，集成Node 14.x、Yarn、MongoDB 4.x和Redis 5.x，无需在本地单独安装这些依赖，简化开发环境配置，适用于Windows、MacOS和Linux系统。

核心功能和特性

• 一站式开发环境：内置开发StartupJS所需的全部依赖（Node、Yarn、MongoDB、Redis）
• 跨平台支持：可同时开发Web、Android和iOS应用（注意：Docker不支持移动设备测试）
• 简化项目初始化：通过npx startupjs init快速创建基于官方模板的项目
• 多终端协作：支持同时启动服务器、Web端、Metro bundler等多个开发服务

使用场景和适用范围

• 希望快速搭建StartupJS开发环境，避免本地安装多个依赖的开发者
• 需要在不同操作系统（Windows、MacOS、Linux）上保持一致开发环境的团队
• 初次接触StartupJS，需要快速体验框架功能的开发者
• 不适合需要测试Android或iOS原生功能的场景（需使用本地原生环境）

详细使用方法和配置说明

前提条件

• 已安装Docker

初始化项目

1. 运行以下命令初始化基于ui模板的项目（将myapp替换为项目名称，使用小写）：

docker run --rm -it -v ${PWD}:/ws:delegated startupjs/dev init myapp

2. 进入创建的项目目录：

cd myapp

运行开发容器

1. 启动Docker开发容器：

./docker

启动应用

1. 在运行的容器内，启动应用服务：

yarn start

2. 打开浏览器访问http://localhost:3000开始开发

多终端开发配置

如需同时开发Web和原生应用，需在容器内分终端运行以下命令：

1. 启动服务器（必需，新终端标签）：

yarn server

2. 启动Web端（可选，新终端标签）：

yarn web

3. 启动Metro bundler（原生开发必需，新终端标签）：

yarn metro

额外终端窗口

如需打开额外终端窗口连接到运行中的容器：

./docker exec

官方应用模板

初始化项目时可通过-t参数指定模板（默认使用ui模板）：

• simple：基础模板
• routing：包含路由功能
• ui（默认）：包含路由和UI组件库

示例：使用simple模板初始化项目

docker run --rm -it -v ${PWD}:/ws:delegated startupjs/dev init myapp -t simple

注意事项

• 性能影响：Docker文件挂载可能导致模块安装等操作速度慢于本地环境
• 移动测试限制：无法在Docker环境中测试Android或iOS应用，需使用本地原生环境
• 模板选择：可通过-t参数选择不同项目模板，使用@next获取alpha版本

版本迁移和高级配置

• 如需使用StartupJS的alpha版本，初始化时指定@next：

docker run --rm -it -v ${PWD}:/ws:delegated startupjs@next/dev init myapp

• 如需使用React Native的RC版本，添加-rn next参数：

docker run --rm -it -v ${PWD}:/ws:delegated startupjs/dev init myapp -rn next