Menyiapkan project Xcode

Swift Package Manager

Navigation SDK dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda telah menghapus dependensi Navigation SDK yang ada.

Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:

1. Buka project atau workspace Xcode Anda, lalu buka File > Add Package Dependencies.
2. Masukkan https://github.com/googlemaps/ios-navigation-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik "Add Package".
3. Untuk menginstal version tertentu, tetapkan kolom Aturan Dependensi ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Versi Persis". Setelah selesai, klik "Tambahkan Paket".
4. Dari jendela Pilih Produk Paket, verifikasi bahwa GoogleNavigation akan ditambahkan ke target main yang Anda tetapkan. Setelah selesai, klik "Tambahkan Paket".
5. Untuk memverifikasi penginstalan, buka panel Umum target Anda. Di Framework, Library, dan Konten Sematan, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Package Dependencies" di "Project Navigator" untuk memverifikasi paket dan versinya.

Untuk memperbarui package project yang ada, ikuti langkah-langkah berikut:

1. Dari Xcode, buka File > Packages > Update To Latest Package Versions.
2. Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Dari direktori level teratas project Xcode, hapus paket GoogleMaps.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFramework yang berisi Navigation SDK for iOS dan Maps SDK for iOS secara manual ke project Anda dan mengonfigurasi setelan build di Xcode. XCFramework adalah paket biner yang dapat Anda gunakan di beberapa platform, termasuk mesin yang menggunakan chipset M1

Ikuti langkah-langkah berikut untuk menginstal XCFrameworks untuk Navigation SDK for iOS dan Maps SDK for iOS:

1. Download file biner dan file resource SDK berikut:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda baru menggunakan iOS, buat project baru dan pilih iOS App template.
3. Hapus semua referensi Maps, Navigasi, dan Tempat yang ada dari project.
4. Tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content untuk menginstal Maps dan Navigation SDK (saat diminta, pilih Copy items if needed):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Tarik GoogleMaps.bundle dari GoogleMapsResources yang Anda download ke direktori level teratas project Xcode Anda. Jika diminta, pastikan Salin item jika perlu dipilih.
6. Tarik GoogleNavigation.bundle dari GoogleNavigationResources yang Anda download ke direktori level teratas project Xcode Anda. Jika diminta, pastikan Copy items into destination group's folder dipilih.
7. Pilih project Anda dari Project Navigator, lalu pilih target aplikasi Anda.
8. Buka tab Build Phases, dan dalam Link Binary with Libraries, tambahkan framework dan pustaka berikut:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. Di target aplikasi Anda, pilih tab Capabilities, aktifkan Background Modes, dan aktifkan mode berikut:
   • Audio, AirPlay, dan Picture in Picture
   • Pembaruan lokasi
10. Pilih project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Other Linker Flags, tambahkan ‑ObjC untuk debug dan release. Jika setelan ini tidak terlihat, ubah filter di bar Build Settings dari Basic ke All.
11. Buka Info.plist dan tambahkan pasangan nilai kunci berikut:
    • Kunci: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Nilai: "Aplikasi ini memerlukan izin untuk menggunakan lokasi Anda untuk navigasi belokan demi belokan."
    • Kunci: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Nilai: "Aplikasi ini memerlukan izin untuk menggunakan lokasi Anda untuk navigasi belokan demi belokan."

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

1. Tambahkan pernyataan impor berikut:

   import GoogleMaps
   import GoogleNavigation

2. Tambahkan yang berikut ke metode application(_:didFinishLaunchingWithOptions:) Anda:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

1. Tambahkan pernyataan impor berikut:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Tambahkan yang berikut ke metode application:didFinishLaunchingWithOptions: Anda:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];