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

Platform seçin: Android iOS JavaScript

Not: Uygulamanızda bulunan iOS için Yerler SDK'sı özellikleri SDK sürüm numarasının bir kombinasyonuna bağlı olarak, uygulama yapılandırması ve API anahtarınızda etkinleştirilen API'ler. Daha fazla bilgi için SDK sürümünüzü seçme adlı makaleyi inceleyin.

Google Haritalar Platformu ekibi, SDK'ları yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri. Bu sayfa, bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterir test edilir.

Hangi sürüme bağlanacaksınız?

• İş açısından kritik uygulamalar için ana sürümün en yeni (X.*) kullanın ve her yıl yeni ana sürüme yükseltin.

  Uygulamanızın yeni sürümlerini kullanıma sundukça Yıl boyunca, iOS için Yerler SDK'sının daha yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Bu, Yeni nokta sürümleri geriye dönük uyumlu olduğundan uygulamanızda güncelleme gerektirmeyecektir.

  Avantajları:

  • iOS için Yerler SDK'sında sorunlar keşfederseniz düzeltmelerin kullanıma sunulmasından sonra 12 ay boyunca geriye dönük uyumluluğa Mobil destek politikasına tabidir. Acil olarak uyumlu olmayan bir SDK sürümüne yükseltmeniz gerekmez yararlanmanız için sunulacak.
  • En son iyileştirmeler ve özellikler, uygulamanız gereken şekilde geliştirilmişse kolayca benimsenebilir en son sürüme güncelleyin.
  • SDK'nın en yeni ana sürümüne yönelik yıllık artımlı güncellemeler daha az çalışma gerektirebilir. eski sürümlerle uyumsuzlukları çözmek yerine uygulamanızı uyarlamak, yeniden yazmak ve test etmek Birden fazla ana sürümde yapılan değişiklikler.

• Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Desteğin sonlandırılması durumunda bildirimi almanız gerekiyorsa güncellenmiş uygulama kodunuzu ne kadar iyi karşıladığını görebileceksiniz.

  Avantajları:

  • Daha seyrek bakım çalışmaları.
  • Uygulamanızın yeni sürümleri, eski mobil işletim sistemi çalıştıran cihazlar daha uzun süre kullanılabilir (yeni bir SDK sürümüne yükseltmeniz gerekene kadar).

İzlenen e-posta adreslerine sahip Proje Sahipleri, nasıl etkilediğini öğreneceğiz. Kal ve diğer değişiklikler hakkında bilgilendirilmeyi sağlar.

Kurulum

Swift Paket Yöneticisi

iOS için Yerler SDK'sı üzerinden yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için Mevcut iOS bağımlılıkları için Yerler SDK'sını kaldırdık.

Önemli: Bu talimatlar Xcode 15 veya sonraki sürümlerin kullanıldığını varsayar ancak benzer olmalıdır. kullanın.

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 Dosya > Paket Bağımlılıkları Ekleyin.
2. URL olarak https://github.com/googlemaps/ios-places-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü ve "Tam Sürüm"ü kullanarak seçeneğini belirleyin. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
4. Paket Ürünlerini Seçin penceresinde, GooglePlaces öğesinin şuraya ekleneceğini doğrulayın: belirlediğiniz main hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. "Paket Bağımlılıkları"nı da görüntüleyebilirsiniz "Project Navigator"ın bölümü .

Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

1. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
2. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .

ziyaret edin.

Önemli: Bazen yapılar çözümlenemez veya hatalar oluşabilir. Bu örnekte, "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı tıklayın.

CocoaPods

İyimser bir operatör kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin (~>). Bu da öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. İlgili içeriği oluşturmak için kullanılan iOS için Yerler SDK'sının anlamsal sürüm oluşturma ve yeni ana sürüm sürümleri de zarar veren değişiklikleri içerir.

Örnek bir Podfile bağımlılığı Podfile söz dizimi:

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.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ünüzü güncelleyin özellikler. Yeni bir ana sürüme güncelleme yapıyorsanız sürüm notlarını inceleyebilirsiniz.

Swift Paket Yöneticisi

Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

1. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
2. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .

ziyaret edin.

Önemli: Bazen yapılar çözümlenemez veya hatalar oluşabilir. Bu örnekte, "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı tıklayın.

Kakao

1. Bir terminal penceresi açın ve Podfile öğesini içeren dizine gidin:

   cd <path-to-project>

2. pod outdated komutunu çalıştırarak iOS için Yerler SDK'sının daha yeni bir sürümünün olup olmadığını öğrenin kullanılabilir.
3. SDK'nın daha yeni bir sürümü bulunursa Podfile öğenizi bu yeni sürümle güncelleyin. Kapsül sürümlerini belirtme bölümünü inceleyin Podfile cihazınızda belirli bir sürümü nasıl ayarlayacağınızı öğrenin.
4. pod update çalıştır.
5. Yükseltme sonucunda gerekli değişiklikleri yapın. Bkz. Her sürümdeki değişikliklerin listesini görmek için Sürüm Notları'nı inceleyin.
6. Ürün > Temizle ve ardından Ürün > Derleme

Manuel yükleme

En son kaynak dosyaların bağlantısını alın bölümünü okuyun.

Google Cloud, daha yeni sürümleri yoklamanın yanı sıra proje sahipleri projelerini etkileyebilecek geriye dönük uyumsuz değişiklikler hakkında e-posta alır. Alıcı: geriye dönük olarak uyumsuz değişiklikler hakkında proaktif bildirim almak, ata sahip rolüne sahip olmanız gerekir.