一、安装

1-1 CLI工具安装

  1. # 使用 npm 安装 CLI
  2. npm install -g @tarojs/cli
  4. # OR 使用 yarn 安装 CLI
  5. yarn global add @tarojs/cli
  7. # OR 安装了 cnpm，使用 cnpm 安装 CLI
  8. cnpm install -g @tarojs/cli

1-2 注意事项

如果安装过程出现sass相关的安装错误，请在安装mirror-config-china后重试。

  1.  npm install -g mirror-config-china

二、项目初始化

使用命令创建模板项目

  1. taro init myApp

Tip：如果安装失败，可以在项目目录下自己使用安装命令进行安装

  1. # 使用 yarn 安装依赖
  2. $ yarn
  4. # OR 使用 cnpm 安装依赖
  5. $ cnpm install
  7. # OR 使用 npm 安装依赖
  8. $ npm install

三、运行

Tip：保持 @tarojs/cli 的版本与各端依赖版本一致
查询依赖版本

3-1 微信小程序

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

3-2 React-native

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

Tip：如果要支持 React Native 端，必须采用 Flex 布局，并且样式选择器仅支持类选择器，且不 支持 组合器

四、常用CLI命令

4-1 帮助

  1. $ taro --help

4-2 更新

更新 Taro CLI 工具

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

更新项目中 Taro 相关的依赖

  1. $ taro update project [version]

Tip：version 为选填，如：1.x.x/latest 等，将会直接更新到指定版本。 若不填写 version，将会更新到当前项目 Taro 依赖的 主版本（major）的最新稳定版，如当前主版本没有稳定版本，则会更新到 latest 指定的版本。

4-3 Taro Doctor