(30초 읽기) KakaoMaps SDK for Android 의존성 추가 에러 😱 🗺️

Kakao Map SDK를 Android 프로젝트에 추가하다가 에러가 발생했어? 😩
대부분 settings.gradle 파일에서 의존성을 추가할 때 문제가 생기는 경우가 많아!

---

🔥 문제 원인

공식 Kakao Map API 문서에서는 이렇게 안내하고 있어:

repositories {
    maven { url 'https://devrepo.kakao.com/nexus/repository/kakaomap-releases/' }
}

 

하지만 Android 공식 문서에 따르면,

• Groovy는 .gradle 확장자
• Kotlin은 .gradle.kts 확장자를 사용해.

공식 문서는 Groovy 기준이라 Kotlin으로 작성된 프로젝트에선 에러가 날 수 있어! ⚠️

---

💡 해결 방법

Kotlin 스크립트(.gradle.kts)에서는 아래처럼 작성해야 해:

repositories {
    maven(url = "https://devrepo.kakao.com/nexus/repository/kakaomap-releases/")
}

🔎 왜 이런 문제가 생길까?

• Kotlin DSL은 url = "..." 형식을 사용하고,
• Groovy DSL은 url '...' 형식을 사용해.

따라서 프로젝트의 빌드 스크립트가 Kotlin인지 확인하고 맞는 방식으로 작성해야 해.

---

🚀 요약 정리

✔ Kakao Map SDK 의존성 추가 시 Kotlin DSL에 맞게 작성해야 함
✔ Kotlin 프로젝트: url = "..."
✔ Groovy 프로젝트: url '...'
✔ 안드로이드 공식 문서와 Kakao 문서의 차이점에 주의!

---

다음에 Kakao Map SDK 추가할 때 에러 없이 바로 성공할 수 있을 거야! 🚀
Kotlin DSL과 Groovy DSL 차이만 기억하면 돼! 😎