Unity 6 빌드 에러: GPGS 플러그인 Gradle 8.x 호환성 문제 해결 (srcaar 이슈)

[Unity] Unity 6 빌드 에러: GPGS 플러그인 Gradle 8.x 호환성 문제 해결 (srcaar 이슈)

1. 발생한 에러 로그

* What went wrong:
Execution failed for task ':launcher:mergeReleaseGlobalSynthetics'.
> Could not resolve all files for configuration ':launcher:releaseRuntimeClasspath'.
   > Failed to transform classes.jar (project :unityLibrary) to match attributes {artifactType=android-global-synthetics, ...}.
      > Could not resolve all files for configuration ':launcher:releaseRuntimeClasspath'.
         > No variants of com.google.games:gpgs-plugin-support:2.1.0 match the consumer attributes:
             - Incompatible because this component declares a component, as well as attribute 'artifactType' with value 'srcaar' and the consumer needed a component, as well as attribute 'artifactType' with value 'android-classes-jar'

> Could not find com.google.games:gpgs-plugin-support:2.1.0@aar.

2. 원인 분석

1. Gradle 8.7 (Unity 6)의 변화: 최신 Gradle은 라이브러리의 속성(Attribute)과 확장자를 엄격하게 검사합니다. GPGS 플러그인이 사용하는 .srcaar라는 확장자와 POM 파일의 <packaging>srcaar</packaging> 설정을 인식하지 못합니다.

2. Android Resolver의 동작 방식: 보통 Assets/GeneratedLocalRepo 폴더를 수정해서 해결하려 하지만, Unity의 **External Dependency Manager(EDM4U)**는 빌드 때마다 원본 소스 폴더에서 파일을 다시 복사해 GeneratedLocalRepo를 덮어씁니다. 즉, 생성된 폴더를 수정해 봤자 다시 원상 복구되어 에러가 재발합니다.

3. 해결 방법 (Step-by-Step)

단계 1: 원본 라이브러리 폴더로 이동

경로:Assets/GooglePlayGames/com.google.play.games/Editor/m2repository/com/google/games/gpgs-plugin-support/2.1.0/

단계 2: 파일 확장자 변경

• 변경 전: gpgs-plugin-support-2.1.0.srcaar

• 변경 후: gpgs-plugin-support-2.1.0.aar

단계 3: POM 파일 수정 (핵심)

<packaging>srcaar</packaging>

<packaging>aar</packaging>

단계 4: 체크섬(Checksum) 파일 삭제

• .md5

• .sha1

단계 5: 빌드 실행

• 별도로 Force Resolve를 누르지 않아도, 빌드 과정에서 Unity가 변경된 .aar 파일을 감지하고 GeneratedLocalRepo에 올바른 파일을 자동으로 복사합니다.

• 이후부터는 정상적으로 빌드가 성공하는 것을 확인할 수 있습니다.

요약