Mendapatkan iOS Consumer SDK

Pilih platform: Android iOS JavaScript

Untuk mengikuti perjalanan on-demand di aplikasi konsumen iOS, gunakan Consumer SDK. Untuk mengetahui informasi selengkapnya dan pengantar tentang mengikuti perjalanan, lihat Mengikuti perjalanan di iOS.

Untuk menyiapkan Consumer SDK untuk aplikasi konsumen iOS Anda, ikuti langkah-langkah berikut:

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

Periksa persyaratan sistem minimum

Periksa catatan rilis untuk mengetahui persyaratan minimum versi Consumer SDK 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 Consumer SDK

Anda menginstal dan mengonfigurasi Consumer SDK dengan CocoaPods.

Swift Package Manager

Consumer SDK dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda telah menghapus dependensi Consumer 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-consumer-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".

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

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

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

  1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, and Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:

    • GoogleRidesharingConsumer.xcframework

  2. Dari direktori level teratas project Xcode, hapus paket GoogleRidesharingConsumer.

Menggunakan CocoaPods

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

    sudo gem install cocoapods

    Untuk mengetahui detail selengkapnya, lihat Panduan Memulai CocoaPods.

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

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

    2. Edit Podfile dan tambahkan dependensi Anda. Berikut adalah contoh yang mencakup 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 penginstalan pod: Perintah ini menginstal API yang ditentukan dalam Podfile, beserta dependensi yang mungkin dimiliki.

    pod install

  4. Buka project Anda di Xcode: Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Untuk membuka project nanti, gunakan file .xcworkspace.

Penginstalan manual

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

Sebelum mengikuti panduan ini, lakukan hal berikut:

  • Download XCFramework, paket biner yang Anda gunakan untuk menginstal Consumer SDK. Anda dapat menggunakan paket ini di beberapa platform, termasuk mesin yang menggunakan chipset M1.

  • Instal Maps SDK.

  1. Download biner dan resource SDK:

  2. Ekstrak file yang di-zip untuk mengakses XCFramework dan resource.

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

  4. Jika grup project Anda tidak berisi grup Frameworks, buat grup tersebut.

  5. Seret file gRPCCertificates.bundle yang didownload ke direktori level teratas project Xcode Anda. Jika diminta, pilih Salin item.

  6. Untuk menginstal Consumer SDK, tarik file GoogleRidesharingConsumer.xcframework ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Jika diminta, pilih Salin item.

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

  8. Pilih project Anda dari Project Navigator, lalu pilih target aplikasi Anda.

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

    • 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 project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Other Linker Flags, tambahkan -ObjC untuk debug dan rilis.

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

Memeriksa file Manifes Privasi Apple

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

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

Langkah berikutnya

Mengonfigurasi project Google Cloud Console