Xcode projesi oluşturma

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

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 şunları indirip yüklemeniz gerekir:

  • Xcode 15.0 sürümü veya sonraki sürümler

2. Adım: Xcode projesini oluşturun ve Navigasyon SDK'sını yükleyin

Swift Package Manager

Navigasyon SDK'sı, 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 Dosya > Paket Bağımlılıkları Ekle'ye gidin.
  2. URL olarak https://github.com/googlemaps/ios-navigation-sdk adresini girin, paketi almak 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üme dayalı 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 değerini güncellemek için aşağıdaki adımları uygulayın:

  1. Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayın.

Manuel olarak yüklenen mevcut iOS için Navigasyon SDK'sını kaldırmak isterseniz şu adımları uygulayın:
  1. Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i 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'ların projenize manuel olarak nasıl ekleneceği ve Xcode'da derleme ayarlarınızın nasıl yapılandırılacağı 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'larını yüklemek üzere 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'te yeniyseniz 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 Navigasyon SDK'larını yüklemek için aşağıdaki XCFrameworks'u Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümündeki projenize sürükleyin (istemde bulunulduğunda Gerekirse öğeleri kopyala'yı seçin):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. İndirdiğiniz GoogleMapsResources klasöründeki GoogleMaps.bundle dosyasını Xcode projenizin üst düzey dizine sürükleyin. İstendiğinde Copy items if needed (Gerekirse öğeleri kopyala) seçeneğinin seçili olduğundan emin olun.
  6. İndirdiğiniz GoogleNavigationResources klasöründeki GoogleNavigation.bundle dosyasını Xcode projenizin üst düzey dizinine sürükleyin. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'nın seçildiğinden emin olun.
  7. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
  8. Derleme Aşamaları sekmesini açın ve Binariyi Kitaplıklarla Bağla 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 hedefine gidin, Özellikler sekmesini seçin, Arka Plan Modları'nı etkinleştirin ve aşağıdaki modları etkinleştirin:
    • Ses, AirPlay ve Pencere İçinde Pencere
    • Konum güncellemeleri
  10. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlantı Oluşturucu İşaretleri bölümünde, hem hata ayıklama hem de sürüm için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.
  11. Info.plist dosyasını açıp aşağıdaki anahtar/değer çiftlerini ekleyin:
    • Anahtar: NSLocationWhenInUseUsageDescription (Gizlilik - Kullanımdayken Konum Kullanım Açıklaması)
      Değer: "Bu uygulamanın, adım adım yol tarifi için konumunuzu kullanması gerekir."
    • Anahtar: NSLocationAlwaysAndWhenInUseUsageDescription (Gizlilik - Her Zaman ve Kullanımdayken Konum Kullanım Açıklaması)
      Değer: "Bu uygulamanın, adım adım yol tarifi için konumunuzu kullanması gerekir."

CocoaPods

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

CocoaPods aracı yoksa terminalde aşağıdaki komutu çalıştırarak macOS'e yükleyin. Ayrıntılar için CocoaPods Başlangıç Kılavuzu'na bakın.

sudo gem install cocoapods

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

  1. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başladıysanı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. Grup tanımlayıcısı alanının değerini kaydedin. Aşağıda API anahtarınızı kısıtlamak için bu değeri kullanabilirsiniz.
      3. Projenin Arayüzü'nü Görsel Taslak 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ı sürümleriyle birlikte ekleyin. iOS için Navigasyon SDK'sı için ihtiyacınız olan bağımlılığı içeren bir örnek aşağıda verilmiştir: # Cocoapods yükleme referansı # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '9.2.0'
end
    Daha yeni sürümleri tespit etmek için pod outdated'ı düzenli olarak çalıştırın. Gerekirse en son sürüme yükseltin.
  4. Podfile dosyasını kaydedin.

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

    cd <path-to-project>

  6. pod install komutunu çalıştırın. Bu işlem, Podfile dosyasında belirtilen API'leri ve tüm bağımlılıklarını 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çın ve 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 son sürüme günceller.

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'nize 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'nize 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 gizliliği ayrıntılarını zorunlu kılar. 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 dahildir. Gizlilik manifesti dosyasının eklendiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden bir gizlilik raporu oluşturun.

Mobility Services 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. Navigasyon SDK'sı uygulamanıza nasıl işlem kimliği ekleyeceğinizi öğrenmek için Hizmet kullanımınızı Mobilite işlemleriyle ilişkilendirme başlıklı makaleyi inceleyin.

Sırada ne var?

Artık bir API anahtarınız ve Xcode projeniz olduğu için uygulama oluşturup çalıştırabilirsiniz. iOS için Navigasyon SDK'sı, başlangıçta size yardımcı olabilecek eğitici içerikler sunar. Daha fazla bilgi için: