Xcode projesi oluşturma

Faturalandırmayı etkinleştirip bir API anahtarı oluşturduktan sonra Xcode'u kurmaya hazır olursunuz. kullanacağınız bir başka proje olabilir.

Her sürüm için sürüm notları mevcuttur kullanabilirsiniz.

1. Adım: Gerekli yazılımı yükleyin

iOS için Navigasyon SDK'sını kullanarak proje oluşturmak istiyorsanız şunları indirip yüklemeniz gerekir:

  • Xcode 15.0 sürümü veya sonraki sürümler

2. Adım: Xcode projesini oluşturun ve Navigation SDK'yı yükleyin

Swift Paket Yöneticisi

Navigasyon SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Gezinme SDK'sı bağımlılıklarını kaldırmıştır.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

  1. Xcode project veya workspace dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin.
  2. URL olarak https://github.com/googlemaps/ios-navigation-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
  3. 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.
  4. Paket Ürünlerini Seçin penceresinde, GoogleNavigation öğesinin şuraya ekleneceğini doğrulayın: belirlediğiniz main hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  5. 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:

  1. 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 sonra GoogleMapsM4B. 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)
  2. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
  3. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
ziyaret edin.

CocoaPods, aşağıdaki adımları uygulayın:

  1. 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
  2. Podfile, Podfile.resolved ve CocoaPods dışında bir şey için kullanmıyorsanız Xcode workspace.

iOS için manuel olarak yüklenmiş mevcut gezinme SDK'sını kaldırmak üzere şu adımları uygulayın:
  1. 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:
    • GoogleMaps.xcframework
    • GoogleMapsBase.xcframework
    • GoogleMapsCore.xcframework
    • GoogleNavigation.xcframework
  2. Xcode projenizin üst düzey dizininden GoogleMaps öğesini kaldırın. paket.

CocoaPods

iOS için Navigasyon SDK'sı CocoaPods kapsülü. CocoaPods, Swift ve Objective-C için açık kaynaklı bir bağımlılık yöneticisidir. Kakao projeleri.

CocoaPods aracınız henüz yoksa şu tarihe kadar macOS'e yükleyin: aşağıdaki komutu terminalden çalıştırın. Ayrıntılı bilgi için CocoaPods Başlangıç kılavuzu.

sudo gem install cocoapods

iOS için Navigasyon SDK'sı için bir Podfile oluşturun ve yüklemeniz gerekir:

  1. Henüz bir Xcode projeniz yoksa şimdi bir tane oluşturun ve yerel makinenize bakın. iOS uygulaması geliştirme konusunda yeniyseniz:
    1. Yeni proje oluşturun.
    2. iOS > Uygulama şablonu.
    3. Proje seçenekleri ekranında:
      1. Proje Adı'nı girin.
      2. Paket tanımlayıcısı alanının değerini kaydedin. Aşağıdaki API anahtarınızı kısıtlamak için bu değeri kullanabilirsiniz.
      3. Interface projesini Resimli Taslak olarak ayarlayın.
      4. Dil'i Swift veya Objective-C olarak ayarlayın.
  2. Proje dizininizde Podfile adlı bir dosya oluşturun. Bu projenizin bağımlılıklarını tanımlar.
  3. Podfile öğesini düzenleyin ve bağımlılıklarınızla birlikte ekleyin. sürümlerini ziyaret edin. Aşağıda, iOS için Navigasyon SDK'sı: # Cocoapods yükleme referansı numarası
    source 'https://github.com/CocoaPods/Specs.git'
    
    platform :ios, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleNavigation', '9.1.0'
    end
            
    Daha yenilerini tespit etmek için pod outdated uygulamasını düzenli olarak çalıştırdığınızdan emin olun sürümleri vardır. Gerekirse, yeni sürüme geçin yükleyin.
  4. Podfile dosyasını kaydedin.
  5. Bir terminal penceresi açın ve Podfile öğesini içeren dizine gidin:

    cd <path-to-project>
  6. pod install komutunu çalıştırın. Bu işlem, Bağımlılıklarla birlikte Podfile öğesinde belirtilen API'ler.

    pod install
  7. Xcode'u kapatın ve ardından projenizin klasörünü açın (çift tıklayın) .xcworkspace dosyasını kullanarak Xcode'u başlatın. Bu andan itibaren, projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

