Mendapatkan Driver SDK

Bagian ini menjelaskan cara memverifikasi bahwa sistem Anda memenuhi persyaratan minimum, menyiapkan Grup Workspace, dan mendapatkan Driver SDK.

Sebelum memulai

Driver SDK for iOS mengharuskan aplikasi Anda memenuhi kriteria berikut:

• Memiliki Navigation SDK.
• Aktifkan Maps SDK for iOS di konsol Google Cloud Anda dan dapatkan kunci API.

Periksa persyaratan sistem minimum

Periksa catatan rilis untuk mengetahui persyaratan minimum versi Driver 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 akses ke Google Workspace Anda

Jika Anda adalah pelanggan Google Workspace, lakukan langkah-langkah berikut:

1. Buat Grup Workspace. Untuk mengetahui informasi selengkapnya, lihat Grup Workspace.

   Misalnya, sebagai praktik terbaik, beri nama grup Anda [e-mail] selama proses orientasi.

2. Berikan nama tersebut kepada Google untuk menambahkan Grup Workspace Anda ke daftar yang diizinkan yang memberikan akses ke repositori CocoaPods yang benar.

3. Pastikan email pengguna dan email akun layanan yang memerlukan akses disertakan dalam daftar ini.

Jika organisasi Anda tidak dapat membuat Grup Workspace, kirimkan daftar email pengguna dan akun layanan yang memerlukan akses ke artefak ini kepada Google.

Catatan: Grup Workspace tidak sama dengan Google Grup, yang diakhiri dengan @googlegroups.com. Hanya Grup Workspace yang didukung.

Login dengan Cloud SDK

Untuk pengembangan lokal, login dengan Cloud SDK. Untuk mengetahui detailnya, lihat Menginstal gcloud CLI.

Contoh berikut menunjukkan cara login dengan Cloud SDK.

gcloud

gcloud auth login

Anda harus menggunakan email yang merupakan anggota Grup Workspace.

Menyiapkan host otomatisasi Anda

Untuk sistem build atau integrasi berkelanjutan, siapkan host otomatisasi Anda berdasarkan daftar metode yang disediakan untuk menggunakan akun layanan guna melakukan autentikasi ke Google API dan layanan Google. Untuk mengetahui detailnya, lihat bagian akun layanan di halaman Metode autentikasi di Google.

• Jika proses Anda berjalan di dalam lingkungan Google Cloud, gunakan deteksi kredensial otomatis. Untuk mengetahui informasi selengkapnya, lihat deteksi kredensial otomatis.

• Jika tidak, simpan file kunci akun layanan di lokasi yang aman di sistem file host dan tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS dengan tepat. Untuk mengetahui detail selengkapnya, lihat GOOGLE_APPLICATION_CREDENTIALS.

Email akun layanan yang terkait dengan kredensial harus menjadi anggota Grup Workspace.

Mendapatkan Driver SDK

Instal dan konfigurasi Driver SDK.

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 Driver SDK: Anda menggunakan Podfile untuk menginstal API dan dependensinya.

   1. Buat file bernama Podfile dalam direktori project Anda. File ini menentukan 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 'GoogleRidesharingDriver'
      end
      

      Berikut adalah contoh yang menyertakan pod Alpha dan Beta untuk Driver SDK sebagai dependensi:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

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

      cd <path-to-project>
      

3. Jalankan perintah penginstalan pod: Perintah ini akan 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.

   Catatan: Jalankan pod outdated secara berkala untuk mendeteksi jika ada versi SDK yang lebih baru. Untuk mengetahui informasi selengkapnya, lihat Versi Driver SDK for iOS.

Swift Package Manager

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

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

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-driver-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.

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

Untuk menghapus Driver 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:

   • GoogleRidesharingDriver.xcframework

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

Penginstalan manual

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

Perhatian: Sebagai praktik terbaik, gunakan Cocoapods untuk menginstal Driver SDK jika memungkinkan.

Sebelum mengikuti panduan ini, lakukan hal berikut:

• Download XCFramework, paket biner yang Anda gunakan untuk menginstal Driver SDK. Anda dapat menggunakan paket ini di beberapa platform, termasuk komputer yang menggunakan silikon Apple

• Instal Navigation SDK.

Lakukan langkah-langkah berikut untuk menginstal Driver SDK secara manual:

1. Download biner dan resource SDK:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

3. Mulai Xcode dan buka project yang ada 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. Untuk menginstal Driver SDK, tarik file GoogleRidesharingDriver.xcframework ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Jika diminta, pilih Salin item.

6. Tarik GoogleRidesharingDriver.bundle yang didownload ke direktori level teratas project Xcode Anda. Jika diminta, pilih Salin item.

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

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

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. 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 Konsol Google Cloud