Xcode projesi oluşturma

Faturalandırmayı etkinleştirip API anahtarı oluşturduktan sonra uygulamanızı geliştirmek için kullandığınız Xcode projesini ayarlayın.

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 bir proje oluşturmak için şunları indirip yükleyin:

• Xcode 26.0 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österir. Örneğin, iOS için Haritalar SDK'sının 9.0 sürümünün yükleme boyutu yaklaşık 18 MB'tır.

Not: 9.2.0 sürümüyle birlikte GoogleMapsCore ve GoogleMapsBase, GoogleMaps XCFramework'te birleştirildi. Ek kurulum gerekmez.

iOS için Haritalar SDK'sı şu anda birleştirilebilir kitaplıkları desteklememektedir. Yayın derlemeleri sırasında bağlayıcı hatalarını önlemek için Xcode projenizdeki Build Mergeable Library (Birleştirilebilir Kitaplık Oluştur) ayarının No (Hayır) olarak ayarlandığından emin olun.

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 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-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.
4. Paket Ürünleri Seçin penceresinde, GoogleMaps (9.0.0'dan önceki sürümlerde GoogleMaps, GoogleMapsBase ve GoogleMapsCore öğelerinin ekleneceğini doğrulayın) öğesinin belirlenen main hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayı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üklenen 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. 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 Proje Gezgini'nin Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

Önemli: Bazen yapaylıklar çözülemez 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 şu 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.

Manuel olarak yüklenen mevcut iOS için Haritalar 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çeveyi kaldırmak için eksi işaretini (-) kullanın:
   • GoogleMaps
   • GoogleMapsBase (Yalnızca 9.2.0'dan önceki sürümlerde geçerlidir)
   • GoogleMapsCore (Yalnızca 9.2.0'dan önceki sürümlerdeki kurulumlar için)
   • GoogleMapsM4B (Yalnızca 9.0.0'dan önceki sürümlerde geçerlidir)
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 açıklanmaktadır. XCFramework, Apple çipli makineler de dahil olmak üzere birden fazla platformda kullandığınız bir ikili pakettir.

1. Aşağıdaki SDK ikili programlarını ve kaynak dosyalarını indirin:
   • GoogleMaps
   • GoogleMapsResources
2. XCFramework'lere ve kaynaklara erişmek için dosyaları çıkarı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 kimliği alanının değerini kaydedin. Bu değeri, API anahtarınızı aşağıda kısıtlamak için kullanabilirsiniz.
      3. Proje Arayüzü'nü Resimli Taslak 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 bölümünde, "Debug" ve "Release" 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.

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.

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

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

Aşağıdaki örneklerde YOUR_API_KEY kısmını API anahtarınızla değiştirin.

Not: Projenizin paket kimliğini kaydettiyseniz veya proje özelliklerinden aldıysanız bu tanımlayıcıyı, API anahtarınızın yalnızca söz konusu paket kimliğine sahip iOS uygulamalarıyla kullanılmasını kısıtlamak için kullanın. Daha fazla bilgi için API anahtarlarını kısıtlama bölümüne bakın.

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

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

Not: Aşağıdaki bilgiler, uygulamanızı web mağazasına dağıttığınızda geçerlidir.

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.

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

iOS 9 ve Xcode 7'den itibaren uygulamalar, açmayı planladıkları URL şemalarını uygulamanın Info.plist dosyasında belirterek bildirir. 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ı bildirebilir.

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

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

Aşağıdaki resimde, 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ı gidermek için beyanı Info.plist öğenize ekleyin.

Sırada ne var?

Artık bir API anahtarınız ve Xcode projeniz olduğuna göre uygulamalar oluşturup çalıştırabilirsiniz. iOS için Navigation SDK, başlamanıza yardımcı olacak birçok eğitim ve örnek uygulama sunar. Daha fazla bilgi için:

• İşaretçi içeren bir harita ekleyin.
• Mevcut Yeri Seç ve Haritada Ayrıntıları Göster'i seçin.
• Tersine Coğrafi Kodlama.
• Mevcut kod örneklerine ve codelab'lere göz atın.
• Uçtan uca çözümler için mevcut Haritalar Çözümleri'ni inceleyin.