快速开始

前置要求

  • 下载并安装微信开发者工具
  • 本地 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.git 或git clone https://github.com/RubyLouvre/anu.git
  • 命令行定位到packages/cli目录下，执行npm link 如果之前装过要先npm unlink
  • 然后定位到外面的目录，不要在cli目录中建工程。 使用 cd ../../ && nanachi init demo 创建工程
  • 定位到 demo 目录下安装依赖npm i或yarn
  • 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