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 proje oluşturmak istiyorsanız ş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 geliştirilen 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ı 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ştirilmiştir. Ek kurulum gerekmez.

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

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.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

1. Xcode project veya workspace dosyanızı açın, ardından File > Add Package Dependencies (Dosya > Paket Bağımlılıkları Ekle) bölümüne gidin.
2. URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) 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 yeni sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
4. Choose Package Products (Paket Ürünleri Seçin) penceresinde, GoogleMaps (9.0.0'dan önceki sürümler için GoogleMaps, GoogleMapsBase ve GoogleMapsCore) öğesinin, belirlediğiniz main hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "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üklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın (Proje Gezgini) "Package Dependencies" (Paket Bağımlılıkları) bölümünü de görüntüleyebilirsiniz.

Mevcut bir projenin package bilgisini 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 Sürüm 9.0.0 Sürüm Notları'na bakın.

   Xcode proje yapılandırma ayarlarınızda Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünü 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 (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.
3. Yüklemenizi doğrulamak için Project Navigator'ın Package Dependencies bölümüne giderek paketi ve sürümünü doğrulayın.

Önemli: Bazen yapılar çözümlenemez veya hatalar oluşabilir. Bu durumda "File > Packages > Reset Package Cache" (Dosya > Paketler > Paket Önbelleğini Sıfırla) seçeneğini belirleyin.

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çın ve 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 amaçla kullanmıyorsanız Podfile, Podfile.resolved ve Xcode workspace'yi 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) bölümünü 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 yüklemeler için)
   • GoogleMapsCore (Yalnızca 9.2.0 sürümünden önceki yüklemeler 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 açıklanmaktadır. XCFramework, Apple Silicon kullanan makineler de dahil olmak üzere birden fazla platformda kullandığınız bir ikili program paketidir.

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ı ayıklayın.
3. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirme konusunda yeniyseniz:
   1. Yeni bir proje oluşturun.
   2. iOS > Uygulama şablonunu seçin.
   3. Proje seçenekleri ekranında:
      1. Project Name (Proje Adı) girin.
      2. Paket kimliği alanının değerini kaydedin. Bu değeri, API anahtarınızı 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 (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünün altındaki projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
   • GoogleMaps.xcframework
5. İndirdiğiniz GoogleMapsResources'tan 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 Build Phases (Derleme Aşamaları) sekmesini açın. Link Binary with Libraries (İkili Dosyayı Kitaplıklara 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ınlama) seçeneklerine -ObjC değerini ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel'den Tümü'ne değiştirin.

9. iOS için Yerler SDK'sı XCFramework'ü yüklemek üzere 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ı 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 kısmını API anahtarınızla değiştirin.

Not: Projenizin paket kimliğini kaydettiyseniz veya proje özelliklerinden aldıysanız API anahtarınızı yalnızca bu paket kimliğine sahip iOS uygulamalarıyla kullanılacak şekilde kısıtlamak için bu kimliği kullanın. Daha fazla bilgi için API anahtarlarını kısıtlama başlıklı makaleyi inceleyin.

Swift

API anahtarınızı AppDelegate.swift dosyanıza 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ö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 dosyanıza 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ö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ğıtırken geçerlidir.

Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple Uygulama Mağazası Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple gizlilik manifest dosyası, SDK'nın kaynak paketine dahildir. Gizlilik Manifest Dosyası'nın dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir 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 ü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 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ı ortadan kaldırmak için beyanı Info.plist dosyanıza ekleyin.

Sırada ne var?

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

• İşaretçili harita ekleme
• Mevcut Yeri Seçme ve Haritada Ayrıntıları Gösterme
• 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.