快速开始

前置要求

  • 下载并安装微信开发者工具
  • 本地 Node.js 版本 8.6.0 以上
  • 开发过程中,对文件夹及文件的命名都有一定要求,见发布打包一节
    各种小程序开发工具

安装

npm

  1. npm install nanachi-cli -g

yarn

  1. yarn global add nanachi-cli
  • nanachi init <project-name> 创建工程
  • cd <project-name> && npm i 安装依赖
  • nanachi watch:[wx|bu|ali|quick] 监听构建小程序
  • 用对应的小程序开发工具打开当中的dist目录,自己在source目录中进行开发

nanachi watch:wx默认是从npm拉对应的ReactWx, ReactAli…的稳定版,一星期发布一次。如果出BUG,急紧修复,着急要最新版本,可以使用nanachi watch:wx —beta命令。

注意:快应用下构建结束后,需要执行以下三步骤

  1. npm install # 需要开另一个窗口, 安装快应用的hap编译器, 只需安装一次
  2. npm run build # 与上面同一窗口, 生成dist目录
  3. npm run server # 需要第三个窗口, 运行node环境,这时会出一个二维码与一个链接,保证PC的WIFI与手机的WIFI是同一个,然后用手机上的快应用调试器 扫描,就能看到效果。也可以将链接贴到chrome中,这时二维码会出现页面上,也是手机扫描,可以同时在手机与网页上看到效果,此这种方式用于调式。

更多便捷的命令

  1. nanachi page aaa # 在pages目录下创建aaa/index.js模板
  2. nanachi component Dog # 在components目录下创建Dog/index.js模板
  3. nanachi build:[wx|ali|bu|quick|tt] --beta #同步最新的 React lib
  4. nanachi build:[wx|ali|bu|quick|tt] --beta-ui #同步最新的补丁组件
  5. nanachi -V #查看当前版本

第二种安装

此方式下适用于去哪儿网内部用户,在参与开发nanachi框架的技术人员

  • git clone git@github.com:RubyLouvre/anu.gitgit clone https://github.com/RubyLouvre/anu.git
  • 命令行定位到packages/cli目录下,执行npm link 如果之前装过要先npm unlink
  • 然后定位到外面的目录,不要在cli目录中建工程。 使用 cd ../../ && nanachi init demo 创建工程
  • 定位到 demo 目录下安装依赖npm iyarn
  • nanachi build 全量编译代码,build后面可跟参数, 如nanachi build:ali
  • nanachi watch 增量编译代码并监听文件变化,watch后面可跟参数
  • 用微信开发工具打开当中的dist目录,自己在source目录中进行开发
  1. cd anu/packages/cli && npm link
  2. cd ../../ && nanachi init demo
  3. cd demo && yarn
  4. nanachi watch //或 nanachi watch:wx 或 nanachi watch:bu 或 nanachi watch:ali 或 或 nanachi watch:tt

imageimageimageimageimageimage

有远程请求的页面,需要打开右上角 “>>” 详情, 不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书 打上勾

image

快应用的安装流程

执行以下命令:

  1. npm install -g hap-toolkit //安装快应用的hap编译器, 只需安装一次
  2. nanachi init xxx // 初始化工程
  3. cd xxx && npm i // npm i可以改成yarn, 安装nanachi的依赖
  4. nanachi watch:quick // 编译代码
  5. npm i // 这是安装快应用的编译器hap的依赖,
  6. npm run build // 这是hap 的构建命令
  7. npm run server -- --watch //或hap server --watch 这是hap 的打开远程服务,生成二维码让你用手机扫码查看编译后的app

。快应用还没有像微信, 支付宝, 百度那样提供好用的开发者工具,想查看结果需要手机装 快应用调试器。快应用只能用于安卓。

快应用调试器

快应用预览版

快应用的目标代码分别在src(ux文件)与dist(二进制)在编译二进制过程,可能有许多警告,因为快应用的标签不支持 data-*属性及许多HTML样式,但这不会影响结果。imageimageimage