快速开始

Node 版本要求

micrapp 要求 Node 版本不低于 v6.0，你可以使用 nvm 或者 n 管理多个版本的 Node。如果使用v8.0.0+版本出现安装失败情况，可尝试使用v7.x.x 版本。

安装

请切换至 QNPM 私有源, 推荐使用 nrm 管理多个版本的 npm registry

安装 micrapp：

sudo npm install @qnpm/micrapp --registry=http://npmrepo.corp.qunar.com/ -g

安装 q-hap-toolkit:

sudo npm install @qnpm/q-hap-toolkit --registry=http://npmrepo.corp.qunar.com/ -g

安装 beta 版本 (公测版, 新功能预览)

sudo npm install @qnpm/micrapp@beta --registry=http://npmrepo.corp.qunar.com/ -g

开发

下面以开发酒店项目模块为例。

1. clone 项目：

   git clone git@gitlab.corp.qunar.com:mini_program/mp_module_hotel.git
   

2. 进入项目目录，并切换到快应用开发分支：

   cd mp_module_hotel
   git checkout master_q
   

   小程序和快应用目前在同一个工程不同分支下进行开发。 工具最终目的是将小程序代码转换成快应用代码，一套代码多平台运行。 但是两边需求暂不一致，所以另起分支开发快应用。 不过开发方式还是写小程序代码，工具转换成快应用代码（除了模板要重写，样式需要调整）。 所以在新的分支上开发快应用，也只是在之前小程序代码上做修改。

3. 安装必要的依赖的项目模块 home_qunar、common：

   micrapp install home_qunar@#master_q
   micrapp install common@#master_q
   

4. 打包编译代码：

   micrapp build mix [--watch]
   

   micrapp build mix 打包完成产出rpk包，不产出二维码。 --watch 实时编辑打包，项目代码 src/ 下有内容改变自动打包, 并产出调试二维码。

5. 预览:
   手机端预览需要两个前提条件:
   首先，保证手机和电脑处于同一局域网;
   其次，安装Android应用程序手机调试器，下载地址.

   安装成功后如下图所示:
   

   点击扫码安装或者本地安装均可预览。详情可参考快应用官方文档-环境搭建.

   务必，先按照官方文档将官方 demo 项目跑起来。熟悉扫码安装、debug 等流程。