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, lalu buka File > Add Package Dependencies.
2. Masukkan https://github.com/googlemaps/ios-navigation-sdk sebagai URL, tekan Enter untuk mengambil 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 "Versi Persis". Setelah selesai, klik "Tambahkan Paket".

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

1. Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

1. Dari setelan konfigurasi project Xcode, temukan Framework, Library, dan Konten Tersemat. Gunakan tanda minus(-) untuk menghapus framework berikut:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Dari direktori level teratas project Xcode Anda, hapus paket GoogleMaps.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFrameworks 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 komputer 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 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, Navigation, dan Places yang ada dari project.
4. Tarik XCFrameworks berikut ke dalam project Anda di bagian Frameworks, Library, dan Konten Tersemat 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. Saat 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 library berikut:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.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
   • 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 panel Build Settings dari Basic ke All.
11. Buka Info.plist dan tambahkan key-value pair berikut:
    • Kunci: NSLocationWhenInUseUsageDescription (Privasi - Deskripsi Penggunaan Lokasi Saat Digunakan)
      Nilai: "Aplikasi ini memerlukan izin untuk menggunakan lokasi Anda untuk navigasi belokan demi belokan."
    • Kunci: NSLocationAlwaysAndWhenInUseUsageDescription (Privasi - Deskripsi Penggunaan Lokasi Selalu dan Saat Digunakan)
      Nilai: "Aplikasi ini memerlukan izin untuk menggunakan lokasi Anda untuk navigasi belokan demi belokan."

CocoaPods

Navigation SDK for iOS tersedia sebagai pod CocoaPods. CocoaPods merupakan pengelola dependensi open source untuk proyek Swift dan Objective-C Cocoa.

Jika Anda belum memiliki alat CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal. Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.

sudo gem install cocoapods

Buat Podfile untuk Navigation SDK for iOS dan gunakan untuk menginstal API beserta dependensinya:

1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda baru mengenal pengembangan iOS:
   1. Membuat project baru.
   2. Pilih template iOS > Aplikasi.
   3. Di layar opsi project:
      1. Masukkan Project Name.
      2. Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API di bawah.
      3. Tetapkan Antarmuka project ke Storyboard.
      4. Tetapkan Language ke Swift atau Objective-C.
2. Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.
3. Edit Podfile dan tambahkan dependensi Anda beserta versinya. Berikut adalah contoh yang menyertakan dependensi yang Anda perlukan untuk Navigation SDK for iOS: # Referensi penginstalan Cocoapods #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '9.2.0'
   end
           

   Pastikan untuk menjalankan pod outdated secara rutin guna mendeteksi versi yang lebih baru. Jika perlu, upgrade ke versi terbaru.
4. Simpan Podfile.

5. Buka terminal dan buka direktori yang berisi Podfile:

   cd <path-to-project>

6. Jalankan perintah pod install. Tindakan ini akan menginstal API yang ditentukan di Podfile, beserta dependensi apa pun.

   pod install

7. Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

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

1. Buka terminal dan buka direktori project yang berisi Podfile.
2. Jalankan perintah pod update. Tindakan ini akan mengupdate semua API yang ditentukan dalam Podfile ke versi terbaru.

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

1. Tambahkan pernyataan impor berikut:

   import GoogleMaps
   import GoogleNavigation

2. Tambahkan kode 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 kode berikut ke metode application:didFinishLaunchingWithOptions: Anda:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];