搭建环境

更新时间:2024-06-05 03:14:28下载pdf

本文介绍进行面板开发前所必要的环境搭建工作。

安装开发工具

面板 SDK 开发前,请您按需自行下载安装下列推荐的编辑器:

  • Visual Studio Code:(推荐)自带格式化、代码跳转等常用功能,社区贡献与活跃度较高。
  • WebStorm:集成度较高的 IDE。
  • Sublime Text:小巧轻便。
  • Atom:小巧轻便。

安装 NVM

  • 首次安装时,需要根据提示设置环境变量。
  • 如果在安装过程中遇到任何问题,参考 NVM 官方文档
  1. 打开终端。

  2. 安装 NVM

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.36.0/install.sh | bash
    
  3. (可选)输入 nvm -v,确认 NVM 已正常安装。

    输出版本号,则表明安装成功。若报错 nvm: command not found,您可参考文末 常见问题 的解决方法。

  4. 输入 nvm install 14.21.3,安装 Node.js 14.21.3 版本。

    由于 RN 的版本为 0.59.10,建议安装 Node.js 14 系列或 Node.js 12 系列的版本。其中 Windows 建议安装 Node.js 12 系列,Mac 建议安装 Node.js 14 系列。

  5. (可选)支持通过 nvm use 命令切换至指定 Node.js 版本。

    nvm use 14.21.3
    

安装 Yarn

  1. 打开终端。

  2. 输入npm install -g yarn,安装 Yarn。

  3. (可选)输入 yarn -v,确认 Yarn 已正常安装。

安装 Homebrew 及 Watchman

本节步骤仅适用于 macOS 系统。

  1. 根据 Homebrew 官方文档的说明进行安装。
  2. 打开终端。
  3. 输入 brew install watchman,安装 Watchman。

安装 tuya-panel-cli

命令行工具(CLI)tuya-panel-cli 和涂鸦面板开发深度集成,请务必安装。安装命令如下:

  • MacOS & Linux

    curl -fsSL https://cdn.jsdelivr.net/gh/tuya/tuya-panel-cli/install.sh | sh
    

    首次安装时,需要根据提示设置环境变量。

  • Windows Powershell

    iwr https://cdn.jsdelivr.net/gh/tuya/tuya-panel-cli/install.ps1 -useb | iex
    

    iwr 命令在低版本 Powershell 下不可用,请参考 iwr 无法被识别(Windows) 解决。

安装完成后,运行 tuya-panel-cli help。如果展示所有可用命令的帮助信息,则安装成功。

如果因为网络问题无法获取安装脚本,请参考 windows 手动安装配置Mac/Linux 手动安装

常见问题

Q:输入 nvm -v 时,为什么报错 nvm: command not found

A:可能原因是 NVM 所在的路径未设置为环境变量,您可以参照下述步骤设置环境变量:

  1. 打开终端。

  2. 输入cd ~,进入当前用户的 Home 目录。

  3. 输入以下命令,打开配置文件。

    • Window 系统

      open .bash_profile
      
    • 新版 macOS 系统

      open .zshrc
      
  4. 在配置文件中,复制以下代码后,保存文件。

    export NVM_DIR="$HOME/.nvm"
     [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
    
  5. 输入 source .bash_profilesource .zshrc,重新加载配置文件。

  6. 输入 nvm -v,查看 NVM 版本,验证是否安装成功。

Q:macOS 系统无法安装 Homebrew,怎么办?

A:如果您的电脑中没有 Xcode 命令行工具,安装 Homebrew 可能会失败。

  • 解决方案 1:安装 Xcode。

  • 解决方案 2:使用命令在线安装。

    1. 打开 Mac 终端。
    2. 输入 cd ~ ,进入当前用户的 Home 目录。
    3. 输入 xcode-select --install,安装 Xcode 命令行工具安装包。

相关文档

安装或者运行 RN 的过程中,如果出现错误提示,可查看 RN 社区的常见错误文档。