iOS sürümleri için Yerler 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ı yönetme hakkında yol gösterici bilgiler verilmektedir.

  • İş 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ınlarken 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 bu işlem için uygulamanızda güncelleme yapmanız gerekmez.

    Avantajları:

    • iOS için Yerler SDK'sında sorun tespit ederseniz Mobil destek politikası uyarınca, ana sürümün ilk sürümünden sonraki 12 ay boyunca geriye dönük uyumlu bir şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumlu olmayan bir SDK sürümüne hemen geçmeniz gerekmez.
    • Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümünde yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az iş gerektirebilir. Bu, birden fazla ana sürüm sürümünde kullanımdan kaldırılan değişikliklerle uğraşmaktan daha az iş gerektirir.

  • Kritik olmayan uygulamalar için düzeltilen bir sürümün bağlantısını ekleyin. Bu düzeltilmiş sürüm için desteğin sonlandırıldığına dair bildirim aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmanız için 12 ay süre tanınır.

    Avantajları:

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

İzlenen e-posta adreslerine sahip proje sahipleri, projelerinin her birini 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 iOS için mevcut Yerler SDK'sı bağımlılıkları 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 project veya workspace açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin.
  2. URL olarak https://github.com/googlemaps/ios-places-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.
  4. Paket Ürünlerini Seçin penceresinde, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirttiğiniz ana hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

    Google Places Swift'i güncelliyorsanız

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

  5. Yüklemenizin doğru olup olmadığını kontrol etmek için hedefinizin Genel bölmesine gidin. Yüklenen paketleri Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünde görebilirsiniz. Paketi ve sürümünü doğrulamak için Proje Gezgini'nin Paket Bağımlılıkları bölümünü de görüntüleyebilirsiniz. Xcode, GitHub sürümünü gösterir. Bu sürüm, GooglePlaces sürümüyle (ör. 9.2.0) eşleşir ancak GooglePlacesSwift sürümüyle (ör. 0.3.0) eşleşmez.

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

  1. Xcode'da "Dosya > Paketler > Son Paket Sürümlerine Güncelle"ye gidin.

    Google Places Swift'i güncelliyorsanız

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

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

CocoaPods

Tahmini operatör (~>) kullanmak, öngörülemeyen ve tekrarlanamayan derlemelere yol açabileceğinden, bağımlılıklarınızda her zaman bir sürüm numarası belirtin. iOS için Yerler SDK'sı anlamsal sürümlemeye uyar ve yeni ana sürüm sürümleri önemli değişiklikler içerir.

Podfile söz dizimini kullanan örnek bir Podfile bağımlılığı:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end

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 büyük sürüme güncelliyorsanız geriye dönük uyumlu olmayan 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

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

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

Cocoapods

  1. Bir terminal açıp Podfile dosyasını içeren dizine gidin:

    cd <path-to-project>
  2. iOS için Yerler SDK'sının daha yeni bir sürümünün olup olmadığını görmek için pod outdated'yi çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile'inizi bu yeni sürümle güncelleyin. Podfile'nizde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme başlıklı makaleyi inceleyin.
  4. pod update'ü çalıştırın.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini Sürüm Notları'nda bulabilirsiniz.
  6. Ürün > Temizle'yi ve ardından Ürün > Derle'yi seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

SDK'yı Yükleme başlıklı makalede en son kaynak dosyaların bağlantısını alın.

Google Cloud proje sahipleri, yeni sürümler için ankete katılmanın yanı sıra projelerini etkileyebilecek geriye dönük uyumlu olmayan değişikliklerle ilgili e-postalar alır. Geriye dönük uyumlu olmayan değişiklikler hakkında proaktif bildirim almak için her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.