Native EAS 部署

本文由人工撰写（md），AI 优化（mdx）。

本指南基于已完成的 HeroUI Native Pro 安装，请先完成基础安装和配置。

配置 preinstall 脚本

切换到 apps/native/，在 package.json 中新增一个 preinstall 脚本：

添加 preinstall 脚本

apps/native/package.json

{
  "scripts": {
    "preinstall": "npx -y hpsetup@latest <your_hp_key>"
  }
}

这一步会确保在依赖安装前运行 hpsetup，提前完成所有依赖的完整安装，然后移除 pro 包的 postinstall（让后续的 install 正常通过，不报依赖构建错误）。

如果需要体验最新的内测实现，可以把 latest 换成 beta。

配置 EAS

新增 eas.json 文件：

apps/native/eas.json

{
  "cli": {
    "version": ">= 18.13.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {
      "autoIncrement": true
    }
  },
  "submit": {
    "production": {}
  }
}

新增 .nvmrc，指定 Node 版本为 22（pnpm 11 需要此版本，否则会报错）：

apps/native/.nvmrc

执行构建

npx -y --package eas-cli eas build -p android -e preview

临时装一个 eas-cli 包，然后执行其中的 eas 命令，使用 preview profile 运行 Android 端的构建。

成功构建：

安装 APK 后运行：

Tips

ERR_PNPM_IGNORED_BUILDS

如果遇到 ERR_PNPM_IGNORED_BUILDS 问题，需要把相应的依赖加入 trust 列表（允许依赖的构建脚本执行）：

仅示例，此依赖已纳入 hpsetup trust 列表。

Expo 官方插件

需要辅助 Expo 开发的话，可以安装官方的插件：