Expo EAS 로컬 빌드 트러블슈팅 — 외장 SSD, rsync, Gradle, Podfile.lock이 스토어 빌드를 막은 기록
목차
1. 빌드 서버가 제 맥이 되면 생기는 일
데일리베이비는 2026년 3월 이후로 EAS 클라우드 빌드를 쓰지 않습니다. 스토어에 올리는 IPA와 AAB는 제 맥에서 eas build --local로 만들고, iOS는 eas submit --path나 Transporter로, Android는 Play Console에 직접 올립니다.
eas build --local --platform ios --profile <프로필> --output ./build-<버전>-ios.ipa
eas build --local --platform android --profile <프로필> --output ./build-<버전>-android.aab명령은 클라우드 빌드와 거의 같지만, 로컬 빌드는 제 맥의 디스크와 Homebrew로 설치한 도구, JDK, 메모리 설정을 그대로 물려받습니다. 프로젝트는 Expo SDK 54와 React Native 0.81.5 기반이고, android와 ios 네이티브 폴더를 저장소에서 직접 관리합니다. 빌드 번호는 eas.json의 appVersionSource: "remote"와 autoIncrement 설정으로 EAS 서버에서 하나씩 올려 받습니다.
이 구성의 약점이 한꺼번에 드러난 날이 2026년 10월 8일, 2.10.0 빌드 날입니다. 최종 제출본은 iOS 69, Android 65였고, iOS 66, 67, 68번과 Android 63, 64번은 실패한 시도들이 써 버렸습니다. 원격 버전 관리에서는 실패한 빌드의 번호도 돌아오지 않습니다. 원인은 모두 앱 코드가 아니라 빌드 환경이었고, 그날 오후 커밋 기록에 그대로 남아 있습니다.
2026-10-08 16:28 ver: 2.10.0
2026-10-08 16:58 chore: .easignore에 네이티브 빌드 산출물 제외 — 로컬 빌드 복사량 약 6.4GB→13MB
2026-10-08 17:04 fix: Podfile.lock을 설치 버전(react-native-google-mobile-ads 16.3.4)과 일치 — pod install 충돌 해소
2026-10-08 17:18 chore: Gradle 데몬 메모리 상향 (Xmx 4GB, Metaspace 1GB) — 클린 릴리스 빌드 OOM 해소버전을 올린 뒤 50분 사이에 빌드 환경을 고친 커밋이 세 개 들어갔고, 커밋으로 남지 않은 맥 쪽 문제가 하나 더 있었습니다. 3주 뒤 2.14.0에서는 빌드가 원본 파일을 고쳐 놓는 문제가 더해졌습니다.
2. 외장 SSD에서 빌드마다 6.4GB를 복사하고 있었습니다
저는 저장소를 USB 외장 SSD에 두고 작업합니다. 2.10.0 때 두 플랫폼을 동시에 빌드하다가 SSD 마운트가 풀리면서 입출력 오류(EIO)로 실패했습니다. 그때 두 빌드는 각각 SSD에서 6GB가 넘는 파일을 복사하고 있었습니다.
eas build --local은 빌드에 쓸 파일을 따로 복사해 두고 그 사본으로 빌드합니다. 무엇을 뺄지는 보통 .gitignore가 정하지만, 프로젝트 루트에 .easignore가 있으면 EAS는 android/.gitignore, ios/.gitignore 같은 하위 폴더의 것까지 모든 .gitignore를 무시합니다. 저는 git에는 올리지 않지만 빌드에는 들어가야 하는 네이티브 설정 파일 때문에 .easignore를 쓰고 있었습니다. 그 바람에 Gradle 빌드 출력, .cxx, ios/Pods 같은 네이티브 캐시 약 5.7GB를 포함해 빌드 한 번에 약 6.4GB가 복사되고 있었습니다.
해결은 빌드 중에 pod install과 Gradle이 어차피 다시 만드는 경로를 .easignore에 직접 적는 것이었습니다. 필수 설정 파일과 Podfile.lock, Xcode·Gradle 프로젝트 파일이 그대로 들어가는지도 확인했습니다.
# Native build outputs (pod install / Gradle regenerate them during the build).
# With .easignore present EAS skips every .gitignore, including android/.gitignore
# and ios/.gitignore, so without these each build copied about 5.7GB of caches.
/android/.gradle
/android/build
/android/app/build
/android/app/.cxx
/ios/build
/ios/Pods복사량은 약 6.4GB에서 13MB로 줄었습니다. 지금은 두 플랫폼을 하나씩 차례로 빌드합니다. 11월 1일 2.14.1 때는 한 번에 10분 안팎이 걸렸습니다.
3. 처음부터 빌드할 때만 터지는 두 문제: Podfile.lock과 Metaspace
같은 날 만난 문제 중 두 가지는 의존성을 새로 설치하고 처음부터 컴파일할 때 드러나는 종류였습니다. 먼저 iOS 빌드가 pod install 단계에서 멈췄습니다.
could not find compatible versions for pod Google-Mobile-Ads-SDK원인은 8월 1일 Expo SDK를 53에서 54로 올린 커밋(v2.9.0)에 있었습니다. 그때 Podfile.lock에만 react-native-google-mobile-ads 16.4.0과 Google Mobile Ads SDK 13.5.0이 기록됐고, package.json(~16.3.0)과 package-lock은 16.3.4로 남았습니다. 실제로 설치되는 16.3.4는 SDK 13.1.0을 정확히 지정하므로, Pods를 새로 설치하면 버전을 맞출 방법이 없습니다. EAS 빌드든 아니든 새로 pod install을 하면 실패하는 문제였습니다.
pod update Google-Mobile-Ads-SDK로 lock을 SDK 13.1.0에 맞췄고, 나머지 Pod 106개는 이미 lock과 같았습니다. lock을 바꿔야 하는 상황이면 실패하는 pod install --deployment로 한 번 더 확인했습니다. 라이브러리를 16.4.0으로 올려 13.5.0을 지키는 방법도 있지만, 그러면 Android 광고 SDK까지 25.0.0에서 25.4.0으로 함께 올라갑니다. 이번에는 lock만 고쳐 Android와 JS 의존성은 그대로 두었습니다.
cd ios
pod update Google-Mobile-Ads-SDK
pod install --deployment@@ -189 +189 @@ PODS:
- - Google-Mobile-Ads-SDK (13.5.0):
+ - Google-Mobile-Ads-SDK (13.1.0):
@@ -2187,2 +2187,2 @@ PODS:
- - RNGoogleMobileAds (16.4.0):
- - Google-Mobile-Ads-SDK (= 13.5.0)
+ - RNGoogleMobileAds (16.3.4):
+ - Google-Mobile-Ads-SDK (= 13.1.0)Android는 컴파일 도중 JVM 메모리가 바닥났습니다.
OutOfMemoryError: Metaspace캐시 없이 처음부터 빌드하는 로컬 EAS 빌드에서 :expo:compileReleaseKotlin과 D8 단계가 Gradle 데몬의 Metaspace 상한 512MB를 넘겼습니다(JDK 20). Metaspace는 힙과 따로 잡히는 클래스 메타데이터 영역이라 -Xmx만 올려서는 해결되지 않습니다. android/gradle.properties에서 두 값을 모두 두 배로 올렸습니다.
-org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m
+org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=1024m4. 아카이브는 되는데 IPA가 안 나올 때: Homebrew rsync
iOS에는 커밋으로 남지 않은 문제가 하나 더 있었습니다. Xcode 아카이브는 성공하는데 IPA를 내보내는 마지막 단계에서 실패했습니다. Xcode Organizer에 남아 있던 2.10.0 (68) 아카이브가 그 흔적입니다.
exportArchive Copy failed원인은 Homebrew로 설치해 둔 rsync 3.4.4였습니다. Xcode가 쓰는 시스템 rsync(openrsync)는 복사할 때 상대편 역할을 할 rsync를 하나 더 실행하는데, 그 자리에 Homebrew의 rsync가 실행되면서 옵션이 맞지 않아 복사가 실패합니다. 해결은 빌드하는 동안만 링크를 끊는 것이고, Homebrew rsync가 필요 없다면 brew uninstall rsync로 지워도 됩니다.
brew unlink rsync
eas build --local --platform ios --profile <프로필> --output ./build-<버전>-ios.ipa
brew link rsync다만 손으로 끊었다가 다시 거는 단계는 빌드가 중간에 실패하면 잊기 쉽습니다. 그래서 나중에 만든 빌드 스크립트는 빌드가 실패해도 링크를 다시 걸게 했습니다.
5. 빌드가 원본 파일을 고쳐 놓는 문제: AndroidManifest (2.14.0)
10월 30일 2.14.0 때는 결이 다른 문제를 만났습니다. 빌드는 성공하는데 작업 트리가 바뀌어 있었습니다. eas build --local --platform android가 시작할 때 원본 android/app/src/main/AndroidManifest.xml을 다시 써 버리는 것이었습니다. 빠른 설정 타일 서비스의 <intent-filter>가 한 줄에서 여러 줄로 풀리고, 서비스 선언 한 줄이 자리를 옮기고, 주석 하나가 사라졌습니다. 요소와 속성은 그대로이고 줄 모양만 바뀐 겁니다. 원래는 이렇게 한 줄이었습니다.
<intent-filter><action android:name="android.service.quicksettings.action.QS_TILE"/></intent-filter>앱 동작에는 문제가 없지만 테스트가 걸렸습니다. 잠금 화면 위젯과 빠른 설정 타일 같은 네이티브 작업을 하면서, 기준 커밋 이후 네이티브 파일 변경이 허용 목록 안에 있는지 줄 단위로 검사하는 테스트를 두었기 때문입니다. 메시지의 stage-5는 그 작업 단계의 이름입니다.
android/app/src/main/AndroidManifest.xml: added line beyond the stage-5 list (only the outside receivers/service and the quick settings tiles): …그래서 Android 빌드가 끝나면 git diff를 보고, 매니페스트의 줄 모양만 바뀌었으면 되돌립니다. 내용이 같은 변경이고 테스트도 실패하므로 커밋하지 않습니다.
git diff -- android/app/src/main/AndroidManifest.xml
git checkout -- android/app/src/main/AndroidManifest.xml솔직히 말하면 빌드가 왜 원본 파일을 다시 쓰는지는 아직 확인하지 못했습니다. 지금은 증상을 확실히 되돌리는 쪽을 택했고, 빌드 전에 제가 매니페스트를 고쳐 둔 상태라면 의도한 변경까지 지우지 않도록 되돌리지 않습니다.
6. 함정에 맞춰 정한 빌드 절차
여기까지를 정리하면 이렇습니다. 마지막 줄은 아래에서 설명합니다.
| 함정 | 증상 | 대처 |
|---|---|---|
.easignore가 하위 .gitignore까지 무시 | 약 6.4GB 복사, 동시 빌드 중 마운트 해제(EIO) | 네이티브 산출물 제외, 한 플랫폼씩 빌드 |
Podfile.lock 불일치 | pod install 실패 | lock을 16.3.4와 SDK 13.1.0에 맞춤 |
| Gradle Metaspace 512MB | OutOfMemoryError: Metaspace | Metaspace 1024MB, 힙 4GB |
| Homebrew rsync 3.4.4 | exportArchive Copy failed | 빌드 동안 brew unlink rsync |
| 빌드가 매니페스트 재포맷 | 네이티브 변경 검사 테스트 실패 | 빌드 뒤 되돌리고 커밋하지 않음 |
| 위젯 Info.plist 자동 생성 | 확장 CFBundleVersion 불일치 경고 | 버전 키를 직접 적고 동기화 |
10월 30일, 이 대처들을 scripts/release-local.sh 하나로 묶었습니다. 그전 npm 스크립트는 버전 동기화 뒤 eas build를 부르는 한 줄이라, rsync와 매니페스트를 되돌리는 일은 제 기억에 맡겨져 있었습니다. 지금은 npm run release:ios-local, release:android-local, submit:ios만 씁니다. 핵심 부분만 옮기고 주석은 한국어로 새로 달았습니다.
set -euo pipefail
finish() {
local status=$?
# 이전 산출물은 새 빌드가 성공했을 때만 지우고, 실패하면 제자리로 돌린다
if [ -n "$parked" ]; then
if [ "$status" = 0 ] && [ -f "$out" ]; then rm -f "$parked"; else mv -f "$parked" "$out"; fi
fi
# 성공하든 실패하든 rsync 링크와 매니페스트는 원래대로
if [ "$relink" = 1 ]; then brew link rsync >/dev/null || true; fi
if [ "$restore_manifest" = 1 ]; then git checkout -- "$manifest" || true; fi
exit "$status"
}
trap finish EXIT
case "$cmd" in
ios)
out="./build-${VERSION}-ios.ipa"
node scripts/sync-version.js ios
park_previous
if [ -L "$(brew --prefix 2>/dev/null)/bin/rsync" ]; then brew unlink rsync >/dev/null && relink=1; fi
caffeinate -i eas build --platform ios --profile production --local --output "$out" "$@"
;;
android)
out="./build-${VERSION}-android.aab"
node scripts/sync-version.js android
park_previous
# 빌드 전에 손대지 않은 상태였을 때만 빌드 뒤에 되돌린다
if git diff --quiet -- "$manifest"; then restore_manifest=1; fi
caffeinate -i eas build --platform android --profile production --local --output "$out" "$@"
;;
esac첫 단계는 버전 동기화입니다. eas.json에도 이 스크립트를 prebuildCommand로 걸어 두었고 스크립트 첫 주석에는 "This script is run by EAS Build before the native build starts"라고까지 적혀 있었지만, 네이티브 폴더를 직접 관리하는 프로젝트에서는 PREBUILD 단계가 건너뛰어져 실행되지 않습니다.
2.14.0 때는 아카이브 단계에서 CFBundleVersion of an app extension (1) must match … (72) 경고도 나왔습니다. 위젯 확장 타깃이 GENERATE_INFOPLIST_FILE = YES여서 빌드 설정의 버전 1.0, 빌드 1이 EAS가 적은 빌드 번호를 덮고 있었습니다. IPA 안의 번호는 내보내기 때 Xcode가 맞춰 줬지만, 위젯의 Info.plist 생성을 끄고 버전 키를 직접 적어 동기화 스크립트가 함께 맞추게 했습니다.
빌드 뒤에는 산출물을 열어 앱, 위젯 확장, 매니페스트의 버전과 빌드 번호를 확인합니다. iOS는 로컬 IPA를 --path로 제출합니다. 이 옵션이 없으면 eas submit이 클라우드 빌드 목록에서 고르라고 묻습니다. 비대화형 제출을 위해 10월 15일에는 eas.json에 ascAppId도 넣었습니다. Android는 Play Console에 직접 올리고, 업로드한 사본과 SHA-256을 맞춰 봅니다.
가장 최근 빌드인 2.14.1은 11월 1일 20시 31분에 iOS 78, 20시 39분에 Android 72(versionCode)가 나왔습니다. iOS 76과 Android 71은 그날 저녁 고친 세 가지가 빠져 쓰지 않았고, iOS 77은 중간에 멈춘 빌드가 번호만 가져갔습니다.
7. 로컬 빌드 전 체크리스트
다음 릴리스 때 제가 다시 볼 목록입니다.
- 동기화 스크립트로 네이티브 파일(위젯 확장 포함)의 버전까지 맞췄는가.
prebuildCommand에 기대지 않는다. .easignore가 있으면 하위.gitignore는 무시된다.ios/Pods,android/app/build,android/app/.cxx를 적었는가.- 두 플랫폼을 동시에 빌드하지 않는다. 외장 디스크라면 더더욱.
Podfile.lock이 실제 설치 버전과 맞는가.pod install --deployment로 확인한다.- Gradle Metaspace에 여유가 있는가. 이 프로젝트는 1024MB다.
- iOS 빌드 동안 Homebrew rsync 링크를 끊고, 끝나면 다시 걸었는가.
- Android 빌드 뒤 매니페스트의 줄 모양 변경은 되돌리고 커밋하지 않는다.
- 산출물 안의 버전이 앱과 확장에서 같은가. 업로드한 사본과 SHA-256이 같은가.
- 실패한 빌드도 번호를 쓴다. 번호가 건너뛰어도 제출에는 문제없다.
남은 문제도 있습니다. 빌드가 매니페스트를 왜 다시 쓰는지는 여전히 모르고, rsync는 매번 링크를 끊는 우회일 뿐이며, Android 제출도 아직 손으로 합니다. 그래도 2.10.0 때 빌드 번호 다섯 개를 쓰며 알아낸 것들은 이제 스크립트와 이 목록에 들어 있습니다.
JS만 바뀌는 수정은 OTA로 보내므로 이 절차는 스토어 버전을 올리는 날에만 밟습니다. OTA 이야기는 출시 후 회고에, Expo 앱의 네이티브 설정 이야기는 유니버설 링크 구현기에 있습니다. 앱이 궁금하다면 데일리베이비 소개 페이지를 봐 주세요.