M1맥북 카카오 맵 구현 방법 ( kakao SDK for ios )

현재 저의 개발 환경은 M1 맥북, Xcode: 13.4.1 , Simulator: ios 15.5입니다.

카카오톡 디벨로퍼 가이드와 검색을 통해 진행했으며 여러 가지 문제로 인하여 오류가 발생할 수 있습니다. 

 

네이티브 앱 키 발급 및 Bundle ID 등록하기 위하여

1. 카카오 개발자 사이트에 접속합니다. 

https://developers.kakao.com/product/map

Kakao Developers

 

2. API 사용하기 - 시작하기에 들어갑니다.

 

3. 애플리케이션 추가합니다.

 

4. 원하는 이름명으로 앱 이름, 사업자명 작성 후 저장하여 만들기

 

5. 왼쪽 앱 설정 메뉴에 -> 플랫폼 -> ios플랫폼 등록

위에 사진에 보이는 빨강 박스에 현재 카카오 맵을 구현할 xcode 프로젝트의 Bundle Identifier값을 그대로 적어주시면 됩니다.

Bundle Identifier값은 프로젝트 TARGETS -> General -> Identity -> Bundle Identifier에서 확인해주시면 됩니다.

 

 

6. Info.plist 파일에 발급받은 App key를 넣어줍니다.

왼쪽 앱 설정 메뉴에 -> 요약정보 -> 앱 키 -> 네이티브 앱 키를 복사합니다.

아래 사진과 같이 Info.plist에 KAKAO_APP_KEY

 

7. 프레임워크들을 추가해야 합니다.

프로젝트 - TARGETS - General - Frameworks, Libraries and Embedded Content로 이동하여

+ 버튼을 눌러 필요한 프레임 워크들을 추가해야 합니다.

• Metal.framework ( OpenGLES.framework 대신 )
• SystemConfiguration.framework
• CoreLocation.framework
• QuartzCore.framework
• libc++.tbd
• libxml2.tbd
• libsqlite3.tbd

※ libc++.tbd / libxml2.tbd / libsqlite3.tbd 세 가지는 한 번에 들어가지 않아 두 번 넣어 주는 작업을 해야 합니다.

 

※OpenGLES.framework대신 Metal.framework가 쓰이는 이유

OpenGLES.framework대신 Metal.framework가 쓰이는 이유 관련해서 한 번쯤 읽기 좋은 블로그인 거 같습니다.

2018년도에 OpenGLES는 ios와 MacOs에서 더 이상 사용되지 않도록 변경되었으며 Metal은 Apple에 의해 2014년도에 등장하여 OpenGLES 대신 좋은 대안이 되었다고 합니다. 

https://levenshtein.tistory.com/382

 

8. Kakao map SDK 다운을 받아야 합니다.

https://apis.map.kakao.com/ios/guide/

위에 링크에 들어가 다운로드를 합니다.

다운로드한 SDK파일을 압축을 풀어 준 후 DaumMap.embeddedframework 폴더를 

프로젝트 안에 있는 프레임워크 폴더  아래에 넣어주시면 됩니다.

프레임워크 폴더 우클릭 후 Add Files to "~~" 클릭하여 방금 압축 푼 DaumMap.embeddedframework폴더 파일을 넣어줍니다.

폴더를 넣어준 후 프로젝트 - TARGETS - General - Frameworks, Libraries and Embedded Content로 이동하여

DaumMap.framework가 들어가진 것을 확인해야 합니다.

 

9. 헤더 파일을 만들어야 합니다.

카카오 맵이 Objective-C로 작성되어 Swift에서 사용하려면 헤더 파일이 필요합니다.

command + n 눌러 헤더 파일을 만들어 줍니다. 이름은 원하시는 이름 적어주셔도 됩니다.

만든 헤더 파일에  #import <DaumMap/MtMapView.h>  추가해주시면 됩니다.

헤더파일을 연결해주기 위해 설정을 해야 합니다.

TARGETS - Build Settings - 왼쪽 검색 칸에 swift compiler 검색 후 Swift Compiler - General - Objective -C Bridging Header

프로젝트/헤더 파일명. h 로 써주시면 됩니다.  ( 헤더 파일 full path 값 넣어주셔도 됩니다 )

 

10. Build Settings 설정해주기

현재 Map용 SDK는 Automatic Reference Counting(ARC)을 지원하지 않습니다.

Objective-C Automatic Reference Counting - NO로 바꿔준다.

Weak Reference in Manual Retain Release - NO로 바꿔준다.

※ 여러 번의 삽질과 경험으로 얻은 결과는 이유는 있지만 YES로 해도 빌드가 됩니다. ( 이유는 모르겠지만 공부와 검색을 해봐야 할 거 같습니다. )

M1맥북은 애플 자사에서 생산하는 ARM 기반으로 돌아갑니다. CPU가 달라져서 빌드할 때 사용되는 CPU의 아키텍처도 변하게 되면서 arm64를 사용해야 합니다.

Excluded Architectures에서 arm64를 입력해줍니다.

 

미 설정 시 오류 내용

DaumMap.embeddedframework/DaumMap.framework/DaumMap(MTMapView.o), building for iOS Simulator, but linking in object file built for iOS, for architecture arm64

 

Framework Search Paths에    $(PROJECT_DIR)/DaumMap.embeddedframework을 적어줍니다.

 

※ $(PROJECT_DIR)/DaumMap.embeddedframework  - 조건은 프레임워크 폴더 아래에 DaumMap.embeddedframework 폴더 아래  DaumMap / 리소스 폴더가 있어야 빌드가 됩니다. 

 

오류 내용

경로가 잘못되거나 헤더를 잘못 만들거나 등등 여러가지 이유로 DaumMap/MTMapView.h file not found가 없다는 오류가 정말 여러번 뜰수있습니다.

 

11. 맵을 화면에 띄우기 위해 ViewController에 코드 작성하기

import UIKit

class ViewController: UIViewController, MTMapViewDelegate {
    
    var mapView: MTMapView?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        
        mapView = MTMapView(frame: self.view.bounds)
        if let mapView = mapView {
            mapView.delegate = self
            mapView.baseMapType = .standard
            self.view.addSubview(mapView)
        }
    }


}

빌드가 성공적으로 되면서 결과 화면입니다.

 

 

카카오 맵을 구현하면서 정말 다양한 오류와 검색을 통해 하나씩 찾으면서 해결해가는 과정을 겪었습니다.

경험을 해봄으로써 좀 더 성장할 수 있는 기회가 된 것 같습니다.