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

Hangi sürümle bağlantı oluşturulur?

• İş 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 uyumlu olmayan değişiklikleri ele almaktan daha az iş gerektirebilir.

• Kritik olmayan uygulamalar için düzeltilmiş bir sürümle bağlantı oluşturun. Düzeltilmiş sürüm için desteğin sonlandırılmasıyla ilgili bir bildirim 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 sahibi olun.

Kurulum

Swift Package Manager

iOS için Yerler SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Places SDK for iOS bağımlılıklarını kaldırdığınızdan emin olun.

Önemli: Bu talimatlarda Xcode 15 veya sonraki sürümlerin kullanıldığı varsayılmaktadır ancak önceki Xcode sürümlerinde de benzer şekilde uygulanabilir.

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 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üklenen 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 görüntüleyebilirsiniz.

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 Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

Önemli: Bazen yapay nesneler çözülemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket önbelleğini sıfırla"yı seçin.

CocoaPods

Öngörülmeyen ve tekrarlanamayan derlemelere yol açabileceğinden, iyimser operatör (~>) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. iOS için Yerler SDK'sı, anlamsal sürüm oluşturma özelliğine uygundur ve yeni ana sürüm yayınları, uyumluluğu bozan 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, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.4.0'
  pod 'GooglePlacesSwift', '10.4.0'
end

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 Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

Önemli: Bazen yapay nesneler çözülemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket önbelleğini sıfırla"yı seçin.

Cocoapods

1. Bir terminal açın ve 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 mevcut olup olmadığını görmek için pod outdated komutunu çalıştırın.
3. SDK'nın daha yeni bir sürümü bulunursa Podfile öğenizi bu yeni sürümle güncelleyin. Podfile dosyanızda belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Pod sürümlerini belirtme başlıklı makaleyi inceleyin.
4. Koşu pod update.
5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için sürüm notlarına bakın.
6. Product > Clean'i ve ardından Product > Build'i seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

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

Google Cloud, yeni sürümler için yoklama yapmanı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 her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.