Expo 安卓 APK 打包踩坑笔记
今天想把 Expo 项目编译成安卓 APK 准备发布,结果在 assembleRelease 这一步卡了很久,记录一下排查过程,供遇到同类问题的朋友参考。
背景
- 项目路径:
D:\Files\ASProject\BgmDownloaderV5 - 目标:编译 release 版 APK
现象
先执行调试构建:
npx expo run:android这一步成功,说明项目本身和环境基本可用。
但接着进入 android 目录执行 release 构建:
cd android
./gradlew assembleRelease失败,报错如图。

排查过程
尝试一:怀疑 Win32 长路径问题
把报错发给 AI,得到的第一个猜测是 Windows 长路径(Long Paths) 问题。
于是做了两件事:
- 用 PowerShell 修改注册表开启长路径支持:
Set-ItemProperty `
-Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name LongPathsEnabled `
-Type DWord `
-Value 1- 在
gpedit.msc组策略里也启用了长路径支持,然后重启。
结果:仍然失败。

尝试二:怀疑依赖不兼容
继续追问 AI,这次猜测是 依赖不兼容。于是执行:
npx expo install --check
npx expo-doctor依赖更新完毕,expo-doctor 检查也全部通过,但重新编译……
结果:仍然失败。

尝试三:定位到 Ninja 本身路径拼接 Bug
再次追问 AI,这次它注意到报错里 Ninja 的路径拼接疑似有误。联网搜索后确认:新版 Ninja 已经修复了这个问题。
解决方式很直接:
- 到 Ninja 官方 Release 页面下载最新版:
https://github.com/ninja-build/ninja/releases - 用新版
ninja.exe替换掉 Android SDK 里的旧版:D:\ASSDK\cmake\xxx\bin\ninja.exe
替换后重新编译——成功!
