Xcode projesi oluşturma

Swift Package Manager

Navigation SDK, Swift Package Manager aracılığıyla 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 açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
2. URL olarak https://github.com/googlemaps/ios-navigation-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm tabanlı seçeneklerden birine ayarlayın. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayın.
4. Paket Ürünleri Seçin penceresinde, GoogleNavigation öğesinin belirlenen main hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra "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üklenen paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Proje Gezgini"nin "Paket Bağımlılıkları" bölümünü de inceleyebilirsiniz.

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

1. Xcode'da File > Packages > Update To Latest Package Versions (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine 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 Navigation SDK 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ı için XCFramework'leri yüklemek üzere şu adımları uygulayın:

1. Aşağıdaki SDK ikili dosyaları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'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.
3. Projedeki mevcut tüm Haritalar, Gezinme ve Yerler referanslarını kaldırın.
4. Hem Haritalar hem de Navigation 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ündeki projenize sürükleyin (istendiğinde Copy items if needed'ı (Gerekirse öğeleri kopyala) seçin):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. İndirdiğiniz GoogleMapsResources'tan GoogleMaps.bundle dosyasını Xcode projenizin en ü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 seçin ve uygulamanızın hedefini belirleyin.
8. Build Phases (Derleme Aşamaları) sekmesini açın ve Link Binary with Libraries (Kitaplıklarla İkili Bağlantı) 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ı) etkinleştirin 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ın) 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 navigasyon için konumunuzu kullanmak üzere izne ihtiyaç duyuyor."
    • Anahtar: NSLocationAlwaysAndWhenInUseUsageDescription (Gizlilik - Konum Her Zaman ve Kullanım Sırasında Kullanım Açıklaması)
      Değer: "Bu uygulama, adım adım navigasyon için konumunuzu kullanmak üzere izin gerektirir."

Swift

API anahtarınızı AppDelegate.swift öğenize 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")

Objective-C

API anahtarınızı AppDelegate.m öğenize 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"];