설정 및 데모

GitHub의 파일 사용

1. GitHub에서 코드 샘플 보관 파일을 다운로드하고 보관 파일을 압축 해제합니다.
2. 터미널 창을 열고 샘플 파일을 펼친 디렉터리로 이동한 후 사용하려는 언어에 적합한 샘플 디렉터리를 드릴다운합니다.
   • Swift의 경우 cd google-maps-ios-utils-master/samples/SwiftDemoApp를 실행합니다.
   • Objective-C의 경우 cd google-maps-ios-utils-master/samples/ObjCDemoApp를 실행합니다.
3. 다음 명령어를 실행합니다.
   

   pod install

4. Xcode를 닫은 다음 프로젝트의 .xcworkspace 파일을 열고 더블클릭하여 Xcode를 실행합니다. 이제부터 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

CocoaPods v1.6.1 사용

1. 터미널 창을 열고 버전 1.6.1을 설치합니다.

   sudo gem install cocoapods -v1.6.1

2. CocoaPods를 사용하여 Google 지도 파일을 가져옵니다.

   pod try Google-Maps-iOS-Utils

   메시지가 나타나면 Swift 또는 Objective-C를 선택합니다. CocoaPods가 사양 저장소를 업데이트한 다음, SwiftDemoApp.xcodeproj 또는 ObjCDemoApp.xcodeproj라는 임시 Xcode 프로젝트에서 데모를 엽니다.

Swift

다음과 같이 API 키를 AppDelegate.swift에 추가합니다.

1. 다음 import 문을 추가합니다.

   import GoogleMaps

2. 다음 줄을 수정하여 큰따옴표 사이에 API 키를 추가합니다.

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

다음과 같이 API 키를 AppDelegate.m에 추가합니다.

1. 다음 import 문을 추가합니다.

   @import GoogleMaps;

2. 다음 줄을 수정하여 큰따옴표 사이에 API 키를 추가합니다.

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

CocoaPods 사용

1. 아직 Xcode 프로젝트가 없다면 지금 만들어 로컬 머신에 저장하세요. iOS 개발을 처음 사용하는 경우 단일 뷰 애플리케이션을 만드세요.
2. 프로젝트에 pod 파일이 아직 없으면 프로젝트 디렉터리에 Podfile 파일을 만드세요. 이 파일은 프로젝트의 종속 항목을 정의합니다.
3. 프로젝트의 pod 파일을 수정하고 Google-Maps-iOS-Utils pod의 종속 항목을 추가합니다. 다음은 iOS용 Maps SDK와 유틸리티 라이브러리에 필요한 종속 항목이 포함된 예시입니다.

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.2.2'
   end

4. pod install를 실행합니다.
5. Xcode를 닫은 다음 프로젝트의 .xcworkspace 파일을 열고 더블클릭하여 Xcode를 실행합니다. 이제부터 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

참고: 마커 클러스터링 유틸리티는 쿼드트리에 종속되지만, 마커 클러스터링 없이 쿼드트리를 사용할 수 있습니다. quadtree 유틸리티만 원하는 경우 포드 파일에서 pod 'Google-Maps-iOS-Utils'을 'Google-Maps-iOS-Utils/QuadTree'로 변경할 수 있습니다.

Carthage 사용

1. Carthage를 설치합니다. 여러 메서드가 있으므로 정확한 단계는 Carthage README 파일을 참조하세요.
2. 아직 Xcode 프로젝트가 없으면 지금 만들어 로컬 시스템에 저장합니다. iOS용 앱을 처음 개발하는 경우 새 프로젝트를 만들고 iOS 앱 템플릿을 선택합니다. Xcode 11.7 이전 버전에서 단일 뷰 애플리케이션을 만듭니다.)
3. 프로젝트 디렉터리에 Cartfile 파일을 만듭니다. 이 파일은 프로젝트의 종속 항목을 정의합니다.
4. Cartfile를 수정하고 iOS용 Maps SDK 유틸리티 라이브러리 종속 항목을 추가합니다.
   

   github "googlemaps/google-maps-ios-utils"

5. Cartfile을 저장합니다.
6. 터미널 창에서 Cartfile이 포함된 디렉터리로 이동합니다.
   

   cd <path-to-project>

7. update 명령어를 실행합니다.
   

   carthage update --platform iOS

   
   그러면 Cartfile에 지정된 API가 포함된 종속 항목과 함께 설치됩니다.
8. Finder의 프로젝트 디렉터리에서 Carthage/Build/iOS 아래에 있는 다운로드한 프레임워크 파일로 이동합니다.
9. 다음 번들을 프로젝트로 드래그하여 iOS용 Maps SDK 프레임워크를 프로젝트에 추가합니다. 메시지가 표시되면 필요한 경우 항목을 복사합니다. 위와 동일한 버전을 사용하세요.를 선택합니다.
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
   프리미엄 플랜 고객은 GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework도 포함해야 합니다.
10. 프로젝트에서 GoogleMaps.framework를 마우스 오른쪽 버튼으로 클릭하고 Show In Finder(Finder에서 보기)를 선택합니다.
11. Resources 폴더의 Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle를 프로젝트로 드래그합니다. 메시지가 표시되면 Copy items into destination group's folder(항목을 대상 그룹의 폴더에 복사)가 선택되지 않았는지 확인합니다.
12. Project Navigator에서 프로젝트를 선택하고 애플리케이션의 대상을 선택합니다.
13. 애플리케이션 타겟의 Build Phases(빌드 단계) 탭을 열고 Link Binary with Libraries(바이너리를 라이브러리와 연결) 내에 다음 프레임워크를 추가합니다.
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. 특정 대상 대신 자신의 프로젝트를 선택하고 Build Settings(빌드 설정) 탭을 엽니다. Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC를 추가합니다. 이 설정이 표시되지 않으면 Build Settings(빌드 설정) 표시줄의 필터를 Basic(기본)에서 All(모두)로 변경합니다.

Swift Package Manager 사용

1. 아직 Xcode 프로젝트가 없다면 지금 만들어 로컬 머신에 저장하세요. iOS 개발이 처음인 경우 새 프로젝트를 만들고 iOS 앱 템플릿을 선택합니다. Xcode 11.7 이하에서는 단일 뷰 애플리케이션을 만듭니다.)
2. iOS용 Maps SDK를 종속 항목으로 추가합니다. 옵션은 SDK 설치를 참고하세요.
3. Xcode 프로젝트에서 File -> Swift Packages -> Add Package Dependency로 이동합니다.
4. 표시되는 창에서 iOS용 Maps SDK 유틸리티 라이브러리 URL https://github.com/googlemaps/google-maps-ios-utils을 입력하고 다음을 선택합니다.
• 이 시점에서 GitHub 계정으로 인증하라는 메시지가 표시될 수 있습니다. 안내에 따라 GitHub 개인 액세스 토큰을 만들어 프로세스를 계속합니다.
5. 다음 창에서 버전 라디오 옵션을 선택하고 드롭다운 목록에서 일치를 선택한 후 iOS용 Maps SDK 유틸리티 라이브러리(예: "3.4.0")의 최신 버전을 입력하고 다음을 선택합니다.