Kurulum ve Demo

Platform seçin: Android iOS

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:

İ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

  1. GitHub'dan kod örneği arşivini indirin ve arşivi açın.
  2. 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
  3. Şu komutu çalıştırın:
    pod install
  4. 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

  1. Bir terminal penceresi açın ve 1.6.1 sürümünü yükleyin: 
    sudo gem install cocoapods -v1.6.1
  2. 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 veya ObjCDemoApp.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:

  1. Aşağıdaki içe aktarma ifadesini ekleyin: 
    import GoogleMaps
  2. 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:

  1. Aşağıdaki içe aktarma ifadesini ekleyin: 
    @import GoogleMaps;
  2. 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

  1. 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.)
  2. 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.
  3. 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
  4. pod install komutunu çalıştırın.
  5. 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

  1. Carthage'ı yükleyin. Birkaç yöntem vardır. Bu gibi adımlar için Carthage BENİOKU dosyasını inceleyin.
  2. 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.)
  3. Proje dizininizde Cartfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar.
  4. 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"
  5. Cartfile dosyasını kaydedin.
  6. Bir terminal penceresinde Cartfile öğelerini içeren dizine gidin:
    cd <path-to-project>
  7. 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.
  8. Finder'da, proje dizininizde Carthage/Build/iOS altındaki indirilen çerçeve dosyalarına gidin.
  9. 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
  10. Projenizde GoogleMaps.framework öğesini sağ tıklayın ve Finder'da Göster'i seçin.
  11. Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle öğesini Resources klasöründen projenize sürükleyin. İstendiğinde, Öğeleri hedef grubun klasörüne kopyala seçeneğinin seçilmediğinden emin olun.
  12. Project Navigator'dan projenizi seçin ve uygulamanızın hedefini belirleyin.
  13. 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

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

  1. 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.)
  2. 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.
  3. Xcode projenizde File (Dosya) -> Swift Packages (Swift Paketleri) -> Add Package Dependency (Paket Bağımlılığı Ekle) seçeneğine gidin.
  4. 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.
  5. 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: