taro-安装及使用

https://nervjs.github.io/taro/docs/GETTING-STARTED.html

安装

Taro 项目基于 node,请确保已具备较新的 node 环境(>=8.0.0),推荐使用 node 版本管理工具 nvm 来管理 node,这样不仅可以很方便地切换 node 版本,而且全局安装时候也不用加 sudo 了。

cli 工具安装

首先,你需要使用 npm 或者 yarn 全局安装@tarojs/cli,或者直接使用npx:

# 使用 npm 安装 CLI
$ npm install -g @tarojs/cli
# OR 使用 yarn 安装 CLI
$ yarn global add @tarojs/cli # OR 安装了 cnpm,使用 cnpm 安装 CLI $ cnpm install -g @tarojs/cli
回到某个版本

需要安装某个固定版本,或者回到某个版本,例如我们要安装 1.3.9 , 则如下:

# 使用 npm 安装 CLI
$ npm install -g @tarojs/cli@1.3.9
# OR 使用 yarn 安装 CLI
$ yarn global add @tarojs/cli@1.3.9 # OR 安装了 cnpm,使用 cnpm 安装 CLI $ cnpm install -g @tarojs/cli@1.3.9
注意事项

值得一提的是,如果安装过程出现sass相关的安装错误,请在安装mirror-config-china后重试。

$ npm install -g mirror-config-china
使用

使用命令创建模板项目

$ taro init myApp

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

$ npx @tarojs/cli init myApp

taro 中可以使用 axios 吗 taro安装_shell

在创建完项目之后,Taro 会默认开始安装项目所需要的依赖,安装使用的工具按照 yarn>cnpm>npm 顺序进行检测,一般来说,依赖安装会比较顺利,但某些情况下可能会安装失败,这时候你可以在项目目录下自己使用安装命令进行安装

# 使用 yarn 安装依赖
$ yarn
# OR 使用 cnpm 安装依赖
$ cnpm install
# OR 使用 npm 安装依赖 $ npm install

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

微信小程序

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

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

# yarn
$ yarn dev:weapp
$ yarn build:weapp
# npm script
$ npm run dev:weapp $ npm run build:weapp # 仅限全局安装 $ taro build --type weapp --watch $ taro build --type weapp # npx 用户也可以使用 $ npx taro build --type weapp --watch $ npx taro build --type weapp
百度小程序

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

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

# yarn
$ yarn dev:swan
$ yarn build:swan
# npm script
$ npm run dev:swan $ npm run build:swan # 仅限全局安装 $ taro build --type swan --watch $ taro build --type swan # npx 用户也可以使用 $ npx taro build --type swan --watch $ npx taro build --type swan
支付宝小程序

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

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

# yarn
$ yarn dev:alipay
$ yarn build:alipay
# npm script
$ npm run dev:alipay $ npm run build:alipay # 仅限全局安装 $ taro build --type alipay --watch $ taro build --type alipay # npx 用户也可以使用 $ npx taro build --type alipay --watch $ npx taro build --type alipay
字节跳动小程序

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

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

# yarn
$ yarn dev:tt
$ yarn build:tt
# npm script
$ npm run dev:tt $ npm run build:tt # 仅限全局安装 $ taro build --type tt --watch $ taro build --type tt # npx 用户也可以使用 $ npx taro build --type tt --watch $ npx taro build --type tt
QQ 小程序

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

QQ 小程序编译预览及打包(去掉 --watch 将不会监听文件修改,并会对代码进行压缩打包)

# yarn
$ yarn dev:qq
$ yarn build:qq
# npm script
$ npm run dev:qq $ npm run build:qq # 仅限全局安装 $ taro build --type qq --watch $ taro build --type qq # npx 用户也可以使用 $ npx taro build --type qq --watch $ npx taro build --type qq
快应用

选择快应用模式,需要自行下载并打开快应用开发者工具,然后在项目编译完后,在开发者工具中选择「打开文件夹」选择项目根目录下 dist 目录,点击左边的预览图标(那个眼睛图标)进行预览。

快应用编译预览及打包(去掉 --watch 将不会监听文件修改,并会对代码进行压缩打包)

# yarn
$ yarn dev:quickapp
$ yarn build:quickapp
# npm script
$ npm run dev:quickapp $ npm run build:quickapp # 仅限全局安装 $ taro build --type quickapp --watch $ taro build --type quickapp # npx 用户也可以使用 $ npx taro build --type quickapp --watch $ npx taro build --type quickapp

