skela/apps Docker 镜像 - 轩辕镜像

镜像概述

本Docker镜像整合了Flutter、Android SDK、Pip3及常用Python包，旨在提供一站式移动应用开发环境。通过预配置核心开发工具，简化本地环境搭建流程，确保开发团队使用一致的依赖版本，适用于Flutter项目开发、Android应用打包及跨平台协作场景。

核心功能与特性

• Flutter集成：包含Flutter SDK（通常为稳定版本），支持Flutter项目创建、代码编译、调试及打包为Android/iOS应用。
• Android SDK支持：内置Android SDK及平台工具，覆盖主流Android API级别，支持Android应用签名、APK/AAB打包及模拟器管理。
• Pip3与Python包：集成Python包管理工具Pip3，并预装常用Python依赖（如requests、numpy、pandas等），满足Python脚本开发及数据处理需求。
• 环境一致性：固化开发工具版本，避免因本地环境差异导致的依赖冲突，支持团队协作及CI/CD流程无缝集成。

使用场景

• Flutter移动应用开发：快速启动Flutter开发环境，无需本地安装Flutter、Android SDK等工具链。
• Android应用打包：在容器内执行flutter build apk或flutter build appbundle，生成Android应用安装包。
• CI/CD流程集成：作为持续集成环境基础镜像，自动化执行代码检查、单元测试、应用构建等流程。
• 跨平台开发协作：统一团队开发环境配置，解决“在我这能运行”的环境不一致问题。

使用方法与配置说明

基本启动命令

通过以下命令启动容器，挂载本地项目目录并进入交互模式：

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

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

常用操作示例

1. 检查Flutter环境

进入容器后，执行flutter doctor验证环境配置：

bash
flutter doctor  # 检查Flutter依赖及Android环境状态

首次使用需接受Android许可证：flutter doctor --android-licenses，按提示输入y确认。

2. 构建Flutter应用

执行Flutter构建命令生成Android应用包：

bash
# 构建调试版APK
flutter build apk --debug

# 构建发布版AAB（Android App Bundle）
flutter build appbundle --release

3. 管理Python依赖

通过Pip3安装/升级Python包：

bash
# 安装Python包
pip3 install requests  # 安装HTTP请求库
pip3 install numpy     # 安装数值计算库

# 升级已安装包
pip3 install --upgrade pandas

4. Android SDK扩展（可选）

如需安装特定Android平台版本，使用sdkmanager命令：

bash
# 查看可安装的Android SDK组件
sdkmanager --list

# 安装Android 13（API 33）平台
sdkmanager "platforms;android-33" "build-tools;33.0.2"

环境变量说明

镜像支持以下环境变量（具体取决于构建配置）：

• FLUTTER_HOME：Flutter SDK路径（默认通常为/usr/local/flutter）。
• ANDROID_HOME：Android SDK路径（默认通常为/usr/local/android-sdk）。
• PATH：已包含Flutter、Android SDK及Python工具路径，无需额外配置。

注意事项

• 设备调试：如需连接物理Android设备调试，需添加USB设备映射参数：

  bash
  docker run -it --rm -v /本地项目路径:/app --device=/dev/bus/usb [镜像名称] /bin/bash
  

• 性能优化：对于大型项目，建议为容器分配足够资源（如--memory=4g限制内存使用）。
• 镜像更新：定期拉取最新镜像以获取工具版本更新（如Flutter稳定版、Android SDK安全补丁）。