upskew/flutter-node

Docker Flutter Image

镜像概述

本Docker镜像集成了Flutter、Node.js、SQLite和Git LFS，旨在为Flutter应用开发提供一站式环境，简化开发、构建和测试流程，确保跨平台开发环境的一致性。

核心功能与特性

• Flutter：内置Flutter SDK，支持跨平台（iOS、Android、Web、桌面）应用的开发、编译、调试及打包。
• Node.js：提供JavaScript运行时环境，支持前端构建工具（如npm、yarn）、后端服务开发及JavaScript相关依赖管理。
• SQLite：轻量级嵌入式数据库，适用于应用本地数据存储测试、离线数据处理及开发阶段数据验证。
• Git LFS：Git大文件存储扩展，支持对项目中的大文件（如图像、视频、二进制资源）进行高效版本控制。

使用场景与适用范围

• 本地开发环境统一：快速搭建标准化Flutter开发环境，避免因本地配置差异导致的"在我电脑上能运行"问题。
• CI/CD流程集成：作为持续集成/持续部署流程的基础环境，用于自动化构建、单元测试、UI测试及应用打包。
• 多技术栈项目开发：适用于同时依赖Flutter（前端）、Node.js（后端/构建工具）和本地数据库（SQLite）的全栈项目。
• 团队协作支持：为团队成员提供一致的开发工具链，降低新成员环境配置门槛。

使用方法与配置说明

基础使用（docker run）

通过以下命令启动容器并挂载本地项目目录：

bash
docker run -it --rm \
  -v /本地项目路径:/app \  # 挂载本地Flutter项目到容器内/app目录
  -w /app \                 # 设置工作目录为/app
  --name flutter-dev        # 容器名称（可选）
  flutter-image             # 镜像名称（需替换为实际镜像标签）

参数说明

• -it：交互式终端模式，支持命令行操作。
• --rm：容器退出后自动删除，避免残留临时文件。
• -v /本地项目路径:/app：将本地项目目录映射到容器内，实现代码实时同步。
• -w /app：指定容器内工作目录，默认进入项目根目录。

进阶配置示例

端口映射（Web开发场景）

如需运行Flutter Web应用并暴露端口：

bash
docker run -it --rm \
  -v /本地项目路径:/app \
  -w /app \
  -p 8080:8080 \  # 映射容器8080端口到主机8080端口
  flutter-image \
  flutter run -d web --web-port 8080  # 直接执行Flutter Web运行命令

持久化数据（SQLite数据库）

如需保留SQLite数据库文件，可单独挂载数据目录：

bash
docker run -it --rm \
  -v /本地项目路径:/app \
  -v /本地数据目录:/app/db \  # 单独挂载数据库目录
  -w /app \
  flutter-image

常用命令示例

在容器内可直接使用以下工具命令：

Flutter相关

bash
# 检查Flutter版本
flutter --version

# 创建新项目
flutter create my_app && cd my_app

# 运行Android模拟器（需配置Docker与宿主机模拟器连接，具体参考Flutter官方文档）
flutter run -d android

# 构建APK
flutter build apk

Node.js相关

bash
# 检查Node.js版本
node -v

# 安装项目依赖
npm install

# 运行Node.js脚本
node scripts/build.js

SQLite相关

bash
# 进入SQLite交互模式
sqlite3 /app/db/app.db

# 执行SQL脚本
sqlite3 /app/db/app.db < schema.sql

Git LFS相关

bash
# 跟踪大文件类型
git lfs track "*.psd" "*.zip"

# 查看跟踪配置
git lfs track

# 拉取LFS文件
git lfs pull

注意事项

• 容器内默认无图形界面，如需运行桌面端应用或模拟器，需配置宿主机图形界面转发（如X11转发）。
• 移动端构建需确保容器内已配置对应平台的SDK依赖（如Android SDK、iOS模拟器，具体依赖需参考镜像实际配置）。
• 敏感数据（如密钥、证书）建议通过环境变量或外部挂载方式传入，避免硬编码在容器镜像中。