Xcode projesi oluşturma

Faturalandırmayı etkinleştirip bir 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 Navigation SDK'sını kullanarak proje oluşturmak için şunları indirip yüklemeniz gerekir:

  • Xcode 16.0 veya sonraki sürümler

2. adım: Xcode projesini oluşturun ve Navigation SDK'sını 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'unuzu 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.

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

  1. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

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

  1. Aşağıdaki SDK ikili dosyaları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 Uygulaması şablonunu seçin.
  3. Projedeki mevcut tüm Haritalar, Navigasyon 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 dosyasını 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
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • 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 uygulamanın adım adım navigasyon için konumunuzu kullanma izni gerekir."
    • 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 izne ihtiyaç duyuyor."

CocoaPods

iOS için Navigasyon SDK'sı, CocoaPods pod'u olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projeleri için açık kaynaklı bir bağımlılık yöneticisidir.

CocoaPods aracınız yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin. Ayrıntılar için CocoaPods'u kullanmaya başlama kılavuzu'na bakın.

sudo gem install cocoapods

iOS için Navigasyon SDK'sı için bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için kullanın:

  1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başlıyorsanız:
    1. Yeni bir proje oluşturun.
    2. iOS > Uygulama şablonunu seçin.
    3. Proje seçenekleri ekranında:
      1. Proje Adı'nı girin.
      2. Paket tanımlayıcısı alanının değerini kaydedin. Bu değeri kullanarak API anahtarınızı aşağıda kısıtlayabilirsiniz.
      3. Proje Arayüzü'nü Senaryo Panosu olarak ayarlayın.
      4. Dil'i Swift veya Objective-C olarak ayarlayın.
  2. Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.
  3. Podfile dosyasını düzenleyin ve bağımlılıklarınızı sürümleriyle birlikte ekleyin. Aşağıda, iOS için Navigasyon SDK'sı için ihtiyacınız olan bağımlılığı içeren bir örnek verilmiştir: # Cocoapods install reference # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.1.0'
end
    Daha yeni sürümleri tespit etmek için pod outdated komutunu düzenli olarak çalıştırdığınızdan emin olun. Gerekirse en son sürüme yükseltin.
  4. Podfile öğesini kaydedin.

  5. Bir terminal açın ve Podfile dosyasını içeren dizine gidin:

    cd <path-to-project>

  6. pod install komutunu çalıştırın. Bu işlem, Podfile içinde belirtilen API'leri ve bağımlılıkları yükler.

    pod install

  7. Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

Mevcut bir projenin API'sini güncellemek için aşağıdaki adımları uygulayın:

  1. Bir terminal açıp Podfile dosyasını içeren proje dizinine gidin.
  2. pod update komutunu çalıştırın. Bu işlem, Podfile içinde belirtilen tüm API'leri en yeni sürüme günceller.

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

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

Swift

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

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 gizliliği ayrıntıları ister. Güncellemeler ve daha fazla bilgi için Apple App Store 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 arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Mobilite Hizmetleri müşterisiyseniz

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

Sırada ne var?

Artık bir API anahtarınız ve Xcode projeniz olduğuna göre uygulamalar 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: