安装

安装 Taro 开发工具 @tarojs/cli

使用 npm 或者 yarn 全局安装，或者直接使用@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b">npx

  1. $ npm install -g @tarojs/cli
  2. $ yarn global add @tarojs/cli

使用

使用命令创建模板项目

  1. $ taro init myApp

npm 5.2+ 也可在不全局安装的情况下使用 npx 创建模板项目

  1. $ npx @tarojs/cli init myApp

进入项目目录开始开发，目前已经支持 微信/百度/支付宝/字节跳动小程序、H5 以及 ReactNative 等端的代码转换，针对不同端的启动以及预览、打包方式并不一致

微信小程序

选择微信小程序模式，需要自行下载并打开微信开发者工具，然后选择项目根目录进行预览。

微信小程序编译预览及打包（去掉 —watch 将不会监听文件修改，并会对代码进行压缩打包）

  1. # npm script
  2. $ npm run dev:weapp
  3. $ npm run build:weapp
  4. # 仅限全局安装
  5. $ taro build --type weapp --watch
  6. $ taro build --type weapp
  7. # npx 用户也可以使用
  8. $ npx taro build --type weapp --watch
  9. $ npx taro build --type weapp

百度小程序

选择百度小程序模式，需要自行下载并打开百度开发者工具，然后在项目编译完后选择项目根目录下 dist 目录进行预览。

百度小程序编译预览及打包（去掉 —watch 将不会监听文件修改，并会对代码进行压缩打包）

  1. # npm script
  2. $ npm run dev:swan
  3. $ npm run build:swan
  4. # 仅限全局安装
  5. $ taro build --type swan --watch
  6. $ taro build --type swan
  7. # npx 用户也可以使用
  8. $ npx taro build --type swan --watch
  9. $ npx taro build --type swan

支付宝小程序

选择支付宝小程序模式，需要自行下载并打开支付宝小程序开发者工具，然后在项目编译完后选择项目根目录下 dist 目录进行预览。

支付宝小程序编译预览及打包（去掉 —watch 将不会监听文件修改，并会对代码进行压缩打包）

  1. # npm script
  2. $ npm run dev:alipay
  3. $ npm run build:alipay
  4. # 仅限全局安装
  5. $ taro build --type alipay --watch
  6. $ taro build --type alipay
  7. # npx 用户也可以使用
  8. $ npx taro build --type alipay --watch
  9. $ npx taro build --type alipay

字节跳动小程序

选择字节跳动小程序模式，需要自行下载并打开字节跳动小程序开发者工具，然后在项目编译完后选择项目根目录下 dist 目录进行预览。

字节跳动小程序编译预览及打包（去掉 —watch 将不会监听文件修改，并会对代码进行压缩打包）

  1. # npm script
  2. $ npm run dev:tt
  3. $ npm run build:tt
  4. # 仅限全局安装
  5. $ taro build --type tt --watch
  6. $ taro build --type tt
  7. # npx 用户也可以使用
  8. $ npx taro build --type tt --watch
  9. $ npx taro build --type tt

H5

H5 模式，无需特定的开发者工具，在执行完下述命令之后即可通过浏览器进行预览

H5 预览项目

  1. # npm script
  2. $ npm run dev:h5
  3. # 仅限全局安装
  4. $ taro build --type h5 --watch
  5. # npx 用户也可以使用
  6. $ npx taro build --type h5 --watch

H5 打包项目

  1. # npm script
  2. $ npm run build:h5
  3. # 仅限全局安装
  4. $ taro build --type h5
  5. # npx 用户也可以使用
  6. $ npx taro build --type h5

React Native

React Native 端运行需执行如下命令，React Native 端相关的运行说明请参见 React Native 教程

  1. # npm script
  2. $ npm run dev:rn
  3. # 仅限全局安装
  4. $ taro build --type rn --watch
  5. # npx 用户也可以使用
  6. $ npx taro build --type rn --watch

更新

Taro 提供了更新命令来更新 CLI 工具自身和项目中 Taro 相关的依赖

更新 Taro CLI 工具

  1. # taro
  2. $ taro update self
  3. # npm
  4. npm i -g @tarojs/cli@latest
  5. # yarn
  6. yarn global add @tarojs/cli@latest

更新项目中 Taro 相关的依赖

  1. $ taro update project

环境及依赖检测

Taro 提供了命令来一键检测 Taro 环境及依赖的版本等信息，方便大家查看项目的环境及依赖，排查环境问题。在提 issue 的时候，请附上 taro info 打印的信息，帮助开发人员快速定位问题。

  1. $ taro info
  2. ? Taro v1.2.0-beta.15
  5.   Taro CLI 1.2.0-beta.15 environment info:
  6.     System:
  7.       OS: macOS High Sierra 10.13.5
  8.       Shell: 5.3 - /bin/zsh
  9.     Binaries:
  10.       Node: 8.11.2 - /usr/local/bin/node
  11.       Yarn: 1.8.0 - /usr/local/bin/yarn
  12.       npm: 5.6.0 - /usr/local/bin/npm
  13.     npmPackages:
  14.       @tarojs/components: ^1.2.0-beta.3 => 1.2.0-beta.3
  15.       @tarojs/plugin-babel: ^1.2.0-beta.3 => 1.2.0-beta.3
  16.       @tarojs/plugin-csso: ^1.2.0-beta.3 => 1.2.0-beta.3
  17.       @tarojs/plugin-sass: ^1.2.0-beta.4 => 1.2.0-beta.4
  18.       @tarojs/plugin-uglifyjs: ^1.2.0-beta.3 => 1.2.0-beta.3
  19.       @tarojs/rn-runner: ^1.2.0-beta.4 => 1.2.0-beta.4
  20.       @tarojs/router: ^1.2.0-beta.3 => 1.2.0-beta.3
  21.       @tarojs/taro: ^1.2.0-beta.3 => 1.2.0-beta.3
  22.       @tarojs/taro-alipay: ^1.2.0-beta.3 => 1.2.0-beta.3
  23.       @tarojs/taro-h5: ^1.2.0-beta.3 => 1.2.0-beta.3
  24.       @tarojs/taro-swan: ^1.2.0-beta.3 => 1.2.0-beta.3
  25.       @tarojs/taro-weapp: ^1.2.0-beta.3 => 1.2.0-beta.3
  26.       @tarojs/webpack-runner: ^1.2.0-beta.3 => 1.2.0-beta.3
  27.       eslint-config-taro: ^1.2.0-beta.3 => 1.2.0-beta.3
  28.       eslint-plugin-taro: ^1.2.0-beta.3 => 1.2.0-beta.3