[React Native] Execution failed for task ':app:transformDexArchiveWithDexMergerForRelease'

안드로이드 개발환경에서는 빌드, 실행이 잘 되다가 앱 배포를 위해 Release버전으로 빌드할 때 자주 발생하는 에러이다. 만약 이 에러를 처음 발견한 경우 안드로이드의 build.gradle에 multiDex 설정이 제대로 되어 있는지 확인할 필요가 있다.

 

app/build.gradle 에서 두 가지를 우선 추가해준 뒤

defaultConfig {
	...
    // 추가
    multiDexEnabled true
}

dependencies {
	...
    // 추가
    implementation 'com.android.support:multidex:1.0.3'
}

 

MainApplication.java에서 MultiDexApplication를 상속시켜준다.

...
// MultiDexApplication 임포트
import androidx.multidex.MultiDexApplication;

// MultiDexApplication 를 상속받도록 설정
public class MainApplication extends MultiDexApplication implements ReactApplication {
	...
}

 

 

그 뒤 Clean project를 하고 다시 빌드하면 되는 경우가 있는데, 이미 설정을 다 해준 상태에서도 같은 에러가 발생할 때가 있다.

정확한 원인은 모르겠지만 node_modules의 의존성 이슈인 것 같아 모듈을 재설치한 후 다시 Clean > Build 해주니 정상적으로 빌드가 되었다.

// package.json 의존 모듈 재설치
rm -rf node_modules && npm install
npx react-native run-android