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

Platform seçin: Android iOS JavaScript

Google Haritalar Platformu Ekibi, SDK'ları düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, mobil SDK'lardaki bağımlılıklarınızı nasıl yöneteceğiniz hakkında bilgi verilmektedir.

  • İş açısından kritik uygulamalar için, kullandığınız ana sürümün (X.*) en son nokta sürümüne 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 sorunlar keşfederseniz 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 uyumsuz bir SDK sürümüne acilen yükseltmeniz gerekmez.
    • Uygulamanız zaten en son sürümde oluşturulduysa 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ı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde kullanıma sunulan geriye dönük uyumsuz değişiklikleri ele almaktan daha az iş gerektirebilir.

  • Kritik olmayan uygulamalar için düzeltilmiş bir sürümün bağlantısını ekleyin. 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 az bakım çalışması
    • 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 yükseltmeniz gerekene kadar).

İzlenen e-posta adreslerine sahip proje sahipleri, projelerinin her birini etkileyen değişiklikler hakkında 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 Yerler SDK'sı for iOS 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-places-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, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirlenen ana hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

    Google Places Swift'i kullanımdan kaldı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. Eski URL https://github.com/googlemaps/ios-places-swift-sdk üzerinden erişilen bir GooglePlacesSwift 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 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 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. Xcode'da File > Packages > Update To Latest Package Versions (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine gidin.

    Google Places Swift'i kullanımdan kaldı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. Eski URL https://github.com/googlemaps/ios-places-swift-sdk üzerinden erişilen bir GooglePlacesSwift 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 Proje Gezgini'nin Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

Bakım ve yükseltme

En son iyileştirmelerle geliştirmek için düzenli olarak daha yeni sürümleri kontrol edin ve sürüm spesifikasyonlarınızı güncelleyin. Yeni bir ana sürüme güncelliyorsanı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

Mevcut bir projenin package bölümünü güncellemek için aşağıdaki adımları uygulayın:

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

Manuel yükleme

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

Google Cloud, yeni sürümleri yoklamanın yanı sıra proje sahiplerine projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar da gönderir. Geriye dönük uyumsuzluk içeren değişiklikler hakkında proaktif bildirim almak için projelerinizin her birinde izlenen bir e-posta adresiyle sahip rolünü atayın.