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

Platform seçin: Android iOS JavaScript

Not: Uygulamanızda kullanılabilen iOS için Yerler SDK'sı özellikleri, uygulama yapılandırmanızda belirttiğiniz SDK sürüm numarası ile API anahtarınızda etkinleştirilen API'lerin bir kombinasyonuyla belirlenir. Daha fazla bilgi için SDK sürümünüzü seçme başlıklı makaleyi inceleyin.

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.

Hangi sürüme bağlanacak?

• 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 Yerler 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 Yerler SDK'sında sorunlarla karşılaşırsanız Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu bir ş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 yapılan yıllık artımlı güncellemeler, uygulamanızı uyarlama, yeniden yazma ve test etme konusunda daha az çalışma gerektirebilir. Bu sayede, birden fazla ana sürümde yapılan geriye dönük uyumsuz değişikliklerle uğraşmak zorunda kalmazsınız.

• Kritik olmayan uygulamalar için herhangi bir düzeltilmiş sürüme bağlantı verin. Bu düzeltilmiş sürüm için kullanımdan kaldırma bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ay süreniz 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 Yerler SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut iOS için Yerler 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-places-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, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirlediğiniz ana hedefe ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

   Google Places Swift'i, desteği sonlandırılan GitHub URL'sinden güncelliyorsanız

   Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si 0.3.0 sürümünden itibaren değişti. GooglePlacesSwift'in eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırı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 Package Dependencies 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. Xcode'da File (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.

   Google Places Swift'i, desteği sonlandırılan GitHub URL'sinden güncelliyorsanız

   Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si 0.3.0 sürümünden itibaren değişti. GooglePlacesSwift'in eski URL (https://github.com/googlemaps/ios-places-swift-sdk) üzerinden erişilen bir sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırın.

2. 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ın çözümlenememesi veya hataların oluşması mümkündür. Bu durumda "File > Packages > Reset Package Cache" (Dosya > Paketler > Paket Önbelleğini Sıfırla) seçeneğini belirleyin.

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:

  

    
    
    

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

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

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 her projenize izlenen bir e-posta adresiyle sahip rolü atayın.