Mevcut bir projenin API'sini güncellemek için şu adımları izleyin:

  1. Bir terminal penceresi açın ve Podfile öğesini içeren proje dizinine gidin.
  2. pod update komutunu çalıştırın. Bu işlem tüm API'leri günceller Podfile sürümdeki en son sürüme güncelleyin.

Manuel yükleme

Bu kılavuzda, iOS için Navigasyon SDK'sını ve iOS için Haritalar SDK'sını projenize ekleyin ve derleme ayarlarınızı Xcode'da yapılandırın. XCFramework, M1 yonga seti kullanan makineler dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili programdır.

iOS için Navigasyon SDK'sı için XCFrameworks'ü yüklemek üzere şu adımları uygulayın: ve iOS için Haritalar SDK'sı:

  1. Aşağıdaki SDK ikili programlarını ve kaynak dosyalarını indirin:
  2. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun belirler. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS uygulaması şablonu.
  3. Projeden mevcut tüm Haritalar, Navigasyon ve Yerler referanslarını kaldırın.
  4. Aşağıdaki XCFrameworks'ü projenize sürükleyin Hem Google Haritalar'ı hem de Google Haritalar'ı yüklemek için Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik ve Gezinme SDK'ları (istendiğinde Gerekirse öğeleri kopyala'yı seçin):
    • GoogleMaps.xcframework
    • GoogleMapsBase.xcframework
    • GoogleMapsCore.xcframework
    • GoogleNavigation.xcframework
  5. GoogleMaps.bundle adlı yeri, indirdiğiniz GoogleMapsResources'tan sürükleyin Xcode projenizin en üst düzey dizinine dizin. İstendiğinde Gerekirse öğeleri kopyala'nın seçili olduğundan emin olun.
  6. İndirdiğiniz GoogleNavigationResources'ndan GoogleNavigation.bundle simgesini sürükleyin Xcode projenizin en üst düzey dizinine dizin. İstendiğinde Öğeleri hedef grubun klasörüne kopyala seçili.
  7. Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.
  8. Derleme Aşamaları sekmesini açın ve İkili Program'ı Kitaplıklarla Bağla'yı seçtikten sonra aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. Uygulamanızın hedefinde Özellikler sekmesini seçin, Arka Plan Modları'nı açın ve aşağıdaki modları etkinleştirin:
    • Ses, AirPlay ve Pencere İçinde Pencere
    • Konum güncellemeleri
  10. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarlar sekmesi. Diğer Bağlayıcı İşaretleri bölümünde Hem hata ayıklama hem de yayınlama için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa filtreyi Derleme Ayarları çubuğunu Temel yerine Tümü olarak ayarlayın.
  11. Info.plist dosyasını açın ve aşağıdaki anahtar/değer çiftlerini ekleyin:
    • Anahtar: NSLocationWhenInUseUsageDescription (Gizlilik - Kullanımda Olduğunda Konum Kullanım Açıklaması)
      Değer: "Bu uygulamanın adım adım navigasyon için konumunuzu kullanması için izin gerekiyor."
    • Anahtar: NSLocationAlwaysAndWhenInUseUsageDescription (Gizlilik - Konum Her Zaman ve Kullanıldığında Kullanım Açıklaması)
      Değer: "Bu uygulamanın adım adım navigasyon için konumunuzu kullanması için izin gerekiyor."

3. Adım: Apple Gizlilik Manifest dosyasını inceleyin

Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple Gizlilik Manifest dosyası, SDK'nın kaynak paketinde yer almaktadır. Gizlilik Manifest Dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturup arşivden bir gizlilik raporu oluşturun.

4. Adım: API anahtarınızı projeye ekleyin

Aşağıdaki örneklerde, Xcode'da projenize API anahtarının nasıl ekleneceği gösterilmiştir:

Swift

API anahtarınızı AppDelegate.swift cihazınıza aşağıdaki şekilde ekleyin:

  1. Aşağıdaki import (içe aktarma) ifadelerini ekleyin:
    import GoogleMaps
    import GoogleNavigation
  2. Şunları ekleyin: application(_:didFinishLaunchingWithOptions:) yöntem:
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

API anahtarınızı AppDelegate.m cihazınıza aşağıdaki şekilde ekleyin:

  1. Aşağıdaki import (içe aktarma) ifadelerini ekleyin:
    @import GoogleMaps;
    @import GoogleNavigation;
  2. Şunları ekleyin: application:didFinishLaunchingWithOptions: yöntem:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

5. Adım: Bir harita ekleyin

Bu kod, mevcut bir ViewController öğesine basit bir haritanın nasıl ekleneceğini göstermektedir. ve gezinmeye ilişkin bazı ilk ayarlar dahil.

Navigasyonun etkinleştirilebilmesi için kullanıcı, şartları ve koşulları koşullar. Kullanıcıya istem göndermek için şu numarayı arayın: GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(), ardından kontrol edin şartların kabul edilip edilmediğini kontrol edin. Kullanıcı şartları reddederse mapView.isNavigationEnabled = true etkisi yoktur ve mapView.navigator için geçerlidir nil.

Swift

import UIKit
import GoogleNavigation

class ViewController: UIViewController {

  var mapView: GMSMapView!
  var locationManager: CLLocationManager!

  override func loadView() {
    locationManager = CLLocationManager()
    locationManager.requestAlwaysAuthorization()

    let options = GMSMapViewOptions()
    options.camera = camera
    options.frame = .zero
    mapView = GMSMapView(options: options)

    // Show the terms and conditions.
    let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Share Co.")

    GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(with: termsAndConditionsOptions) { termsAccepted in
      if termsAccepted {
        // Enable navigation if the user accepts the terms.
        self.mapView.isNavigationEnabled = true
      } else {
        // Handle the case when the user rejects the terms and conditions.
      }
    }

    view = mapView
  }

  // TODO: Add navigation code.

}

Objective-C

#import "ViewController.h"
@import GoogleNavigation;

@interface ViewController ()
@end

@implementation ViewController
GMSMapView *_mapView;
CLLocationManager *_locationManager;

-   (void)loadView {

  _locationManager = [[CLLocationManager alloc] init];
  [_locationManager requestAlwaysAuthorization];

  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67
                                                          longitude:-122.20
                                                               zoom:14];
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.frame = CGRectZero;
  options.camera = camera;
  options.mapID = mapID;
  _mapView = [[GMSMapView alloc] initWithOptions:options];

  // Show the terms and conditions.
  GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];
  
  [GMSNavigationServices
    showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
    callback:^(BOOL termsAccepted) {
     if (termsAccepted) {
       // Enable navigation if the user accepts the terms.
       _mapView.navigationEnabled = YES;
     } else {
       // Handle the case when the user rejects the terms and conditions.
     }
   }];

  self.view = _mapView;
}

