Xcode projesi oluşturma

Swift Package Manager

Navigation SDK, Swift Package Manager üzerinden yüklenebilir. SDK'yı eklemek için mevcut Navigasyon SDK'sı bağımlılıklarını kaldırdığınızdan emin olun.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

1. Xcode project veya workspace dosyanızı açın, ardından File > Add Package Dependencies (Dosya > Paket Bağımlılıkları Ekle) bölümüne gidin.
2. URL olarak https://github.com/googlemaps/ios-navigation-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüme dayalı seçeneklerden birine ayarlayın. Yeni projeler için en yeni sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
4. Paket Ürünleri Seçin penceresinde, GoogleNavigation öğesinin belirlenen main hedefinize ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
5. Yüklemenizi doğrulamak için hedefinizin Genel bölmesine gidin. Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın (Proje Gezgini) "Package Dependencies" (Paket Bağımlılıkları) bölümünü de görüntüleyebilirsiniz.

Mevcut bir projenin package bilgisini güncellemek için aşağıdaki adımları uygulayın:

1. Xcode'da File (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.
2. Yüklemenizi doğrulamak için Proje Gezgini'nin Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

1. Xcode proje yapılandırma ayarlarınızda Frameworks, Libraries, and Embedded Content'ı (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Xcode projenizin üst düzey dizininden GoogleMaps paketini kaldırın.

Manuel yükleme

Bu kılavuzda, iOS için Navigasyon SDK'sını ve iOS için Haritalar SDK'sını içeren XCFramework'leri projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir. XCFramework, M1 yonga setini kullanan makineler de dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili pakettir.

iOS için Navigasyon SDK'sı ve iOS için Haritalar SDK'sı XCFramework'lerini yüklemek üzere aşağıdaki adımları uygulayın:

1. Aşağıdaki SDK ikili programlarını ve kaynak dosyalarını indirin:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS'i yeni kullanmaya başladıysanız yeni bir proje oluşturun ve iOS uygulama şablonunu seçin.
3. Mevcut tüm Haritalar, Gezinme ve Yerler referanslarını projeden kaldırın.
4. Hem Haritalar hem de Navigasyon SDK'larını yüklemek için aşağıdaki XCFramework'leri Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünden projenize sürükleyin (istendiğinde Copy items if needed [Gerekirse öğeleri kopyala] seçeneğini belirleyin):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. İndirdiğiniz GoogleMapsResources'dan GoogleMaps.bundle öğesini Xcode projenizin üst düzey dizinine sürükleyin. İstendiğinde Gerektiğinde öğeleri kopyala'nın seçili olduğundan emin olun.
6. İndirdiğiniz GoogleNavigationResources'tan GoogleNavigation.bundle öğesini Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'nın seçili olduğundan emin olun.
7. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
8. Build Phases (Derleme Aşamaları) sekmesini açın ve Link Binary with Libraries (İkiliyi Kitaplıklarla Bağla) bölümünde aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. Uygulamanızın hedefinde Capabilities (Özellikler) sekmesini seçin, Background Modes'u (Arka Plan Modları) açın ve aşağıdaki modları etkinleştirin:
   • Ses, AirPlay ve pencere içinde pencere
   • Konum güncellemeleri
10. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümünde, hem debug (hata ayıklama) hem de release (yayınlama) için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa Build Settings (Derleme Ayarları) çubuğundaki filtreyi Basic (Temel) yerine All (Tümü) olarak değiştirin.
11. Info.plist dosyasını açın ve aşağıdaki anahtar/değer çiftlerini ekleyin:
    • Anahtar: NSLocationWhenInUseUsageDescription (Gizlilik - Kullanım Sırasında Konum Kullanımı Açıklaması)
      Değer: "Bu uygulama, adım adım rota için konumunuzu kullanma izni gerektiriyor."
    • Anahtar: NSLocationAlwaysAndWhenInUseUsageDescription (Gizlilik - Konum Her Zaman ve Kullanım Sırasında Kullanım Açıklaması)
      Değer: "Bu uygulama, adım adım rota için konumunuzu kullanma izni gerektiriyor."

Swift

API anahtarınızı AppDelegate.swift dosyanıza aşağıdaki gibi ekleyin:

1. Aşağıdaki içe aktarma ifadelerini ekleyin:

   import GoogleMaps
   import GoogleNavigation

2. application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

API anahtarınızı AppDelegate.m dosyasına aşağıdaki şekilde ekleyin:

1. Aşağıdaki içe aktarma ifadelerini ekleyin:

   @import GoogleMaps;
   @import GoogleNavigation;

2. application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];