Google Haritalar Platformu ekibi, SDK'ları düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, mobil SDK'lara olan bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterici bilgiler sağlanmaktadır.
Hangi sürüme bağlanacaksınız?
-
İş 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ınladıkça iOS için Haritalar SDK'sının daha yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Yeni nokta sürümleri geriye dönük olarak uyumlu olduğundan, bu işlem için uygulamanızda güncelleme yapılması gerekmez.
Avantajları:
- iOS için Haritalar SDK'sında sorunlar olduğunu fark ederseniz Mobil destek politikası uyarınca, ana sürümün ilk sürümünün yayınlanmasından itibaren 12 ay boyunca geriye dönük uyumlu şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için acilen incompatible bir SDK sürümüne geçmeniz gerekmez.
- Uygulamanız en son sürümde oluşturulduğunda en son iyileştirmeler ve özellikler kolayca kullanılabilir.
- SDK'nın en yeni ana sürümüne her yıl yapılacak artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürüm genelinde ortaya çıkan ve geriye dönük olarak uyumsuz olan değişiklikleri yönetmekten daha az çalışma gerektirebilir.
Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Söz konusu düzeltilmiş sürüm için kullanımdan kaldırma bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olacaktır.
Avantajları:
- Daha seyrek 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 (yeni bir SDK sürümüne yükseltmeniz gerekene kadar) desteklemeye devam eder.
E-posta adresleri izlenen Proje Sahipleri, projelerinin her birini etkileyen değişiklikler hakkında proaktif bildirimler alır. Büyük güncellemeler, kullanımdan kaldırmalar ve diğer değişiklikler hakkında bilgilerden haberdar olun.
Döşeme
Swift Paket Yöneticisi
iOS için Haritalar SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek istiyorsanız iOS için mevcut tüm Haritalar SDK'sı bağımlılıklarını kaldırdığınızdan emin olun.
SDK'yı yeni veya mevcut bir projeye eklemek için şu adımları uygulayın:
-
Xcode
project
veyaworkspace
cihazınızı açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin. - URL olarak https://github.com/googlemaps/ios-maps-sdk girin, paketi çekmek için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
-
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. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Paket Ürünlerini Seçin penceresinde
GoogleMaps
,GoogleMapsBase
veGoogleMapsCore
değerlerinin belirlediğinizmain
hedefine ekleneceğini doğrulayın (9.0.0'dan önceki sürümler için).GoogleMaps
İş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şik İçerik'te yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"daki "Paket Bağımlılıkları" bölümüne de bakabilirsiniz.
Mevcut bir proje için package
öğesini güncellemek üzere şu adımları uygulayın:
9.0.0'dan eski bir sürümden yükseltme yapıyorsanız şu bağımlılıkları kaldırmanız gerekir: yükseltmeden sonra
GoogleMapsBase
,GoogleMapsCore
veGoogleMapsM4B
.GoogleMaps
için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 Sürüm Notları'na bakın.Xcode proje yapılandırma ayarlarınızdan Frameworks, Libraries ve Embedded Content'i bulun. Eksi işaretini(-) kullanarak aşağıdaki çerçeveyi kaldırı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 "Dosya > Paketler > En Son Paket Sürümlerine Güncelle"ye gidin.
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.
CocoaPods
kullanılarak eklenen mevcut iOS bağımlılıkları için Haritalar SDK'sını kaldırmak üzere şu adımları izleyin:
- 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 Xcodeworkspace
öğelerini CocoaPods dışında bir şey için kullanmıyorsanız kaldırın.
CocoaPods
İyimser operatör (~>
) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. Bu numara, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. iOS için Haritalar SDK'sı, semantik sürüm oluşturma ilkesine bağlıdır. Yeni ana sürümler, zarar veren değişiklikleri içerir.
Podfile söz diziminin kullanıldığı bir Podfile bağımlılığı örneği:
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 düzenli olarak yeni sürümleri kontrol edin ve sürüm özelliklerinizi güncelleyin. Yeni bir ana sürüme güncelliyorsanız geriye dönük olarak uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarına göz atın.
Swift Paket Yöneticisi
Mevcut bir proje için package
öğesini güncellemek üzere şu adımları uygulayın:
9.0.0'dan eski bir sürümden yükseltme yapıyorsanız şu bağımlılıkları kaldırmanız gerekir: yükseltmeden sonra
GoogleMapsBase
,GoogleMapsCore
veGoogleMapsM4B
.GoogleMaps
için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 Sürüm Notları'na bakın.Xcode proje yapılandırma ayarlarınızdan Frameworks, Libraries ve Embedded Content'i bulun. Eksi işaretini(-) kullanarak aşağıdaki çerçeveyi kaldırı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 "Dosya > Paketler > En Son Paket Sürümlerine Güncelle"ye gidin.
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.
Kakaoayaklar
Bir terminal penceresi açın ve
Podfile
öğelerini içeren dizine gidin:cd <path-to-project>
- iOS için Haritalar SDK'sının daha yeni bir sürümünün olup olmadığını görmek için
pod outdated
komutunu çalıştırın. - SDK'nın daha yeni bir sürümü bulunursa
Podfile
uygulamanızı bu yeni sürümle güncelleyin.Podfile
ürününüzde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme bölümüne bakın. pod update
komutunu çalıştırın.- Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini görmek için Sürüm Notları'na bakın.
- Ürün > Temizle ve ardından Ürün > Oluştur'u seçerek projenizi temizleyin ve yeniden oluşturun.
Manuel yükleme
SDK'yı Yükleme bölümünde en yeni kaynak dosyaların bağlantısını alın.
Google Cloud proje sahipleri, yeni sürümler için yoklamanın yanı sıra projelerini etkileyebilecek, geriye dönük olarak uyumsuz değişiklikler hakkında e-posta alır. Geriye dönük olarak uyumsuz değişiklikler hakkında proaktif bildirim almak için projelerinizin her birine, izlenen bir e-posta adresiyle sahip rolü atayın.