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 Haritalar 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 Haritalar SDK'sında sorunlar tespit ederseniz 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 için zaten geliştirilmiş olduğunda 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 Haritalar SDK'sı üzerinden yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için iOS bağımlılıkları için mevcut tüm Haritalar SDK'sını kaldırdı.
SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:
-
Xcode
project
veyaworkspace
dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin. - URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girip Enter'a basın. paketi çekin ve "Paket Ekle"yi tıklayın.
-
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. -
Paket Ürünlerini Seçin penceresinde
GoogleMaps
alanını doğrulayın (9.0.0'dan önceki sürümler içinGoogleMaps
,GoogleMapsBase
veGoogleMapsCore
) şuna eklenecek: belirlediğinizmain
hedefiniz İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
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:
9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar:
GoogleMapsBase
,GoogleMapsCore
ve Yükseltme işleminden sonraGoogleMapsM4B
. Bağımlılığı kaldırmayın:GoogleMaps
Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
GoogleMapsBase
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsCore
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsM4B
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
- Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
CocoaPods
, aşağıdaki adımları uygulayın:
- Xcode çalışma alanınızı kapatın. Terminali açın ve aşağıdaki komutu yürütün:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Podfile
,Podfile.resolved
ve CocoaPods dışında bir şey için kullanmıyorsanız Xcodeworkspace
.
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 Haritalar SDK'sı semantik sürüm oluşturma ile uyumludur.
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 'GoogleMaps', '8.4.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:
9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar:
GoogleMapsBase
,GoogleMapsCore
ve Yükseltme işleminden sonraGoogleMapsM4B
. Bağımlılığı kaldırmayın:GoogleMaps
Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
GoogleMapsBase
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsCore
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsM4B
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
- Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
Kakao
Bir terminal penceresi açın ve
Podfile
öğesini içeren dizine gidin:cd <path-to-project>
pod outdated
komutunu çalıştırarak iOS için Haritalar SDK'sının daha yeni bir sürümünün olup olmadığını öğrenin kullanılabilir.- 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ü inceleyinPodfile
cihazınızda belirli bir sürümü nasıl ayarlayacağınızı öğrenin. pod update
çalıştır.- 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.
- Ü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.