[Unity] 유니티 Tenjin SDK 중복 빌드 에러 대응하기
원인
Tenjin SDK 중복 빌드 에러는 주로 다음과 같은 원인으로 발생합니다.
-
두 개 이상의 Tenjin SDK 임포트: 마치 같은 발표 자료를 두 개 이상 복사해둔 것과 같습니다. 유니티 프로젝트에 Tenjin SDK가 여러 개 임포트되어 있는 경우, 빌드 과정에서 클래스나 리소스가 중복되어 충돌이 발생합니다.
예를 들어, Asset Store에서 받은 SDK와 별도로 직접 파일을 추가한 경우, 또는 다른 플러그인에 Tenjin SDK가 포함된 경우 발생할 수 있습니다. -
Plugin 폴더 내 중복 파일: 유니티의 Plugins 폴더는 플랫폼별 플러그인을 관리하는 곳입니다. 이 폴더 안에 Tenjin 관련 파일이 중복되어 있는 경우에도 에러가 발생할 수 있습니다.
특히, Android, iOS 등 플랫폼별 폴더 내에 중복된 .aar, .jar, .framework 파일이 있는지 확인해야 합니다. 마치 발표 자료의 최종본과 수정본이 같은 폴더에 섞여 있는 상황과 같습니다. -
다른 플러그인과의 충돌: 다른 플러그인에서도 Tenjin SDK의 일부 또는 유사한 라이브러리를 사용하는 경우 충돌이 발생할 수 있습니다. 다른 조의 발표 자료에 우리 조의 자료 일부가 무단으로 포함된 상황과 같습니다.
예를 들어, Firebase나 Adjust와 같은 광고 측정 SDK와 충돌이 발생할 수 있습니다. -
잘못된 SDK 버전 또는 설치: Tenjin SDK의 버전이 프로젝트의 다른 플러그인이나 유니티 버전과 호환되지 않는 경우, 또는 SDK 설치 과정에서 오류가 발생한 경우에도 문제가 발생할 수 있습니다. 마치 오래된 참고 자료를 최신 발표에 사용하거나, 자료가 손상된 경우와 같습니다.
-
Gradle 설정 충돌 (Android): Android 빌드 시 Gradle 설정 파일 (build.gradle, settings.gradle)에서 Tenjin 관련 설정이 중복되거나 충돌하는 경우 에러가 발생할 수 있습니다.
마치 발표 자료의 목차나 참고 문헌 목록이 두 가지 버전으로 작성되어 충돌하는 상황과 같습니다.
해결 방법
이제 이러한 문제들을 어떻게 해결할 수 있는지 살펴보겠습니다.
- Tenjin SDK 단일 임포트 확인: 프로젝트 내에 Tenjin SDK가 단 하나만 임포트되어 있는지 확인합니다. 불필요한 SDK는 삭제합니다. 발표 자료를 하나로 통합하는 과정과 같습니다.
- Assets 폴더에서 “Tenjin” 또는 “TenjinSDK”를 검색하여 중복된 폴더나 파일을 확인합니다.
- 중복된 폴더나 파일이 있다면 삭제합니다.
- Plugins 폴더 정리: Plugins 폴더 및 하위 폴더 (Android, iOS 등)를 확인하여 Tenjin 관련 파일이 중복되어 있는지 확인합니다. 중복된 파일이 있다면 삭제합니다. 마치 최종 발표 자료만 남기고 나머지 초안들을 모두 정리하는 것과 같습니다.
- 특히, Android 폴더 내의 .aar 파일과 iOS 폴더 내의 .framework 파일의 중복 여부를 꼼꼼히 확인해야 합니다.
- 플러그인 충돌 확인 및 해결: 다른 플러그인과의 충돌이 의심되는 경우, 해당 플러그인의 문서 또는 개발자에게 문의하여 충돌 여부를 확인하고 해결 방법을 찾아야 합니다. 마치 다른 조와 협의하여 자료의 중복 부분을 조정하는 과정과 같습니다.
- 가능하다면, 충돌하는 플러그인의 버전을 업데이트하거나, 다른 대안을 찾아보는 것이 좋습니다.
- 최신 버전 SDK 사용 및 재설치: Tenjin SDK의 최신 버전을 사용하고 있는지 확인하고, 문제가 지속될 경우 SDK를 다시 설치해봅니다. 마치 최신 참고 자료를 사용하고, 자료가 손상되었을 경우 다시 다운로드 받는 것과 같습니다.
- Tenjin 공식 웹사이트 또는 Asset Store에서 최신 버전의 SDK를 다운로드 받을 수 있습니다.
- 기존 SDK를 삭제하고 새로 임포트하는 것이 좋습니다.
- Gradle 설정 확인 및 수정 (Android): Android 빌드 시 발생하는 에러라면, Gradle 설정 파일을 확인하여 Tenjin 관련 설정이 중복되거나 충돌하는 부분을 수정해야 합니다. 마치 발표 자료의 목차나 참고 문헌 목록을 하나의 버전으로 통일하는 과정과 같습니다.
- build.gradle 파일의 dependencies 블록에서 Tenjin 라이브러리가 한 번만 선언되어 있는지 확인합니다.
- settings.gradle 파일에서 Tenjin 모듈이 올바르게 포함되어 있는지 확인합니다.