Xcode projesi oluşturma

Faturalandırmayı etkinleştirip API anahtarı oluşturduktan sonra, uygulamanızı geliştirmek için kullanacağınız Xcode projesini ayarlamaya hazırsınız demektir.

Her sürüm için sürüm notları mevcuttur.

1. adım: Gerekli yazılımı yükleyin

iOS için Haritalar SDK'sını kullanarak proje oluşturmak istiyorsanız şunları indirip yüklemeniz gerekir:

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

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

Not: iOS için Haritalar SDK'sı, belirli cihazlar için oluşturulan uygulamalara ortalama 5,7 MB IPA boyutu ekler. Evrensel uygulamaların indirme boyutu daha büyük olabilir.

SDK yükleme boyutu değişiklik gösterebilir. Örneğin, iOS 9.0 sürümü için Haritalar SDK'sının yükleme boyutu yaklaşık 18 MB'tır.

Not: 9.2.0 sürümünden itibaren GoogleMapsCore ve GoogleMapsBase, GoogleMaps XCFramework'ta birleştirilmiştir. Ek kurulum gerekmez.

Swift Package Manager

iOS için Haritalar SDK'sı, Swift Package Manager aracılığıyla 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.

Önemli: Bu talimatlarda Xcode 15 veya sonraki sürümlerin kullanıldığı varsayılmaktadır ancak Xcode'un önceki sürümlerinde de benzer işlemler uygulanabilir.

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

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

1. 9.0.0'den önceki bir sürümden yükseltme yapıyorsanız yükseltme yaptıktan 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ünün sürüm notlarına göz atın.

   Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i 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 "Dosya > Paketler > Son Paket Sürümlerine Güncelle"ye gidin.
3. 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.

Önemli: Bazen yapı çözümlenemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı seçin.

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. CocoaPods dışında bir şey için kullanmıyorsanız Podfile, Podfile.resolved ve Xcode workspace'i kaldırın.

Manuel olarak yüklenen mevcut iOS için Haritalar SDK'sını kaldırmak üzere aşağıdaki 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çeveyi kaldırmak için eksi işaretini(-) kullanın:
   • GoogleMaps
   • GoogleMapsBase (Yalnızca 9.2.0 sürümünden önceki sürümlerin yüklenmesinde)
   • GoogleMapsCore (Yalnızca 9.2.0 sürümünden önceki sürümlerin yüklenmesinde)
   • GoogleMapsM4B (Yalnızca 9.0.0 sürümünden önceki sürümlerde)
2. Xcode projenizin üst düzey dizininden GoogleMaps paketini kaldırın.

Manuel Kurulum

Bu kılavuzda, iOS için Haritalar SDK'sını içeren XCFramework'ları 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 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
   • GoogleMapsM4B
   • GoogleMapsResources
2. XCFrameworks'a ve kaynaklara erişmek için dosyaları ayıklayın.
3. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başladıysanı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. Grup tanımlayıcısı alanının değerini kaydedin. Aşağıda API anahtarınızı kısıtlamak için bu değeri kullanabilirsiniz.
      3. Projenin Arayüzü'nü Görsel Taslak olarak ayarlayın.
      4. Dil'i Swift veya Objective-C olarak ayarlayın.
4. 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:
   • GoogleMaps.xcframework
5. İndirdiğiniz GoogleMapsResources dosyasından GoogleMaps.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.
6. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
7. Uygulamanızın hedefi için Derleme Aşamaları sekmesini açın. Binariyi Kitaplıklarla 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
   • OpenGLES.framework (Yalnızca OpenGL kullanıyorsanız)
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Bağlantı Oluşturma - Genel -> Diğer Bağlantı Oluşturucu İş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.

9. iOS XCFramework için Yerler SDK'sını yüklemek isterseniz 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 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

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

1. Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başladıysanı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. Grup tanımlayıcısı alanının değerini kaydedin. Aşağıda API anahtarınızı kısıtlamak için bu değeri kullanabilirsiniz.
      3. Projenin Arayüzü'nü Görsel Taslak 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ı sürümleriyle birlikte ekleyin. iOS için Haritalar SDK'sı için ihtiyaç duyduğunuz bağımlılığı içeren 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 'GoogleMaps', '9.2.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. Gerekirse en son sürüme yükseltin.
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.

3. Adım: API anahtarınızı projeye ekleyin

API anahtarı alma bölümünde, uygulamanız için bir API anahtarı oluşturdunuz. Şimdi bu anahtarı Xcode projenize ekleyin.

Aşağıdaki örneklerde YOUR_API_KEY yerine API anahtarınızı girin.

Not: Projenizin paket tanımlayıcısını kaydettiyseniz veya proje özelliklerinden elde ettiyseniz API anahtarınızı yalnızca belirli bir paket tanımlayıcısına sahip iOS uygulamalarında kullanılacak şekilde kısıtlamak için kullanabilirsiniz. Daha fazla bilgi için API anahtarlarını kısıtlama başlıklı makaleyi inceleyin.

Swift

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

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

   import GoogleMaps

2. API anahtarınızı kullanarak application(_:didFinishLaunchingWithOptions:) yöntemine şunları 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'nize aşağıdaki gibi ekleyin:

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

   @import GoogleMaps;

2. API anahtarınızı kullanarak application:didFinishLaunchingWithOptions: yöntemine şunları 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"];

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

Not: Aşağıdakiler, uygulamanızı web mağazasına dağıtırken geçerlidir.

Apple, App Store'daki uygulamalar için uygulama gizliliği 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 Manifesti dosyası, SDK'nın kaynak paketine dahildir. Gizlilik manifesti dosyasının eklendiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden bir gizlilik raporu oluşturun.

5. adım (isteğe bağlı): API tarafından kullanılan URL şemalarını tanımlayın

iOS 9 ve Xcode 7'den itibaren uygulamalar, Info.plist dosyasında şemaları belirterek açmak istedikleri URL şemalarını beyan edebilir. iOS için Haritalar SDK'sı, kullanıcı haritadaki Google logosunu tıkladığında Google Haritalar mobil uygulamasını açar. Bu nedenle uygulamanız ilgili URL şemalarını tanımlayabilir.

iOS için Haritalar SDK'sı tarafından kullanılan URL şemalarını beyan etmek üzere Info.plist dosyanıza aşağıdaki satırları ekleyin:

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

Aşağıdaki ekran görüntüsünde, Xcode kullanıcı arayüzündeki yapılandırma gösterilmektedir:

Yukarıdaki beyan olmadan, kullanıcı haritadaki Google logosuna dokunduğunda aşağıdaki hatalar oluşabilir:

• -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
• -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Bu hataları ortadan kaldırmak için beyanı Info.plist dosyanıza ekleyin.

Sırada ne var?

Artık bir API anahtarınız ve Xcode projeniz olduğu için uygulama oluşturup çalıştırabilirsiniz. iOS için Navigasyon SDK'sı, başlamanıza yardımcı olabilecek birçok eğitim ve örnek uygulama sağlar. Daha fazla bilgi için:

• Aşağıdaki eğitici içerikler başlangıç için önerilir:
  • İşaretçi içeren bir harita ekleyin.
  • Mevcut Yeri Seçin ve Ayrıntıları Haritada Gösterin.
  • Tersine Coğrafi Kodlama.
• Mevcut kod örneklerine ve codelabs göz atın.
• Uçtan uca çözümler için mevcut Haritalar çözümlerini inceleyin.