Mendapatkan iOS Consumer SDK

Pilih platform: Android iOS JavaScript

Untuk mengikuti perjalanan sesuai permintaan di aplikasi konsumen iOS, gunakan Consumer SDK. Untuk informasi lebih lanjut tentang dan pengantar untuk mengikuti perjalanan menggunakan fitur berbagi perjalanan, lihat Mengikuti perjalanan di iOS.

Misalnya, lihat aplikasi sampel iOS atau sampel gabungan.

Guna menyiapkan SDK Konsumen untuk aplikasi konsumen iOS, ikuti langkah-langkah berikut:

1. Periksa persyaratan sistem minimum.
2. Dapatkan SDK Konsumen.
3. Periksa file Manifes Privasi Apple.
4. Mengonfigurasi project Konsol Google Cloud.
5. Dapatkan token autentikasi.
6. Lakukan inisialisasi Consumer SDK.

Memeriksa persyaratan sistem minimum

Periksa catatan rilis untuk mengetahui persyaratan minimum untuk versi SDK Konsumen yang Anda gunakan. Lihat Catatan rilis.

• Perangkat seluler harus menjalankan iOS 14 atau yang lebih baru.
• Apple Xcode versi 15 atau yang lebih baru.

Mendapatkan SDK Konsumen

Anda menginstal dan mengonfigurasi Consumer SDK dengan CocoaPods.

Swift Package Manager

Consumer SDK dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda memiliki menghapus semua dependensi Consumer SDK yang ada.

Penting: Petunjuk ini mengasumsikan penggunaan Xcode 15 atau yang lebih baru, tetapi harus serupa untuk versi Xcode sebelumnya.

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

1. Buka project atau workspace Xcode, lalu buka File > Menambahkan Dependensi Paket.
2. Masukkan https://github.com/googlemaps/ios-consumer-sdk sebagai URL, tekan Enter untuk menarik paket, dan klik "{i>Add Package<i}".
3. Untuk menginstal version tertentu, setel kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk proyek baru, sebaiknya tentukan versi terbaru dan menggunakan "Versi Persis" sebelumnya. Setelah selesai, klik "Add Package".
4. Dari jendela Choose Package Products, pastikan GoogleRidesharingConsumer akan ditambahkan ke target main yang Anda tetapkan. 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 "{i>Package Dependencies<i}" bagian "Navigator Proyek" untuk memverifikasi paket dan versinya.

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

1. Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut: GoogleMapsBase, GoogleMapsCore, dan GoogleMapsM4B setelah mengupgrade. Jangan hapus dependensi untuk GoogleMaps. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

   Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries, dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:

   • GoogleMapsBase (Hanya untuk upgrade dari versi sebelum 9.0.0)
   • GoogleMapsCore (Hanya untuk upgrade dari versi sebelum 9.0.0)
   • GoogleMapsM4B (Hanya untuk upgrade dari versi sebelum 9.0.0)
2. Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
3. Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.

Penting: Terkadang, artefak tidak dapat diselesaikan atau terjadi error, dalam hal ini pilih "File > Paket > Reset Cache Paket".

Untuk menghapus dependensi Consumer SDK yang sudah ada yang ditambahkan menggunakan CocoaPods, ikuti langkah berikut:

1. Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Hapus Podfile, Podfile.resolved, dan Xcode workspace jika Anda tidak menggunakannya untuk hal apa pun selain CocoaPods.

Untuk menghapus Consumer SDK yang sudah ada yang diinstal secara manual, ikuti langkah-langkah berikut:

1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Konten Tersemat. Gunakan tanda minus(-) untuk menghapus kerangka kerja berikut ini:

   • GoogleRidesharingConsumer.xcframework

2. Dari direktori level teratas project Xcode Anda, hapus Paket GoogleRidesharingConsumer.

Menggunakan CocoaPods

1. Instal alat CocoaPods: Buka jendela terminal dan jalankan perintah berikut:

   sudo gem install cocoapods
   

   Untuk detail selengkapnya, lihat Panduan Memulai CocoaPods.

2. Buat Podfile untuk Consumer SDK: Anda gunakan Podfile untuk menginstal API dan dependensinya.

   1. Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi proyek Anda.

   2. Edit Podfile dan tambahkan dependensi Anda. Berikut contoh yang menyertakan dependensi:

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      

   3. Simpan Podfile: Buka terminal dan buka folder dengan Podfile:

      cd <path-to-project>
      

3. Jalankan perintah pod install: Perintah ini menginstal API yang ditentukan dalam Podfile, beserta dependensi yang mungkin dimilikinya.

   pod install
   

4. Buka project Anda di Xcode: Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace proyek Anda untuk menjalankan Xcode. Untuk membuka project nanti, gunakan file {i> .xcworkspace<i}.

   Catatan: Jalankan pod outdated secara berkala untuk mendeteksi kapan ada versi SDK yang lebih baru. Untuk informasi selengkapnya, lihat Versi Consumer SDK di Catatan rilis Consumer SDK.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFramework yang berisi Consumer SDK ke project Anda dan konfigurasi setelan build di Xcode.

Perhatian: Sebagai praktik terbaik, gunakan Cocoapods menginstal Consumer SDK setiap kali sebaik mungkin.

Sebelum mengikuti panduan ini, lakukan hal berikut:

• Unduh XCFramework, paket biner yang Anda gunakan untuk menginstal SDK Konsumen. Anda dapat menggunakan paket ini di beberapa platform, termasuk menggunakan {i>chipset<i} M1.

• Instal Maps SDK.

1. Download resource dan biner SDK:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

2. Ekstrak file zip untuk mengakses XCFramework dan resource.

3. Mulai Xcode dan buka atau buat project. Jika Anda baru mengenal iOS, buat project baru dan pilih template iOS App.

4. Jika grup proyek Anda tidak berisi grup Framework, buat grup tersebut.

5. Tarik file gRPCCertificates.bundle yang didownload ke tingkat teratas project Xcode Anda. Jika diminta, pilih Salin item.

6. Untuk menginstal Consumer SDK, tarik GoogleRidesharingConsumer.xcframework ke project Anda di bagian Framework, Library, dan Konten Tersemat. Jika diminta, pilih Menyalin item.

7. Tarik GoogleRidesharingConsumer.bundle yang didownload ke direktori level teratas project Xcode Anda. Jika diminta, pilih Menyalin item.

8. Pilih proyek Anda dari Navigator Proyek, dan pilih target aplikasi Anda.

9. Buka tab Build Phases, lalu di Link Binary with Libraries, tambahkan framework dan library berikut jika belum sekarang:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Pilih proyek Anda, bukan target tertentu, dan buka Build Settings. Di bagian Other Linker Flags, menambahkan -ObjC untuk debug dan rilis.

    Jika setelan ini tidak terlihat, ubah filter di Kolom Build Settings dari Basic ke All.

Memeriksa file Manifes Privasi Apple

Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Kunjungi halaman Detail Privasi Apple App Store untuk pembaruan 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 dan buat laporan privasi dari arsip.

Langkah berikutnya

Mengonfigurasi project Konsol Google Cloud