iOS sürümleri için Haritalar SDK'sı

Platform seçin: Android iOS JavaScript

Google Haritalar Platformu ekibi, SDK'ları yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle düzenli olarak günceller. Bu sayfada, mobil SDK'lara olan bağımlılıklarınızı nasıl yöneteceğinizle ilgili bilgiler verilmiştir.

  • Görev açısından kritik uygulamalar için, kullandığınız ana sürümün en son nokta sürümüne (X.*) bağlantı verin ve her yıl yeni ana sürüme yükseltin.

    Yıl boyunca uygulamanızın yeni sürümlerini yayınladıkça iOS için Haritalar SDK'sının daha yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Yeni nokta sürümleri geriye dönük uyumlu olduğundan uygulamanızda güncelleme yapmanız gerekmez.

    Avantajları:

    • iOS için Haritalar SDK'sında sorun tespit ederseniz Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için acilen uyumsuz bir SDK sürümüne geçmeniz gerekmez.
    • Uygulamanız en yeni sürüm üzerine geliştirildiğinde en yeni iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümüne yıllık artımlı güncellemeler yapmak, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde yapılan geriye dönük uyumsuz değişiklikleri ele almaktan daha az çalışma gerektirebilir.

  • Kritik olmayan uygulamalar için herhangi bir düzeltilmiş sürüme bağlantı verin. Bu düzeltilmiş sürüm için desteğin sonlandırılması bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olur.

    Avantajları:

    • Daha seyrek bakım çalışması.
    • Uygulamanızın yeni sürümleri, kullanıcıların daha eski mobil işletim sistemlerini çalıştıran cihazlarını daha uzun süre (yeni bir SDK sürümüne yükseltmeniz gerekene kadar) desteklemeye devam eder.

İzlenen e-posta adreslerine sahip proje sahipleri, projelerini etkileyen değişikliklerle ilgili proaktif bildirimler alır. Önemli güncellemeler, desteği sonlandırılan özellikler ve diğer değişiklikler hakkında bilgi edinin.

Kurulum

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'e (Dosya > Paket Bağımlılıkları Ekle) 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. 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 General (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.

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 araçlarını kaldırın.

Bakım ve yükseltme

En son iyileştirmelerle derleme yapmak için yeni sürümleri düzenli olarak kontrol edin ve sürüm özelliklerinizi güncelleyin. Yeni bir ana sürüme geçiyorsanız geriye dönük uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz hakkında bilgi edinmek için sürüm notlarını inceleyin.

Swift Package Manager




To update the package for an existing project, follow these steps:


  
    
    
    
    
  1. 
      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
    2.

Manuel yükleme

SDK'yı yükleme bölümünde en son kaynak dosyaların bağlantısını alın.

Google Cloud proje sahipleri, daha yeni sürümleri sorgulamanın yanı sıra projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar alır. Geriye dönük uyumsuz değişikliklerle ilgili proaktif bildirim almak için projelerinizin her birine izlenen bir e-posta adresiyle sahip rolü atayın.