Expo EAS 云端打包 APK 极简速通教程

Expo EAS 云端打包 APK 极简速通教程

前置要求

在 VS Code 中，必须使用 PowerShell 终端（切勿使用 Git Bash，以免交互卡死）。

第一步：打通网络（极其重要）

为了防止国内网络连接 Expo 美国云服务器时出现 TLS connection failed 的报错，每次新建终端准备打包前，先运行代理指令（假如端口是 10710）：

$env:HTTP_PROXY="http://127.0.0.1:10710"
$env:HTTPS_PROXY="http://127.0.0.1:10710"

第二步：安装打包工具与登录

如果是第一次在新电脑上弄，需要安装 EAS CLI 并登录 Expo 账号（如果是同一台电脑且没退过账号，可跳过此步）：

npm install -g eas-cli
eas login

第三步：初始化项目（仅限新项目首次打包）

让代码在云端"上个户口"：

eas build:configure

• 遇到询问是否自动创建项目（Would you like to automatically create…），直接按回车或输入 Y。
• 平台选项（Which platforms…）选择 All。

第四步：修改配置，强制输出 APK

这一步是能否在手机上直接安装的关键。默认打包是给应用商店用的 .aab 格式。

打开左侧生成的 eas.on 文件，找到 "preview" 模块，改成下面这样（重点是加入 android 和 buildType）：

"preview": {
  "distribution": "internal",
  "android": {
    "buildType": "apk"
  }
}

第五步：执行打包指令

保存所有修改（确保没有未提交的 Git 更改，如果有，先执行 git add . 和 git commit -m "build"），然后输入终极指令：

eas build -p android --profile preview

• 遇到警告？ 如果看到 DeprecationWarning: The punycode module is deprecated...，无视它，那是系统底层唠叨，不影响打包。
• 遇到提问？ 如果问是否生成 Android Keystore（安卓签名密钥），直接按 Y 然后回车，让 Expo 自动管理。

第六步：喝茶等待与扫码下载

接下来终端会出现 Uploading 进度条和一行网页链接。

大约等待 10~15 分钟排队编译。跑完后，终端会弹出一个巨大的二维码和一段下载链接。直接用安卓手机扫码下载 .apk 安装包，允许"未知来源"安装即可！