Xcode projesi oluşturma

Swift Package Manager

iOS için Yerler SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için iOS için mevcut Yerler SDK'sı bağımlılıkları 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-places-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.
4. Paket Ürünlerini Seçin penceresinde, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirttiğiniz ana hedefinize 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ü itibarıyla değişmiştir. GooglePlacesSwift'in eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir sürümünü güncelliyorsanız Xcode'un paket bağımlılıkları bölümünden kaldırın.

5. Yüklemenizin doğru olup olmadığını kontrol etmek için hedefinizin Genel bölmesine gidin. Yüklenen paketleri Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünde görebilirsiniz. Paketi ve sürümünü doğrulamak için Proje Gezgini'nin Paket Bağımlılıkları bölümünü de görüntüleyebilirsiniz. Xcode, GitHub sürümünü gösterir. Bu sürüm, GooglePlaces sürümüyle (ör. 9.2.0) eşleşir ancak GooglePlacesSwift sürümüyle (ör. 0.3.0) eşleşmez.

Mevcut bir projenin package değerini güncellemek için aşağıdaki adımları uygulayın:

1. Xcode'da "Dosya > Paketler > Son Paket Sürümlerine Güncelle"ye 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ü itibarıyla değişmiştir. GooglePlacesSwift'in eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir sürümünü güncelliyorsanız Xcode'un paket bağımlılıkları bölümünden kaldırın.

2. 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 Yerler 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ç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 Yerler Swift SDK'sını (Önizleme) içeren XCFramework'ların projenize nasıl manuel olarak ekleneceği ve Xcode'da derleme ayarlarınızın nasıl yapılandırılacağı gösterilmektedir. XCFramework, Apple silikonu kullanan makineler dahil olmak üzere birden fazla platformda kullanabileceğiniz ikili bir pakettir. iOS için Yerler SDK'sını, iOS için Yerler Swift SDK'sını (Önizleme) veya her ikisini de eklemeyi seçebilirsiniz.

1. Aşağıdaki SDK ikili ve kaynak dosyalarını indirin:
   • GooglePlaces
   • GooglePlacesResources
2. iOS için Yerler Swift SDK'sını (Önizleme) yüklüyorsanız aşağıdaki dosyaları yükleyin:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. XCFramework'a 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şturup iOS uygulaması şablonunu seçin.
5. Önceki sürümlerdeki Haritalar paketlerini projenizden kaldırın.
6. Genel sekmesini açın. Aşağıdaki XCFramework'u Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümündeki projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
   • GooglePlaces.xcframework
   iOS için Yerler Swift SDK'sını (Önizleme) yüklüyorsanız aşağıdaki XCFramework'u Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünden projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
   • GooglePlacesSwift.xcframework
7. İndirdiğiniz GooglePlacesResources dosyasından GooglePlaces.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.
   
   iOS için Yerler Swift SDK'sını (Önizleme) yüklüyorsanız indirdiğiniz GooglePlacesSwiftResources dosyasından GooglePlacesSwift.bundle dosyasını Xcode projenizin üst düzey dizinine kopyalayın. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'yı seçin.
8. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
9. Derleme Aşamaları sekmesini açın. Binariyi Kitaplıklarla 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 Derleme Ayarları sekmesini açın. Bağlantı - Genel -> Diğer Bağlantı İşaretleri bölümünde, "Hata Ayıklama" ve "Sürüm"e -ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.

CocoaPods

iOS için Yerler SDK'sı ve iOS için Yerler Swift SDK'sı (Önizleme), CocoaPod kapsülleri, GooglePlaces ve GooglePlacesSwift 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'u kullanmaya başlama kılavuzuna bakın.

sudo gem install cocoapods

SDK'ları ve bağımlılarını yüklemek için bir Podfile oluşturun:

1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirme konusunda yeniyseniz yeni bir proje oluşturup iOS uygulaması şablonunu seçin.
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. Uygulama hedefinizin adını ve GooglePlaces ile GooglePlacesSwift kapsüllerinin adlarını belirten bir örnek aşağıda verilmiştir:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.0'
   end

   Her zaman en son sürümü kullandığınızdan emin olmak için yeni bir sürüm olup olmadığını tespit etmek üzere pod outdated'ı düzenli olarak çalıştırın.
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 sahip olabilecekleri 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.

Swift

API anahtarınızı AppDelegate.swift'nize aşağıdaki gibi ekleyin:

• Aşağıdaki içe aktarma beyanını ekleyin:

  import GooglePlaces

• YOUR_API_KEY ifadesini API anahtarınızla değiştirerek application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

API anahtarınızı AppDelegate.m'nize aşağıdaki gibi ekleyin:

• Aşağıdaki içe aktarma beyanını ekleyin:

  @import GooglePlaces;

• YOUR_API_KEY ifadesini API anahtarınızla değiştirerek application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

API anahtarınızı AppDelegate.swift'nize aşağıdaki gibi ekleyin:

• Aşağıdaki içe aktarma beyanını ekleyin:

  import GooglePlacesSwift

• YOUR_API_KEY ifadesini API anahtarınızla değiştirerek application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin:

  PlacesClient.provideAPIKey("YOUR_API_KEY")