Bu bölümde, sisteminizin minimum koşulları karşılayıp karşılamadığını nasıl doğrulayacağınız, Workspace grubunuzu nasıl oluşturacağınız ve Sürücü SDK'sını nasıl edineceğiniz açıklanmaktadır.
Başlamadan önce
iOS için Sürücü SDK'sı, uygulamanızın aşağıdaki ölçütleri karşılamasını gerektirir:
- Gezinme SDK'sına sahip olmalısınız.
- Google Cloud Console'da iOS için Haritalar SDK'sını etkinleştirin ve bir API anahtarı alın.
Minimum sistem gereksinimlerini kontrol edin
Sürümüne ilişkin minimum gereksinimleri öğrenmek için sürüm notlarına bakın Kullandığınız sürücü SDK'sı. Sürüm notlarına bakın.
- Mobil cihazda iOS 14 veya sonraki bir sürüm yüklü olmalıdır.
- Apple Xcode sürüm 15 veya sonraki bir sürüme sahip olmanız gerekir.
Google Workspace'inize erişin
Google Workspace müşterisiyseniz aşağıdaki adımları uygulayın:
Workspace grubu oluşturun. Daha fazla bilgi için Çalışma Alanı Grubu başlıklı makaleyi inceleyin.
Örneğin, en iyi uygulama olarak grubunuza bir ad verin İlk katılım sırasında
google-maps-platform-sdk-users@workspacedomain.com
.Workspace grubunuzu doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklemek için adı Google'a sağlayın.
Erişim gerektiren kullanıcı e-postalarının ve hizmet hesabı e-postalarının, var.
Kuruluşunuz Workspace Grupları oluşturamıyorsa Google'a bir liste gönderin Bu yapılara erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının sayısı.
Google Cloud SDK ile oturum açma
Yerel geliştirme için Google Cloud SDK ile oturum açın. Ayrıntılar için gcloud KSA'yı yükleme başlıklı makaleye göz atın.
Aşağıdaki örneklerde, Cloud SDK'sı ile nasıl oturum açılacağı gösterilmektedir.
gcloud
gcloud auth login
Workspace Grubu'nun üyesi olan bir e-posta adresi kullanmanız gerekir.
Otomasyon ana makinelerinizi ayarlayın
Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi kurun. Google API'leri ve hizmetleri Ayrıntılar için hizmet hesabı bölümüne göz atın. başlıklı makaleyi inceleyin.
İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılama. Daha fazla bilgi için otomatik kimlik bilgisi algılama başlıklı makaleye bakın.
Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sistemini açıp GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde kullanın. Daha fazla ayrıntı için bkz. GOOGLE_APPLICATION_CREDENTIALS.
Kimlik bilgileriyle ilişkili hizmet hesabı e-postası, Workspace grubunun üyesi olmalıdır.
Sürücü SDK'sını edinme
Sürücü SDK'sını yükleyin ve yapılandırın.
CocoaPods
CocoaPods aracını yükleme: Bir terminal penceresi açın ve aşağıdaki komutu çalıştırın komutuna ekleyin.
sudo gem install cocoapods
Daha ayrıntılı bilgi için CocoaPods Başlangıç kılavuzuna bakın.
Sürücü SDK'sı için bir Podfile oluşturun: Yüklemek için Podfile ve bağımlılıklarını anlatacağım.
Proje dizininizde
Podfile
adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılarını tanımlar.Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Burada, size ne kadar şu bağımlılıkları içerir:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Bağımlılık olarak Driver SDK'sı:
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
Podfile'i kaydetme: Terminali açıp Podfile'in bulunduğu klasöre gidin:
cd <path-to-project>
Kapsül yükleme komutunu çalıştır: Bu komut, API'leri yükler ve bağımlılıkları ile birlikte Podfile dosyasında belirtilir.
pod install
Projenizi Xcode'da açma: Xcode'u kapatıp açın Xcode'u başlatmak için projenizin .xcworkspace dosyasını (çift tıklayın). Açmak için daha sonra .xcworkspace dosyasını kullanın.
Swift Paket Yöneticisi
Sürücü SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Driver SDK bağımlılıklarını kaldırın.
SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:
-
Xcode
project
veyaworkspace
dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin. - URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
-
Belirli bir
version
yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Paket Ürünlerini Seçin penceresinde,
GoogleRidesharingDriver
öğesinin şuraya ekleneceğini doğrulayın: belirlediğinizmain
hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Yüklemenizi doğrulamak için hedefinizin
General
bölmesine gidin. Yüklenen paketleri Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünde görebilirsiniz. Paketi ve sürümünü doğrulamak için "Proje Gezgini"nin "Paket Bağımlılıkları" bölümünü de görüntüleyebilirsiniz.
Mevcut bir projenin package
öğesini güncellemek için şu adımları izleyin:
- Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
Yüklü mevcut Driver SDK'sını kaldırmak için manuel olarak yüklemek istemiyorsanız aşağıdaki adımları uygulayın:
Xcode proje yapılandırma ayarlarınızdan Frameworks, Kitaplıklar ve Yerleştirilmiş İçerikler. Kaldırmak için eksi işaretini
(-)
kullanın. şu çerçeveyi kullanabilirsiniz:GoogleRidesharingDriver.xcframework
Xcode projenizin üst düzey dizininden şunu kaldırın:
GoogleRidesharingDriver
paketi.
Manuel yükleme
Bu kılavuzda, sürücü SDK'sını içeren XCFramework'i projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir.
Bu kılavuza başvurmadan önce aşağıdakileri yapın:
"XCFramework" ikili programını indirin. Sürücü SDK'sı. Bu paketi, şunlar dahil birden fazla platformda kullanabilirsiniz: Apple Silicon kullanan makineleri
Navigasyon SDK'sını yükleyin.
Sürücü SDK'sını manuel olarak yüklemek için aşağıdaki adımları uygulayın:
SDK ikili programını ve kaynaklarını indirin:
XCFramework ve kaynaklara erişmek için sıkıştırılmış dosyaları açın.
Xcode'u başlatın ve mevcut bir projeyi açın veya proje oluşturun. Eğer yenisini kullanıyorsanız yeni proje oluşturun ve iOS Uygulama şablonunu seçin.
Proje grubunuzda Çerçeveler grubu yoksa oluşturun.
Sürücü SDK'sını yüklemek için
GoogleRidesharingDriver.xcframework
dosyasını Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler. İstenirse, Öğeleri kopyalama.İndirilen
GoogleRidesharingDriver.bundle
öğesini üst düzeye sürükleyin Xcode projenizin dizinini oluşturur. İstenirse Öğeleri kopyala'yı seçin.Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
Derleme Aşamaları sekmesini açın ve İkili Program ile Kitaplıkları Bağla bölümünde mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları kullanın:
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
Belirli bir hedef yerine projenizi seçin ve Derlemeyi Ayarlar sekmesi. Diğer Bağlayıcı İşaretleri bölümünde şunun için
-ObjC
ekleyin: hata ayıklamak ve yayınlamaktır.Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.
Apple Gizlilik Manifest Dosyasını İnceleme
Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.
Apple Gizlilik Manifest dosyası, SDK'nın kaynak paketinde yer almaktadır. Gizlilik manifesti dosyasının eklendiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden bir gizlilik raporu oluşturun.