如何通过EAS生成无需本地开发服务器的React Native APK

你的核心问题是当前构建的APK属于开发/调试版本，这类版本保留了热重载、远程调试等开发特性，因此必须连接本地开发服务器才能运行。要生成可独立运行的APK，需要调整eas.json的构建配置，构建生产/预览级别的离线包。

分析现有配置问题 #

• development配置：指定了assembleDebug，属于Debug调试版本，仅用于本地开发，必然依赖开发服务器。
• preview3配置：开启了developmentClient: true，这是开发客户端构建模式，同样需要连接服务器才能加载代码。
• preview配置：虽然指定了buildType: apk，但如果你之前构建时选错了profile（比如用了development或preview3），还是会生成依赖服务器的包。

具体修复步骤 #

1. 明确配置独立构建参数（可选但更清晰） #

可以修改preview配置，明确禁用开发客户端特性，确保生成离线包：

{
  "cli": {
    "version": ">= 3.3.2"
  },
  "build": {
    "development": {
      "distribution": "internal",
      "android": {
        "gradleCommand": ":app:assembleDebug"
      },
      "ios": {
        "buildConfiguration": "Debug"
      }
    },
    "preview": {
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      },
      "developmentClient": false // 明确禁用开发客户端，强制生成独立包
    },
    "preview3": {
      "developmentClient": true
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

也可以直接使用production配置，它默认就是独立构建的离线包，无需额外修改。

2. 执行正确的构建命令 #

运行以下命令之一，生成独立APK：

• 用preview profile构建（适合内部测试）：

npx eas-cli build --platform android --profile preview

• 用production profile构建（适合正式发布）：

npx eas-cli build --platform android --profile production

3. 验证结果 #

构建完成后下载的APK，安装到手机后无需启动本地开发服务器，即可直接运行。

内容的提问来源于stack exchange，提问作者mammothestate