跳到主要内容

简介

本文档介绍了从源代码构建应用的前提条件，包括自定义源代码和构建应用所需的开发环境设置。

⚡ 快速入门​

如果你是移动应用开发者，可能已经配置好了安卓或 iOS 的开发环境。请确保开发环境已按照以下项目需求正确配置。

首次设置移动应用开发环境？ 请参阅 环境设置 小节。

在开始之前，请确保已安装以下软件：

  • Node.js：版本 22
  • npm（Node 包管理器）
  • NVM（Node 版本管理器）- 推荐用于管理 Node.js 版本
  • 正确配置的 React Native 开发环境
  • Android Studio（用于安卓开发）
  • Xcode（用于 macOS 上的 iOS 开发）

⚠️ 重要提示：本项目使用开发构建，不依赖 EAS Build。

Node.js 安装​

安装 Node.js 有两种方式：

方式一：使用 NVM（推荐）

NVM 可以轻松管理多个 Node.js 版本。请参阅以下安装指南：

安装 NVM 后，安装 Node.js 22：

nvm install 22
nvm use 22
node --version  # 应显示 v22.x.x

方式二：直接安装

从官方网站直接安装 Node.js：

  • 📥 Node.js 官方网站
  • 下载 Node.js 22 LTS
  • 验证安装：node --version（应显示 v22.x.x）

环境设置​

安卓设置​

使用 Android Studio 配置构建和运行安卓应用的环境：

👉 Expo Android 环境设置

关键要求：

  • 安装带有安卓 SDK 的 Android Studio
  • 设置安卓 SDK Build-Tools 和 Platform-Tools
  • 配置安卓虚拟设备 (AVD) 或连接物理设备
  • 在安卓设备上启用 USB 调试

⚠️ 重要提示： 在 Android Studio 中同步 Gradle 之前，请确保使用的 JDK 是 Zulu JDK 17。
要验证或更新此设置，请前往：
Tools > SDK Manager > Build, Execution, Deployment > Gradle 并查看 JDK 路径。

如果遇到构建问题，尝试删除用户目录和项目安卓目录中的 ./gradle 文件夹。

iOS 设置​

设置从 Xcode 构建和运行应用的环境（仅限 macOS）：

👉 Expo iOS 环境设置

关键要求：

  • 从 Mac 应用商店安装 Xcode
  • 安装 Xcode 命令行工具：xcode-select --install
  • 安装 CocoaPods：sudo gem install cocoapods
  • 配置 iOS 模拟器或连接物理 iOS 设备

安装​

  1. 使用正确的 Node 版本并克隆仓库

    # Use Node.js 22
    nvm use 22

    # Clone the repository
    git clone https://github.com/espressif/esp-rainmaker-home.git
    cd esp-rainmaker-home

  2. 安装依赖

    npm install

运行应用​

安卓​

在已连接的安卓设备或模拟器上运行应用：

npm run android

iOS​

在已连接的 iOS 设备或模拟器上运行应用：

npm run ios

开发服务器​

启动开发服务器：

npm start

生产构建​

安卓发布构建​

npx react-native run-android --mode release

此命令用于正确打包 JavaScript 代码并构建完整的发布 APK。APK 文件位于 android/app/build/outputs/apk/release/app-release.apk 中。

注意： 直接使用 ./gradlew assembleRelease 可能会导致白屏，因为它并不打包应用运行所需的 JavaScript 代码。

iOS 发布构建​

  1. 安装 iOS 依赖：

    cd ios
    pod install

  2. 在 Xcode 中打开工作区：

    open NOVA.xcworkspace

  3. 在 Xcode 中：

    • 选择 NOVA Release 方案
    • 选择目标设备或 Any iOS Device
    • 构建并归档应用 (Product > Archive)

支持版本​

  • iOS：版本 15.1 及以上
  • Xcode：版本 16.3 及以上
  • Android Studio：Narwhal | 2025.1.1 Patch 1
  • Android：版本 9 及以上

SDK 文档​

许可证​

本项目采用 Apache 2.0 许可证，详情请参阅 LICENSE 文件。

⚠️ 重要声明：本仓库中提供的 AWS 公共部署详情仅用于开发和教育目的，不应用于商业用途。

On this page