// TODO: Add navigation code.

@end

Uygulamanızı çalıştırın. Kirkland, Washington'ın merkezinde bir harita göreceksiniz.

Harita görünmüyorsa aşağıdakileri deneyin:

  • Doğru API anahtarını sağladığınızdan emin olun.
  • Cloud Console'da NavSDK'nın etkin olduğundan emin olun.
  • Nav SDK yüklüyse ancak projeniz Nav SDK API'lerini kullanmıyorsa onu ikili programınızdan kaldırın.

Mobilite Hizmetleri müşterisiyseniz

Mobilite Hizmetleri müşterisiyseniz faturalandırma hakkında bilgi edinin. Mobilite belgelerini inceleyin. Kaydetme hakkında daha fazla bilgi için işlemleri görmek için Faturalandırma ayarlarını yapın. Gezinme SDK'sı uygulamanıza nasıl işlem kimliği ekleyeceğinizi öğrenmek için şu sayfayı ziyaret edin: Hizmet kullanımınızı Mobilite işlemleriyle ilişkilendirin.

Sırada ne var?

Artık bir API anahtarınız ve Xcode projeniz var. Şimdi uygulamalar oluşturup çalıştırabilirsiniz. iOS için Navigasyon SDK'sı, . Ayrıntılı bilgi için: