Menyiapkan project Xcode

Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan project Xcode yang Anda gunakan untuk mengembangkan aplikasi Anda.

Catatan rilis tersedia untuk setiap rilis.

Langkah 1: Instal software yang diperlukan

Untuk membuat project menggunakan Navigation SDK for iOS, Anda harus mendownload dan menginstal:

  • Xcode versi 26.0 atau yang lebih baru

Langkah 2: Buat project Xcode dan instal Navigation SDK

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 Dependency Rule ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Exact Version". Setelah selesai, klik "Add Package".
  4. Dari jendela Choose Package Products, pastikan GoogleNavigation akan ditambahkan ke target main yang ditentukan. Setelah selesai, klik "Add Package".
  5. Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content , Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Package Dependencies" dari "Project Navigator" untuk memverifikasi paket dan versinya.

Untuk mengupdate package untuk project yang sudah ada, ikuti langkah-langkah berikut:

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

Untuk menghapus Navigation SDK for iOS yang ada dan diinstal secara manual, ikuti langkah-langkah berikut:
  1. Dari setelan konfigurasi project Xcode Anda, temukan Frameworks, Libraries, and Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. Dari direktori level teratas project Xcode Anda, hapus GoogleMaps paket.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFrameworks yang berisi Navigation SDK for iOS, dan Maps SDK for iOS ke project Anda secara manual, serta 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:
  2. Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda baru menggunakan iOS, buat project baru dan pilih template aplikasi iOS.
  3. Hapus semua referensi Maps, Navigation, dan Places yang ada dari project.
  4. Tarik XCFrameworks berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content untuk menginstal Maps dan Navigation SDK (jika 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 Copy items if needed 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, lalu di bagian Link Binary with Libraries, tambahkan framework dan library 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, lalu aktifkan mode berikut:
    • Audio, AirPlay, and Picture in Picture
    • Location updates
  10. Pilih project Anda, bukan target tertentu, lalu buka tab Build Settings. Di bagian Other Linker Flags , tambahkan ‑ObjC untuk debug dan release. Jika setelan ini tidak terlihat, ubah filter di panel Build Settings dari Basic menjadi All.
  11. Buka Info.plist dan tambahkan key-value pair 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."

Langkah 3: Tambahkan kunci API Anda ke project

Contoh berikut menunjukkan cara menambahkan kunci API ke project Anda di Xcode:

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

  1. Tambahkan pernyataan impor berikut: 
    import GoogleMaps
import GoogleNavigation
  2. Tambahkan hal 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 hal berikut ke metode application:didFinishLaunchingWithOptions: Anda: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Langkah 4 (opsional): Periksa file manifes Privasi Apple

Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Buka halaman Detail Privasi Apple App Store untuk mengetahui update dan informasi selengkapnya.

File manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa kontennya, buat arsip aplikasi Anda dan buat laporan privasi dari arsip tersebut.

Jika Anda adalah pelanggan Layanan Mobilitas

Jika Anda adalah pelanggan Layanan Mobilitas, pelajari penagihan dalam dokumentasi Mobilitas. Untuk mengetahui informasi selengkapnya tentang pencatatan transaksi, lihat Menyiapkan penagihan. Untuk mempelajari cara menambahkan ID transaksi ke penerapan Navigation SDK, lihat Mengaitkan penggunaan layanan Anda dengan transaksi Mobilitas.

Langkah berikutnya

Setelah memiliki kunci API dan project Xcode, Anda dapat membuat dan menjalankan aplikasi. Navigation SDK for iOS menyediakan tutorial yang dapat membantu Anda memulai. Untuk mengetahui detail selengkapnya, lihat: