sauveterre/docker-ionic2

Ionic框架运行镜像

镜像概述和主要用途

该Docker镜像提供了运行Ionic框架的便捷环境，无需在本地安装Ionic、Cordova或Node.js。适用于快速开发Ionic应用、进行Android设备测试，并支持通过挂载Gradle缓存目录优化依赖下载流程。

核心功能和特性

• 无需本地配置Ionic、Cordova和Node.js开发环境
• 支持挂载本地Ionic项目目录进行开发
• 提供Android设备测试支持（需开启设备调试模式）
• 支持Gradle缓存挂载，避免重复下载依赖包
• 可通过命令别名简化Ionic命令的使用

使用场景和适用范围

• 希望快速启动Ionic应用开发，无需在本地配置复杂开发环境的用户
• 需要在不同环境中保持一致开发配置的开发团队
• 进行Ionic应用的Android设备测试和调试

使用方法和配置说明

基本使用

运行默认Ionic项目：

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

挂载本地项目

若已有Ionic项目，可挂载本地项目目录运行：

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

命令别名配置

通过设置别名简化Ionic命令使用：

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 agileek/ionic-framework:1.4.5 ionic"

由于Ionic的一个bug，若使用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 agileek/ionic-framework:1.4.5 ionic"

提示：Android开发需要Gradle，建议将~/.gradle挂载到/root/.gradle以避免重复下载依赖。

配置别名后，可直接按照Ionic官方教程（除iOS部分）操作：

bash
ionic start myApp tabs
cd myApp
ionic serve
# 若未使用--net host，需选择IP地址而非localhost，否则无法访问

访问 http://localhost:8100 即可使用应用。

Android设备测试

确保Android设备已开启调试模式，可进行如下测试：

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

常见问题（FAQ）

• 应用未安装到Android设备

  • 尝试运行 docker run -ti --rm -p 8100:8100 -p 35729:35729 --privileged -v /dev/bus/usb:/dev/bus/usb -v \$PWD:/myApp:rw agileek/ionic-framework adb devices，设备应显示在列表中。

• 本地adb devices能看到设备，但Docker内看不到

  • 不能同时在Docker内外运行adb，需先在本地执行adb kill-server再使用该镜像。

未来计划

支持通过X11转发进行Android模拟：

bash
ionic platform emulate android