Xcode projesi oluşturma

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

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 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 dosyanızı 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 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 ürününün belirlediğiniz main hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  5. Yüklemenizi doğrulamak için hedefinizin General (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 Project Navigator'ın Package Dependencies 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) bölümünü 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 program paketidir.

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'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması ş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 projenizin Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümüne 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'dan GoogleNavigation.bundle öğesini Xcode projenizin ü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 (İkili Dosyayı Kitaplıklara Bağla) bölümüne 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 Derleme Ayarları çubuğundaki filtreyi Temel'den Tümü'ne değiştirin.
  11. Info.plist dosyasını açın ve aşağıdaki anahtar/değer çiftlerini ekleyin:
    • Anahtar: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Değer: "Bu uygulamanın, adım adım rota için konumunuzu kullanma iznine ihtiyacı var."
    • Anahtar: NSLocationAlwaysAndWhenInUseUsageDescription (Gizlilik - Konum Her Zaman ve Kullanım Sırasında Kullanım Açıklaması)
      Değer: "Bu uygulamanın, adım adım rota için konumunuzu kullanma iznine ihtiyacı var."

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

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 manifest dosyası, SDK'nın kaynak paketine dahildir. 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ı Mobility 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ı, kullanmaya başlamanıza yardımcı olacak eğitimler sunar. Daha fazla bilgi için: