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 Yerler SDK'sını kullanarak proje oluşturmak için gerekenler:

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

2. adım: Xcode projesini oluşturun ve iOS için Yerler SDK'sını yükleyin

Swift Package Manager

iOS için Yerler SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut iOS için Yerler 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-places-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, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirlediğiniz ana hedefe ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

    Google Places Swift'i, desteği sonlandırılan GitHub URL'sinden güncelliyorsanız

    Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si 0.3.0 sürümünden itibaren değişti. Eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir GooglePlacesSwift sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırı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 Package Dependencies 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 > Packages > Update To Latest Package Versions (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) bölümüne gidin.

    Google Places Swift'i, desteği sonlandırılan GitHub URL'sinden güncelliyorsanız

    Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si 0.3.0 sürümünden itibaren değişti. Eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir GooglePlacesSwift sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırın.

  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 Yerler 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) bölümünü bulun. Aşağıdaki çerçeveleri kaldırmak için eksi işaretini (-) kullanın:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. Xcode projenizin üst düzey dizininden GooglePlaces paketini kaldırın.

Manuel yükleme

Bu kılavuzda, iOS için Yerler SDK'sı ve iOS için Places Swift 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, Apple Silicon kullanan makineler de dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili program paketidir. iOS için Yerler SDK'sını, iOS için Yerler Swift SDK'sını veya her ikisini birden ekleyebilirsiniz.

  1. Aşağıdaki SDK ikili programını ve kaynak dosyalarını indirin:
  2. iOS için Places Swift SDK'sını yüklüyorsanız aşağıdaki dosyaları yükleyin:
  3. XCFramework'e ve kaynaklara erişmek için dosyaları ayıklayın.
  4. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS geliştirme konusunda yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.
  5. Önceki sürümlerdeki tüm Haritalar paketlerini projenizden kaldırın.
  6. Genel sekmesini açın. Aşağıdaki XCFramework'ü Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
    • GooglePlaces.xcframework
    Places Swift SDK'yı yüklüyorsanız aşağıdaki XCFramework'ü Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
    • GooglePlacesSwift.xcframework
  7. İndirdiğiniz GooglePlacesResources'tan GooglePlaces.bundle öğesini kopyalayıp Xcode projenizin üst düzey dizinine yapıştırın. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'yı seçtiğinizden emin olun.

    Places Swift SDK'yı yüklüyorsanız indirdiğiniz GooglePlacesSwiftResources'dan GooglePlacesSwift.bundle dosyasını Xcode projenizin üst düzey dizinine kopyalayın. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'yı seçtiğinizden emin olun.
  8. Proje Gezgini'nden projenizi seçin ve uygulamanızın hedefini belirleyin.
  9. Build Phases (Derleme Aşamaları) sekmesini açın. Link Binary with Libraries (İkili Dosyayı Kitaplıklara Bağla) bölümünde aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. Belirli bir hedef yerine projenizi seçin ve Build Settings (Derleme Ayarları) sekmesini açın. Linking - General -> Other Linker Flags (Bağlantı - Genel -> Diğer Bağlayıcı İşaretleri) bölümünde, "Debug" (Hata ayıklama) ve "Release" (Yayınlama) seçeneklerine -ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.

3. adım: API anahtarını uygulamanıza ekleyin

Aşağıdaki örneklerde YOUR_API_KEY kısmını API anahtarınızla değiştirin.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

API anahtarınızı AppDelegate.swift dosyanıza aşağıdaki gibi ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin:
    import GooglePlacesSwift
  • application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin ve YOUR_API_KEY kısmını API anahtarınızla değiştirin:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

API anahtarınızı AppDelegate.swift dosyanıza aşağıdaki gibi ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin:
    import GooglePlaces
  • application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin ve YOUR_API_KEY kısmını API anahtarınızla değiştirin:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

API anahtarınızı AppDelegate.m dosyanıza aşağıdaki gibi ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin:
    @import GooglePlaces;
  • application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin ve YOUR_API_KEY kısmını API anahtarınızla değiştirin:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

Apple, uygulama mağazasındaki uygulamalar için uygulama gizlilik 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 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.

Sonraki adımlar