快应用开发者工具如何使用?点击了解

快应用端开发流程

H5

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

H5 预览项目

# yarn
$ yarn dev:h5
# npm script
$ npm run dev:h5
# 仅限全局安装 $ taro build --type h5 --watch # npx 用户也可以使用 $ npx taro build --type h5 --watch

H5 打包项目

# yarn
$ yarn build:h5
# npm script
$ npm run build:h5
# 仅限全局安装 $ taro build --type h5 # npx 用户也可以使用 $ npx taro build --type h5
React Native

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

# yarn
$ yarn dev:rn
# npm script
$ npm run dev:rn
# 仅限全局安装 $ taro build --type rn --watch # npx 用户也可以使用 $ npx taro build --type rn --watch

Note:React Native 端和其他端样式兼容性差异较大,如果需要兼容 React Native 端,建议 React Native 端和其他端同步开发。

Note:如果要支持 React Native 端,必须采用 Flex 布局,并且样式选择器仅支持类选择器,且不 支持 组合器 Combinators and groups of selectors。

以下选择器的写法都是不支持的,在样式转换时会自动忽略。

.button.button_theme_islands{
  font-style: bold; } img + p { font-style: bold; } p ~ span { color: red; } div > span { background-color: DodgerBlue; } div span { background-color: DodgerBlue; }

样式上 H5 最为灵活,小程序次之,RN 最弱,统一多端样式即是对齐短板,也就是要以 RN 的约束来管理样式,同时兼顾小程序的限制,核心可以用三点来概括:

使用 Flex 布局

基于 BEM 写样式

采用 style 属性覆盖组件样式

RN 中 View 标签默认主轴方向是 column,如果不将其他端改成与 RN 一致,就需要在所有用到 display: flex 的地方都显式声明主轴方向。

更新

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

更新 Taro CLI 工具

# taro
$ taro update self
# npm
npm i -g @tarojs/cli@latest
# yarn
yarn global add @tarojs/cli@latest

更新项目中 Taro 相关的依赖

$ taro update project

环境及依赖检测

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

$ taro info
? Taro v1.2.0-beta.15


  Taro CLI 1.2.0-beta.15 environment info:
    System:
      OS: macOS High Sierra 10.13.5
      Shell: 5.3 - /bin/zsh
    Binaries:
      Node: 8.11.2 - /usr/local/bin/node
      Yarn: 1.8.0 - /usr/local/bin/yarn npm: 5.6.0 - /usr/local/bin/npm npmPackages: @tarojs/components: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/plugin-babel: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/plugin-csso: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/plugin-sass: ^1.2.0-beta.4 => 1.2.0-beta.4 @tarojs/plugin-uglifyjs: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/rn-runner: ^1.2.0-beta.4 => 1.2.0-beta.4 @tarojs/router: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/taro: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/taro-alipay: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/taro-h5: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/taro-swan: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/taro-weapp: ^1.2.0-beta.3 => 1.2.0-beta.3 @tarojs/webpack-runner: ^1.2.0-beta.3 => 1.2.0-beta.3 eslint-config-taro: ^1.2.0-beta.3 => 1.2.0-beta.3 eslint-plugin-taro: ^1.2.0-beta.3 => 1.2.0-beta.3

Taro Doctor

Taro Doctor 就像一个医生一样,可以诊断项目的依赖、设置、结构,以及代码的规范是否存在问题,并尝试给出解决方案。

但和真正的医生不一样,Taro Doctor 不需要排队挂号,也不用花钱。你只需要在终端运行命令:taro doctor,就像图里一样:

taro 中可以使用 axios 吗 taro安装_taro 中可以使用 axios 吗_02

CLI 配置

自 1.3.9 开始支持

1.3.9 开始 Taro 会在用户根目录下创建 .taro 文件夹,其中 .taro/index.json 用于存放 CLI 相关配置。

开发者可以使用 taro config 命令对配置项进行一系列操作:

# 查看用法
$ taro config --help
# 设置配置项<key>的值为<value>
$ taro config set <key> <value> # 读取配置项<key> $ taro config get <key> # 删除配置项<key> $ taro config delete <key> # 打印所有配置项 $ taro config list [--json]