[Android] MapAuthException(1003): Authentication failed. The APP_KEY in AndroidManifest.xml does not exist or is incorrect. 에러

에러 상황

카카오 맵 API를 사용해 지도 기능 구현 중, 지도가 실행되는 프래그먼트 실행 시 다음과 같은 에러메세지가 출력되며 지도가 뜨지 않았다.

MapAuthException(1003): Authentication failed. The APP_KEY in AndroidManifest.xml does not exist or is incorrect.

에러 원인 및 해결

에러 원인

에러메세지에서와 같이 APP_KEY가 AndroidManifest.xml에 존재하지 않는다는 문제였다.
하지만 이미 난 다음 코드를 매니패스트에 넣어둔 상태라 카카오 데브 공식 문서를 다시 확인해봤다.

        <meta-data
            android:name="com.kakao.sdk.AppKey"
            android:value="네이티브 앱키"/>

문서에서 보니 com.kakao.sdk.AppKey가 아니라 com.kakao.vectormap.APP_KEY를 넣어야했던 것이다.

찾아보니 카카오맵은 23년 7월부터 카카오 맵 v2를 출시하면서 카카오 맵 v1은 곧 서비스 종료할 것이라는 문서를 발견했다.
즉, 내가 meta-data에 넣었던 앱키명은 v2가 아닌 v1에 맞는 앱키명이었던 것이다.

에러 해결

다음으로 수정해 해결하였다.

        <meta-data
            android:name="com.kakao.vectormap.AppKey"
            android:value="네이티브 앱키"/>