Bu sayfada, iOS için Haritalar SDK'sı yardımcı programı kitaplığının nasıl ayarlanacağı açıklanmaktadır.
Bu yardımcı programları denemek için aşağıdakilerden birini yapabilirsiniz:
- Demo uygulamasını yükleyip çalıştırın. Demo uygulama, yardımcı programları denemek için gereken tüm kodları içeren bağımsız bir projedir.
- Yardımcı program kitaplığını mevcut bir Xcode projesine yükleyin. Bu yardımcı programları kendi projenize ekleyin.
İsteğe bağlı olarak CocoaPods yükleyin
Yardımcı program kitaplığı, Google-Maps-iOS-Utils
adlı bir CocoaPods kapsülü olarak mevcuttur. CocoaPods, Swift ve Objective-C Cocoa projeleri için açık kaynak bir bağımlılık yöneticisidir.
Halihazırda CocoaPods aracına sahip değilseniz terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin:
sudo gem install cocoapods
Ayrıntılar için CocoaPods Başlangıç Kılavuzu'na bakın.
Demo uygulamayı yükleyip çalıştırın
Yardımcı program kitaplığında, yükleyip ardından her yardımcı programı deneyebileceğiniz bir demo uygulama bulunur.
Aşağıdaki iki yöntemden birini kullanarak demo uygulamayı yükleyin:GitHub'daki dosyaları kullan
- GitHub'dan kod örneği arşivini indirin ve arşivi açın.
- Bir terminal penceresi açın, örnek dosyaları genişlettiğiniz dizine gidin ve kullanmak istediğiniz dile uygun örnek dizinini ayrıntılı olarak inceleyin:
- Swift için
cd google-maps-ios-utils-master/samples/SwiftDemoApp
komutunu çalıştırın - Objective-C için
cd google-maps-ios-utils-master/samples/ObjCDemoApp
komutunu çalıştırın
- Swift için
- Şu komutu çalıştırın:
pod install
- Xcode'u kapatın ve Xcode'u başlatmak için projenizin
.xcworkspace
dosyasını açın (çift tıklayın). Bu tarihten itibaren projeyi açmak için.xcworkspace
dosyasını kullanmanız gerekir.
CocoaPods v1.6.1'i kullanın
- Bir terminal penceresi açın ve 1.6.1 sürümünü yükleyin:
sudo gem install cocoapods -v1.6.1
- Cocoapods kullanarak Google Haritalar dosyalarını getirin:
pod try Google-Maps-iOS-Utils
İstendiğinde Swift veya Objective-C'yi seçin. CocoaPods, spesifikasyon depolarınızı günceller, ardından demoyu
SwiftDemoApp.xcodeproj
veyaObjCDemoApp.xcodeproj
adlı geçici bir Xcode projesinde açar.
API anahtarını demo uygulamaya ekleyin
API anahtarı alma bölümünde uygulamanız için bir API anahtarı oluşturursunuz. Şimdi bu anahtarı demo uygulamasının Xcode projesine ekleyin.Swift
API anahtarınızı AppDelegate.swift
cihazınıza aşağıdaki şekilde ekleyin:
- Aşağıdaki içe aktarma ifadesini ekleyin:
import GoogleMaps
- API anahtarınızı çift tırnakların arasına eklemek için aşağıdaki satırı düzenleyin:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
API anahtarınızı AppDelegate.m
cihazınıza aşağıdaki şekilde ekleyin:
- Aşağıdaki içe aktarma ifadesini ekleyin:
@import GoogleMaps;
- API anahtarınızı çift tırnakların arasına eklemek için aşağıdaki satırı düzenleyin:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Demo uygulamayı derleme ve çalıştırma
API anahtarını ekledikten sonra projeyi derleyin ve çalıştırın:
- Demonun Swift sürümünü çalıştırıyorsanız uygulamada hangi yardımcı programı görüntülemek istediğinizi seçebilirsiniz.
- Demonun Objective-C sürümünü çalıştırıyorsanız işaretçi kümeleme yardımcı programının demosunu görürsünüz. Daha sonra, her bir yardımcı programı denemek için demonun Objective-C sürümünü düzenleyebilirsiniz. Daha fazla bilgi için aşağıdaki Uygulamanıza yardımcı program ekleme bölümüne bakın.
Yardımcı program kitaplığını Xcode projesi olarak yükleyin
Yardımcı program kitaplığını Xcode çalışma alanınıza eklemek için şu adımları uygulayın:
CocoaPods kullanma
- Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmede yeniyseniz Tek Görünüm Uygulaması oluşturun.)
- Projeniz için bir kapsül dosyanız yoksa proje dizininizde
Podfile
adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. - Projenizin kapsül dosyasını düzenleyin ve
Google-Maps-iOS-Utils
kapsülüne bir bağımlılık ekleyin. iOS için Haritalar SDK'sı ve yardımcı program kitaplığı için ihtiyacınız olan bağımlılıkları içeren bir örneği aşağıda bulabilirsiniz:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.2.2' end
pod install
komutunu çalıştırın.- Xcode'u kapatın ve Xcode'u başlatmak için projenizin
.xcworkspace
dosyasını açın (çift tıklayın). Bu tarihten itibaren projeyi açmak için.xcworkspace
dosyasını kullanmanız gerekir.
Not: İşaretçi kümeleme yardımcı programı dörtlü ağa bağlıdır ancak dörtlü ağacı, işaretçi kümeleme olmadan da kullanabilirsiniz. Yalnızca dört ağaç yardımcı programını isterseniz kapsül dosyanızda pod 'Google-Maps-iOS-Utils'
değerini 'Google-Maps-iOS-Utils/QuadTree'
olarak değiştirebilirsiniz.
Carthage kullan
- Carthage'ı yükleyin. Birkaç yöntem vardır. Bu gibi adımlar için Carthage BENİOKU dosyasını inceleyin.
- Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirme konusunda yeniyseniz yeni bir proje oluşturun ve iOS uygulaması şablonunu seçin. Xcode 11.7 veya önceki sürümlerde Single View Uygulaması oluşturun.)
- Proje dizininizde
Cartfile
adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Cartfile
öğesini düzenleyin ve iOS Yardımcı Program Kitaplığı bağımlılığı için Haritalar SDK'sını ekleyin:
github "googlemaps/google-maps-ios-utils"
Cartfile
dosyasını kaydedin.- Bir terminal penceresinde
Cartfile
öğelerini içeren dizine gidin:
cd <path-to-project>
- Güncelleme komutunu çalıştırın:
carthage update --platform iOS
Bu işlem,Cartfile
politikasında belirtilen API'leri ve olabilecek bağımlılıklarını yükler. - Finder'da, proje dizininizde
Carthage/Build/iOS
altındaki indirilen çerçeve dosyalarına gidin. - Aşağıdaki paketleri projenize sürükleyerek iOS çerçeveleri için Haritalar SDK'sını projenize ekleyin.
(İstendiğinde, Gerekiyorsa öğeleri kopyala'yı seçin. Lütfen yukarıdakiyle aynı sürümü kullanın.)
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
- Projenizde
GoogleMaps.framework
öğesini sağ tıklayın ve Finder'da Göster'i seçin. Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
öğesiniResources
klasöründen projenize sürükleyin. İstendiğinde, Öğeleri hedef grubun klasörüne kopyala seçeneğinin seçilmediğinden emin olun.- Project Navigator'dan projenizi seçin ve uygulamanızın hedefini belirleyin.
- Uygulamanızın hedefi için Derleme Aşamaları sekmesini açın ve İkili Programı Kitaplıklara Bağla bölümünde, aşağıdaki çerçeveleri ekleyin:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümüne
-ObjC
kodunu ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki Temel olan filtreyi Tümü olarak değiştirin.
Swift Package Manager'ı kullanma
- Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS uygulama geliştirme konusunda yeniyseniz yeni bir proje oluşturun ve iOS uygulaması şablonunu seçin. Xcode 11.7 veya daha eski sürümlerde Single View Uygulaması oluşturun.)
- iOS için Haritalar SDK'sını bağımlılık olarak ekleyin. Seçenekler için SDK'yı yükleme bölümüne bakın.
- Xcode projenizde File (Dosya) -> Swift Packages (Swift Paketleri) -> Add Package Dependency (Paket Bağımlılığı Ekle) seçeneğine gidin.
- Sunulan pencerede, iOS için Haritalar SDK'sı Yardım Kitaplığı depo URL'sini (
https://github.com/googlemaps/google-maps-ios-utils
) girin ve İleri'yi seçin. - Bu noktada GitHub hesabınızla kimliğinizi doğrulamanız istenebilir. İşleme devam etmek için talimatları uygulayarak bir GitHub kişisel erişim jetonu oluşturun.
- Sonraki pencerede Sürüm radyo seçeneğini belirleyin, açılır listeden Tam'ı seçin, iOS Yardımcı Program Kitaplığı için Haritalar SDK'sının en son sürümünü (ör. "3.4.0") girin ve İleri'yi seçin.
API anahtarını uygulamanıza ekleme
API anahtarı oluşturma ve bunu Xcode projenize ekleme ile ilgili talimatlar için Xcode Projesi oluşturma bölümüne bakın.Projeyi derleme ve çalıştırma
API anahtarını ekledikten sonra projeyi derleyip çalıştırın.
Uygulamanıza yardımcı program ekleyin
Uygulamanızda kullanma hakkında daha fazla bilgi için yardımcı programlarla ilgili dokümanlara bakın: