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

  • Xcode 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 Yerler SDK'sı for iOS 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 açın project veya workspace, 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 çekmek için Enter tuşuna basın ve "Add Package" (Paket Ekle) seçeneğini 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.
  4. Paket Ürünleri Seçin penceresinde, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirlenen ana hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

    Google Places Swift'i kullanımdan kaldı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 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 Proje Gezgini'nin Paket Bağımlılıkları bölümünü de inceleyebilirsiniz.

Mevcut bir projenin package bölümünü 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) seçeneğine gidin.

    Google Places Swift'i kullanımdan kaldı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 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 Yerler 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ç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ını 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 silikonu kullanan makineler de dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili pakettir. iOS için Yerler SDK'sını, iOS için Yerler Swift SDK'sını veya her ikisini de ekleyebilirsiniz.

  1. Aşağıdaki SDK ikili 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ı çıkarın.
  4. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS geliştirmeye yeni başladıysanız yeni bir proje oluşturun ve iOS App template'i (iOS uygulama şablonu) 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 altında projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
    • GooglePlacesSwift.xcframework
  7. İndirdiğiniz GooglePlacesResources'taki GooglePlaces.bundle dosyasını Xcode projenizin en üst düzey dizinine kopyalayı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'taki GooglePlacesSwift.bundle dosyasını Xcode projenizin en ü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 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ın) seçeneklerine -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.

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.

GooglePlacesSwift

API anahtarınızı AppDelegate.swift öğenize aşağıdaki şekilde ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin: 
    import GooglePlacesSwift
  • application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin. 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 öğenize aşağıdaki şekilde ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin: 
    import GooglePlaces
  • application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin. 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 öğenize aşağıdaki şekilde ekleyin:

  • Aşağıdaki içe aktarma ifadesini ekleyin: 
    @import GooglePlaces;
  • application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin. 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 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 Manifest 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.

Sonraki adımlar