Bu sayfada, iOS için Haritalar SDK'sı için yardımcı program kitaplığının nasıl ayarlanacağı açıklanmaktadır.
Bu yardımcı programları deneyebilirsiniz:
- Demo uygulamasını yükleyip çalıştırın. Demo uygulaması, yardımcı programları denemek için gereken tüm kodları içeren bağımsız bir projedir.
- Yardımcı kitaplığı mevcut bir Xcode projesine yükleyin. Bu yardımcı programları kendi projenize ekleyin.
İsteğe bağlı olarak, CocoaPods'u yükleyin
Yardımcı program kitaplığı, Google-Maps-iOS-Utils
adlı bir CocoaPods kapsülü olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projelerinin açık kaynak bağımlılık yöneticisidir.
Henüz CocoaPods aracınız yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin:
sudo gem install cocoapods
Ayrıntılı bilgi için CocoaPods Başlangıç Kılavuzu'na bakın.
Demo uygulamasını yükleyin ve çalıştırın
Hizmet kitaplığında, yükleyebileceğiniz ve her bir yardımcı programı deneyebileceğiniz bir demo uygulaması bulunur.
Aşağıdaki iki yöntemden birini kullanarak demo uygulamasını yükleyin:GitHub dosyalarını kullan
- GitHub'dan kod örnek arşivini indirip arşivden çıkarın.
- Bir terminal penceresi açın, örnek dosyaları genişlettiğiniz dizine gidin ve kullanmak istediğiniz dilin uygun örnek dizinini ayrıntılı olarak inceleyin:
- Swift için
cd google-maps-ios-utils-master/samples/SwiftDemoApp
çalıştırın - Objective-C için
cd google-maps-ios-utils-master/samples/ObjCDemoApp
öğesini ç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ı çift tıklayın (çift tıklayın). Bu tarihten itibaren projeyi açmak için.xcworkspace
dosyasını kullanmanız gerekecek.
CocoaPods sürüm 1.6.1'i kullanma
- Bir terminal penceresi açın ve sürüm 1.6.1'i yükleyin:
sudo gem install cocoapods -v1.6.1
- Cocoapod'ları kullanarak Google Haritalar dosyalarını getirin:
pod try Google-Maps-iOS-Utils
Sorulduğunda 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.
Demo uygulamasına API anahtarını ekleme
API anahtarı al bölümünde, uygulamanız için bir API anahtarı oluşturursunuz. Şimdi bu anahtarı demo uygulaması için Xcode projesine ekleyin.Swift
API anahtarınızı AppDelegate.swift
cihazınıza şu şekilde ekleyin:
- Aşağıdaki içe aktarma ifadesini ekleyin:
import GoogleMaps
- API anahtarınızı çift tırnak 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 şu şekilde ekleyin:
- Aşağıdaki içe aktarma ifadesini ekleyin:
@import GoogleMaps;
- API anahtarınızı çift tırnak 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 uygulaması oluşturun ve çalıştırın
API anahtarını ekledikten sonra projeyi oluşturup çalıştırın:
- Demonun Swift sürümünü çalıştırıyorsanız uygulamada hangi yardımcı programın görüntüleneceğini 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ünü inceleyin.
Hizmet kitaplığını Xcode projesi olarak yükleyin
Hizmet kitaplığını Xcode çalışma alanınıza eklemek için aşağıdaki adımları uygulayın:
CocoaPods kullan
- Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız Tek Görünüm Uygulaması oluşturun.)
- Projeniz için 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 bağımlılık ekleyin. iOS için Haritalar SDK'sı ve yardımcı program kitaplığı için ihtiyaç duyduğunuz bağımlılıkları içeren bir örneği burada bulabilirsiniz:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '10.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '4.0.0' pod 'Google-Maps-iOS-Utils', '3.4.0' end
pod install
çalıştırın.- Xcode'u kapatın ve Xcode'u başlatmak için projenizin
.xcworkspace
dosyasını çift tıklayın (çift tıklayın). Bu tarihten itibaren projeyi açmak için.xcworkspace
dosyasını kullanmanız gerekecek.
Not: İşaretçi kümeleme yardımcı programı dörde göre değişir, ancak dörtlü ağacı işaretçi kümeleme olmadan kullanabilirsiniz. Yalnızca quadtree yardımcı programını kullanmak isterseniz kapsül dosyanızda pod 'Google-Maps-iOS-Utils'
öğesini 'Google-Maps-iOS-Utils/QuadTree'
olarak değiştirebilirsiniz.
Carthage'ı kullan
- Carthage'ı yükle. Birkaç yöntem vardır. Bu nedenle, tam adımlar için Carthage README dosyasına bakın.
- Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız yeni bir proje oluşturun ve iOS Uygulama şablonunu seçin. Xcode 11.7 veya önceki sürümlerde bir Tek Görünüm Uygulaması oluşturun.)
- Proje dizininizde
Cartfile
adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar. Cartfile
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
kaydedin.- Bir terminal penceresinde
Cartfile
:
cd <path-to-project>
değerini içeren dizine gidin - Güncelleme komutunu çalıştırın:
carthage update --platform iOS
Bu işlem,Cartfile
sayfasında belirtilen API'leri ve sahip olabilecekleri bağımlıları yükleyecektir. - Finder'da, proje dizininizde,
Carthage/Build/iOS
altındaki indirilen çerçeve dosyalarına gidin. - Aşağıdaki paketleri projenize sürükleyerek iOS için Haritalar SDK'sını ekleyin.
(İstendiğinde Öğeleri gerekirse kopyalayın seçeneğini belirleyin.)
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
GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework
içermelidir. - Projenizde
GoogleMaps.framework
simgesini sağ tıklayın ve Finder'da Göster'i seçin. Resources
klasöründenCarthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
öğesini projenize sürükleyin. Sizden istendiğinde, Öğeleri hedef gruba kopyala<#39;s klasörünün seçili seçili olmadığından emin olun.- Project Navigator uygulamasından projenizi ve uygulamanızın hedefini seçin.
- Uygulamanızın hedefi için Aşama Aşamaları sekmesini açın ve İkili Kitaplıkları Bağla alanına 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
ekleyin. Bu ayarlar görünmüyorsa Oluşturma Ayarları çubuğundaki Temel filtresini Tümü olarak değiştirin.
Swift Package Manager kullan
- Henüz Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmesini kullanmaya yeni başladıysanız yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin. Xcode 11.7 veya önceki sürümlerde bir Tek Görünüm Uygulaması oluşturun.)
- iOS için Haritalar SDK'sını bağımlı olarak ekleyin. Seçenekler için SDK'yı yükleme bölümüne bakın.
- Xcode projenizde File -> Swift Packages -> Add Package Dependency (Paket Bağımlısı Ekle) seçeneğine gidin.
- Açılan pencerede, iOS Yardımcı Program Kitaplığı depo URL'sini (
https://github.com/googlemaps/google-maps-ios-utils
) girin ve Next'i (Sonraki) seçin. - Bu aşamada GitHub hesabınızla kimlik doğrulaması yapmanız istenebilir. İşleme devam etmek için GitHub kişisel erişim jetonu oluşturma talimatlarını uygulayın.
- Bir sonraki pencerede, Sürüm radyo seçeneğini belirleyin, açılır listeden Tam seçeneğini belirleyin, iOS Yardımcı Program Kitaplığı için Haritalar SDK'sının en son sürümünü girin (ör. "3.4.0") ve İleri'yi seçin.
Uygulamanıza API anahtarını ekleme
API anahtarı oluşturma ve Xcode projenize ekleme talimatları için Xcode Projesi oluşturma bölümüne bakın.Projeyi oluşturun ve çalıştırın
API anahtarını ekledikten sonra projeyi oluşturup çalıştırın.
Uygulamanıza yardımcı program ekleme
Uygulamanızda kullanma hakkında daha fazla bilgi için her yardımcı programın dokümanlarına bakın: