viperdev/ionic

Ionic-docker镜像说明

镜像概述

该镜像为Ionic 1/2应用开发与Gitlab CI自动化测试提供环境，无需在本地安装Node、Ionic、Cordova等依赖，直接通过Docker容器即可完成应用构建、测试及设备调试。

核心功能

• 包含Node、Npm/Yarn包管理工具
• 支持Ionic 1/2框架及Cordova跨平台开发
• 集成Android SDK与构建工具，可进行Android应用打包
• 内置Google Chrome Headless，支持端到端（e2e）测试
• 提供Ruby及Scss-lint支持，辅助代码质量检查

使用场景

1. Gitlab CI流水线中的自动化构建与测试
2. 本地Ionic应用快速开发调试
3. Android设备上的应用真机测试

配置说明

基础运行命令

bash
docker run -ti --rm -p 8100:8100 -p 35729:35729 docker.xuanyuan.run/marcoturi/ionic

挂载本地项目目录

将本地Ionic项目挂载到容器中运行：

bash
docker run -ti --rm -p 8100:8100 -p 35729:35729 -v /path/to/your/ionic-project/:/myApp:rw docker.xuanyuan.run/marcoturi/ionic

自动化别名设置

添加别名简化命令（支持设备调试与Gradle缓存）：

bash
alias ionic="docker run -ti --rm -p 8100:8100 -p 35729:35729 --privileged -v /dev/bus/usb:/dev/bus/usb -v ~/.gradle:/root/.gradle -v \$PWD:/myApp:rw marcoturi/ionic ionic"

若使用ionic serve需添加--net host：

bash
alias ionic="docker run -ti --rm --net host --privileged -v /dev/bus/usb:/dev/bus/usb -v ~/.gradle:/root/.gradle -v \$PWD:/myApp:rw marcoturi/ionic ionic"

Android测试步骤

1. 启用设备调试模式
2. 执行以下命令：

bash
cd myApp
ionic cordova platform add android
ionic cordova build android
ionic cordova run android

FAQ

• 设备未识别：执行docker run -ti --rm --privileged -v /dev/bus/usb:/dev/bus/usb -v \$PWD:/myApp:rw marcoturi/ionic adb devices检查设备是否列出
• adb冲突：本地运行adb kill-server后再使用容器内adb工具
• Gradle缓存：挂载~/.gradle目录避免重复下载依赖