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

1. Aşağıdaki SDK ikili ve kaynak dosyalarını indirin:
   • GooglePlaces
   • GooglePlacesResources
2. iOS için Yerler Swift SDK'sını yüklüyorsanız aşağıdaki dosyaları yükleyin:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
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 (Framework'ler, 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) alanlarına -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.

CocoaPods

iOS için Yerler SDK'sı ve iOS için Yerler Swift SDK'sı, CocoaPod pod'ları GooglePlaces ve GooglePlacesSwift 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

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

1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başladıysanız yeni bir proje oluşturun ve iOS App template'i (iOS uygulama şablonu) 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ınızı sürümleriyle birlikte ekleyin. Uygulama hedef adınızı ve GooglePlaces ile GooglePlacesSwift pod'larının adlarını belirten bir örneği aşağıda görebilirsiniz:

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

   Her zaman en son sürümü kullandığınızdan emin olmak için pod outdated komutunu düzenli olarak çalıştırarak yeni bir sürümün ne zaman yayınlandığını tespit edin.
4. Podfile öğesini kaydedin.

5. Bir terminal açın ve Podfile 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 varsa 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 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.

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"];