Xcode projesi oluşturma

Swift Package Manager

iOS için Haritalar SDK'sı Swift Package Manager üzerinden yüklenebilir. SDK'yı eklemek için mevcut iOS için Haritalar 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 File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
2. URL olarak https://github.com/googlemaps/ios-maps-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.

Mevcut bir projenin package bölümünü güncellemek için aşağıdaki adımları uygulayın:

1. 9.0.0'dan önceki bir sürümden yükseltme yapıyorsanız yükseltme işleminden sonra şu bağımlılıkları kaldırmanız gerekir: GoogleMapsBase, GoogleMapsCore ve GoogleMapsM4B. GoogleMaps için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 sürüm notlarını inceleyin.

   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çeveyi kaldırmak için eksi işaretini(-) kullanın:

   • GoogleMapsBase (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
   • GoogleMapsCore (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
   • GoogleMapsM4B (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
2. Xcode'da "File > Packages > Update To Latest Package Versions" (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine gidin.
3. 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. Bu bölüme Proje Gezgini'nden erişebilirsiniz.

CocoaPods kullanılarak eklenen mevcut iOS için Haritalar SDK'sı bağımlılıklarını kaldırmak için aşağıdaki adımları uygulayın:

1. Xcode çalışma alanınızı kapatın. Terminali açıp aşağıdaki komutu çalıştırın:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Podfile, Podfile.resolved ve Xcode workspace'u CocoaPods dışında bir amaçla kullanmıyorsanız bunları kaldırı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çeveyi kaldırmak için eksi işaretini(-) kullanın:
   • GoogleMaps
   • GoogleMapsBase (Yalnızca 9.2.0'dan önceki sürümlerdeki kurulumlar için)
   • GoogleMapsCore (Yalnızca 9.2.0'dan önceki sürümlerdeki kurulumlar için)
   • GoogleMapsM4B (Yalnızca 9.0.0 sürümünden önceki yüklemeler için)
2. Xcode projenizin üst düzey dizininden GoogleMaps paketini kaldırın.

Manuel yükleme

Bu kılavuzda, iOS için Haritalar 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 çipini kullanan makineler de dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili pakettir.

1. Aşağıdaki SDK ikili dosyalarını ve kaynak dosyalarını indirin:
   • GoogleMaps
   • GoogleMapsResources
2. XCFramework'lere ve kaynaklara erişmek için dosyaları ayıklayın.
3. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başlıyorsanı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. Paket tanımlayıcısı alanının değerini kaydedin. Bu değeri kullanarak API anahtarınızı aşağıda kısıtlayabilirsiniz.
      3. Proje Arayüzü'nü Senaryo Panosu olarak ayarlayın.
      4. Dil'i Swift veya Objective-C olarak ayarlayın.
4. Genel sekmesini açın. Aşağıdaki XCFramework'leri 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:
   • GoogleMaps.xcframework
5. İndirdiğiniz GoogleMapsResources'taki GoogleMaps.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.
6. Proje Gezgini'nden projenizi seçin ve uygulamanızın hedefini belirleyin.
7. Uygulamanızın hedefi için Build Phases (Derleme Aşamaları) sekmesini açın. Link Binary with Libraries (Kitaplıklarla İkiliyi Bağla) bölümünde aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (Yalnızca OpenGL kullanıyorsanız)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 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.

9. iOS için Yerler SDK'sı XCFramework'ü yüklemek için iOS için Yerler SDK'sını Kullanmaya Başlama başlıklı makaleyi inceleyin.

CocoaPods

iOS için Haritalar SDK'sı, CocoaPods kapsülü 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

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

1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başlıyorsanı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. Paket tanımlayıcısı alanının değerini kaydedin. Bu değeri kullanarak API anahtarınızı aşağıda kısıtlayabilirsiniz.
      3. Proje Arayüzü'nü Senaryo Panosu 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ınızı sürümleriyle birlikte ekleyin. iOS için Haritalar SDK'sı için ihtiyacınız olan bağımlılığı içeren bir örneği aşağıda bulabilirsiniz:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '10.4.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 daha yeni bir sürümün olup olmadığını tespit edin. Gerekirse en son sürüme yükseltin.
4. Podfile öğesini kaydedin.

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

Swift

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

1. Aşağıdaki içe aktarma ifadesini ekleyin:

   import GoogleMaps

2. API anahtarınızı kullanarak application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Places API'yi de kullanıyorsanız anahtarınızı burada gösterildiği gibi tekrar ekleyin:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. Aşağıdaki içe aktarma ifadesini ekleyin:

   @import GoogleMaps;

2. API anahtarınızı kullanarak application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Places API'yi de kullanıyorsanız anahtarınızı burada gösterildiği gibi tekrar ekleyin:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];