Ionic 入门踩坑记录

从零开始安装配置 ionic 并创建 helloIonic 项目

  • 推荐安装 node v6.10.2 LTS 版本,如果使用最新版本 v7.8.0 会遇到错误。
  • 安装 cordova & ionic
    • npm install -g cordova ionic
  • 创建项目
    • ionic start helloIonic tabs --v2
    • 以上命令从 ionic 已有的 tabs 模板创建名称为 ‘helloIonic’ 的项目
      • ionic 提供了如下几个模板:tabs、sidemenu、blank、super、tutorial
      • 如果不指定模板则会默认使用tabs模板创建项目
    • 省略参数 --v2 则会使用 Ionic v1 创建项目
  • 进入项目目录
    • cd helloIonic
  • 启动项目:如下三种方式启动项目
    1. 通过 ionic serve 在浏览器中调试运行项目
    2. 在 Android 模拟器或者真机上运行项目
    3. 将项目导入到 WebStorm 中,在 Run/Debug Configurations 窗口中,添加 PhoneGap/Cordova 类型的Configuration,并设置好 Command 及 Platform 参数,即可直接从 WebStorm 中运行项目

如何在 Android 真机或者模拟器上调试运行 ionic 项目

  • 首先需要安装好 android sdk,并配置好 ANDROID_HOME 环境变量
  • 进入项目目录,执行以下命令:
    • ionic platform add android (添加 android 平台)
    • ionic build android (生成 android 的 apk 文件)
    • ionic emulate android (在模拟器上运行)
    • 上述 build、emulate两个命令亦可使用 ionic run android 代替
      • ionic run android (在模拟器或者真机上运行)
      • 若连接有多台手机,可以通过添加参数 --target=[真机标识码] 来安装到指定手机
      • 命令 avd devices 可以获取可用的模拟器或真机的标识码等信息。
  • 注意:
    • android sdk tools 如果是最新的 v26.+ 版本,则会报错,需要卸载该版本的sdk tools,建议安装较老的 v25.2.3 版本,再按照上述步骤,则可以成功在模拟机或者真机上运行。

    • 在模拟器或真机上运行后会遇到网络连接的问题,解决方式如下:

      • 修改 platforms\android\platform_www\cordova.js 文件第928行代码为:
      • nativeToJsBridgeMode = nativeToJsModes.ONLINE_EVENT
      • 之后再执行 ionic run android 命令尝试运行即可,如果还是无法登录,继续修改platforms\android\assets\cordova.js文件(该文件应该是上面文件在Cordova build android拷贝得到的,原则上会随之更改)第928行代码为:nativeToJsBridgeMode = nativeToJsModes.ONLINE_EVENT,重新运行即可。
    • 在浏览器中运行也会有网络连接的问题,解决方式如下:

      • 安装并启用 Allow-Control-Allow-Origin 插件(chrome拓展程序)使网络连接正常
      • 如果依然提示网络连接错误,则尝试刷新或重启浏览器

ionic 项目结构(以 helloIonic 项目的目录结构为例)

  • hooks 该目录下的文件是在编译 cordova 时自定义的脚本命令,方便整合到我们的编译系统和版本控制系统中
  • node_modules 该目录下文件为 node 相关依赖
  • plugins 该目录下的文件为 cordova 插件
  • scss 该目录下为 scss 文件,发布时编译这个目录下的文件输出到 www 的 css 目录中
  • www 项目的开发目录,页面、样式、脚本和图片等都放在该目录下
    • css
    • img
    • js
    • lib
    • index.html
  • bower.json bower配置文件
  • config.xml Ionic的配置文件,可以配置 app 的名称、描述信息等
  • gulpfile.js gulp 构建工具的执行文件
  • ionic.project Ionic 的项目文件,可以配置项目名称、app_id 等信息,新版本中该文件名称为 ionic.config.json
  • package.json npm 配置文件
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容