Bagian ini menjelaskan cara memverifikasi bahwa sistem Anda memenuhi persyaratan minimum, siapkan Grup Workspace Anda, dan dapatkan 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 dan dapatkan kunci API.
Memeriksa persyaratan sistem minimum
Periksa catatan rilis untuk mengetahui persyaratan minimum untuk 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.
Dapatkan akses ke aplikasi Google Workspace
Jika Anda adalah pelanggan Google Workspace, lakukan langkah-langkah berikut:
Buat Grup Workspace. Untuk mengetahui informasi selengkapnya, lihat Grup Workspace.
Misalnya, sebagai praktik terbaik, beri nama grup Anda
google-maps-platform-sdk-users@workspacedomain.com
selama orientasi.Berikan nama kepada Google untuk menambahkan Grup Workspace Anda ke daftar yang diizinkan yang memberikan akses ke repositori CocoaPods yang benar.
Pastikan email pengguna dan email akun layanan yang memerlukan akses disertakan dalam daftar ini.
Jika organisasi Anda tidak dapat membuat Grup Workspace, kirim daftar ke Google email pengguna dan akun layanan yang membutuhkan akses ke artefak ini.
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
Untuk sistem build atau continuous integration, siapkan host otomatisasi berbasis dalam daftar metode yang disediakan untuk menggunakan akun layanan guna mengotentikasi ke Google API dan Layanan Google. Untuk mengetahui detailnya, lihat bagian akun layanan di halaman Authentication method 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 pada sistem file host dan menyetel GOOGLE_APPLICATION_CREDENTIALS variabel lingkungan dengan tepat. Untuk detail selengkapnya, lihat GOOGLE_APPLICATION_CREDENTIALS.
Email akun layanan yang terkait dengan kredensial harus merupakan anggota Grup Workspace.
Mendapatkan Driver SDK
Menginstal dan mengonfigurasi Driver SDK.
CocoaPods
Instal alat CocoaPods: Buka jendela terminal dan jalankan perintah berikut perintah.
sudo gem install cocoapods
Untuk detail selengkapnya, lihat Panduan Memulai CocoaPods.
Buat Podfile untuk Driver SDK: Anda menggunakan Podfile untuk menginstal API dan dependensinya.
Buat file bernama
Podfile
dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.Edit Podfile dan tambahkan dependensi Anda. Berikut adalah contoh 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 Alfa 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
Simpan Podfile: Buka terminal dan buka folder dengan Podfile:
cd <path-to-project>
Jalankan perintah pod install: Perintah ini akan menginstal API yang ditentukan dalam Podfile, beserta dependensi yang mungkin dimilikinya.
pod install
Buka project Anda di Xcode: Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace proyek Anda untuk meluncurkan Xcode. Untuk membuka proyek ini nanti, gunakan file {i> .xcworkspace<i}.
Swift Package Manager
Driver SDK dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda memiliki menghapus semua dependensi Driver SDK yang ada.
Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:
-
Buka
project
atauworkspace
Xcode, lalu buka File > Menambahkan Dependensi Paket. - Masukkan https://github.com/googlemaps/ios-driver-sdk sebagai URL, tekan Enter untuk menarik paket, dan klik "{i>Add Package<i}".
-
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". -
Dari jendela Choose Package Products, pastikan
GoogleRidesharingDriver
akan ditambahkan ke targetmain
yang Anda tetapkan. Setelah selesai, klik "Add Package". -
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:
- Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
- Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.
Untuk menghapus Driver SDK yang sudah terinstal secara manual, ikuti langkah-langkah berikut:
Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Konten Tersemat. Gunakan tanda minus
(-)
untuk menghapus kerangka kerja berikut ini:GoogleRidesharingDriver.xcframework
Dari direktori level teratas project Xcode Anda, hapus Paket
GoogleRidesharingDriver
.
Penginstalan manual
Panduan ini menunjukkan cara menambahkan XCFramework yang berisi Driver SDK ke project Anda dan konfigurasikan setelan build di Xcode.
Sebelum mengikuti panduan ini, lakukan hal berikut:
Unduh XCFramework, paket biner yang Anda gunakan untuk menginstal Driver SDK. Anda dapat menggunakan paket ini di beberapa platform, termasuk komputer yang menggunakan Apple silicon
Instal Navigation SDK.
Lakukan langkah-langkah berikut untuk menginstal Driver SDK secara manual:
Download resource dan biner SDK:
Ekstrak file zip untuk mengakses XCFramework dan resource.
Mulai Xcode dan buka yang sudah ada atau buat project. Jika Anda baru untuk iOS, buat project baru, lalu pilih template iOS App.
Jika grup proyek Anda tidak berisi grup Framework, buat grup tersebut.
Untuk menginstal Driver SDK, tarik
GoogleRidesharingDriver.xcframework
ke project Anda di bagian Framework, Library, dan Konten Tersemat. Jika diminta, pilih Menyalin item.Tarik
GoogleRidesharingDriver.bundle
yang didownload ke level teratas project Xcode Anda. Jika diminta, pilih Salin item.Pilih proyek Anda dari Navigator Proyek, dan pilih target aplikasi Anda.
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
Pilih project Anda, bukan target tertentu, dan buka fungsi Build Setelan kami. Di bagian Other Linker Flags, tambahkan
-ObjC
untuk debug dan rilis.Jika setelan ini tidak terlihat, ubah di panel Build Settings dari Basic ke All.
Periksa 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.