Xcode projesi oluşturma

Faturalandırmayı etkinleştirip API anahtarı oluşturduktan sonra, uygulamanızı geliştirmek için kullandığınız Xcode projesini ayarlamaya hazırsınız.

Her sürüm için sürüm notları mevcuttur.

1. adım: Gerekli yazılımı yükleyin

iOS için Navigasyon SDK'sını kullanarak proje oluşturmak istiyorsanız aşağıdakileri indirip yüklemeniz gerekir:

  • Xcode 26.0 veya sonraki sürümler

2. adım: Xcode projesini oluşturun ve Navigation SDK'yı yükleyin

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.

Manuel olarak yüklenen mevcut iOS için Navigasyon SDK'sını kaldırmak için aşağıdaki adımları uygulayı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:
  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."

3. adım: API anahtarınızı projeye ekleyin

Aşağıdaki örneklerde, API anahtarının Xcode'da projenize nasıl ekleneceği gösterilmektedir:

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"];

4. adım (isteğe bağlı): Apple gizlilik manifesti dosyasını inceleyin

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 Uygulama Mağazası Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple Gizlilik Manifesti dosyası, SDK'nın kaynak paketine dahil edilir. Gizlilik Manifest Dosyası'nın dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Mobility Services müşterisiyseniz

Mobility Services müşterisiyseniz faturalandırma hakkında bilgi edinmek için Mobility belgelerine bakın. İşlemleri kaydetme hakkında daha fazla bilgi için Faturalandırma ayarlarını yapma başlıklı makaleyi inceleyin. İşlem kimliklerini Navigasyon SDK'sı uygulamanıza nasıl ekleyeceğinizi öğrenmek için Hizmet kullanımınızı Mobilite işlemleriyle ilişkilendirme başlıklı makaleyi inceleyin.

Sırada ne var?

API anahtarınız ve Xcode projeniz olduğuna göre artık uygulama oluşturup çalıştırabilirsiniz. iOS için Navigasyon SDK'sı, başlamanıza yardımcı olabilecek eğitimler sunar. Daha fazla bilgi için: