Настроить проект Xcode

Менеджер пакетов Swift

Navigation SDK можно установить через Swift Package Manager . Чтобы добавить SDK, убедитесь, что вы удалили все существующие зависимости Navigation SDK.

Чтобы добавить SDK в новый или существующий проект, выполните следующие действия:

1. Откройте project или workspace Xcode, затем перейдите в Файл > Добавить зависимости пакета .
2. Введите https://github.com/googlemaps/ios-navigation-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
3. Чтобы установить определённую version , выберите в поле «Правило зависимости» один из вариантов, основанных на версии. Для новых проектов мы рекомендуем указать последнюю версию и использовать параметр «Точная версия». После завершения нажмите «Добавить пакет».

Чтобы обновить package для существующего проекта, выполните следующие действия:

1. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в Project Navigator, чтобы проверить пакет и его версию.

1. В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) , чтобы удалить следующий фреймворк:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Из каталога верхнего уровня вашего проекта Xcode удалите пакет GoogleMaps .

Ручная установка

В этом руководстве показано, как вручную добавить XCFrameworks, содержащий Navigation SDK для iOS, и Maps SDK для iOS в ваш проект, а также настроить параметры сборки в Xcode. XCFramework — это двоичный пакет, который можно использовать на нескольких платформах, включая устройства с чипсетом M1.

Чтобы установить XCFrameworks для Navigation SDK для iOS и Maps SDK для iOS, выполните следующие действия:

1. Загрузите следующие двоичные файлы SDK и файлы ресурсов:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Запустите Xcode и откройте существующий проект или создайте новый. Если вы новичок в iOS, создайте новый проект и выберите шаблон iOS App .
3. Удалите из проекта все существующие ссылки на карты, навигацию и места.
4. Перетащите следующие XCFrameworks в свой проект в разделы «Фреймворки», «Библиотеки» и «Встроенное содержимое» , чтобы установить SDK карт и навигации (при появлении соответствующего запроса выберите «Копировать элементы», если необходимо ):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Перетащите GoogleMaps.bundle из папки GoogleMapsResources, загруженной вами, в корневой каталог вашего проекта Xcode. При появлении запроса убедитесь, что выбран пункт «Копировать элементы при необходимости» .
6. Перетащите GoogleNavigation.bundle из скачанного вами файла GoogleNavigationResources в корневой каталог вашего проекта Xcode. При появлении запроса убедитесь, что выбран параметр «Копировать элементы в папку целевой группы» .
7. Выберите свой проект в Навигаторе проектов и укажите цель вашего приложения.
8. Откройте вкладку «Фазы сборки» и в разделе «Связать двоичный файл с библиотеками» добавьте следующие фреймворки и библиотеки:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.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
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. В целевом объекте вашего приложения выберите вкладку Возможности , включите Фоновые режимы и включите следующие режимы:
   • Аудио, AirPlay и «картинка в картинке»
   • Обновления местоположения
10. Выберите свой проект, а не конкретную цель, и откройте вкладку «Параметры сборки» . В разделе «Другие флаги компоновщика» добавьте ‑ObjC для параметров debug и release . Если эти параметры не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .
11. Откройте Info.plist и добавьте следующие пары ключ-значение:
    • Ключ: NSLocationWhenInUseUsageDescription ( Конфиденциальность - Местоположение, когда используется, использование, описание )
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».
    • Ключ: NSLocationAlwaysAndWhenInUseUsageDescription ( Конфиденциальность — Местоположение всегда и при использовании Описание использования )
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».

CocoaPods

Navigation SDK для iOS доступен в виде модуля CocoaPods . CocoaPods — это менеджер зависимостей с открытым исходным кодом для проектов Cocoa на Swift и Objective-C.

Если у вас ещё нет инструмента CocoaPods, установите его в macOS, выполнив следующую команду в терминале. Подробнее см. в руководстве по началу работы с CocoaPods .

sudo gem install cocoapods

Создайте Podfile для Navigation SDK для iOS и используйте его для установки API и его зависимостей:

1. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. Если вы новичок в разработке для iOS:
   1. Создайте новый проект.
   2. Выберите шаблон iOS > Приложение .
   3. На экране параметров проекта:
      1. Введите название проекта .
      2. Запишите значение поля «Идентификатор пакета» . Вы можете использовать это значение для ограничения вашего ключа API ниже.
      3. Установите Интерфейс проекта на Раскадровку .
      4. Установите язык Swift или Objective-C .
2. Создайте файл Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
3. Отредактируйте Podfile и добавьте зависимости вместе с их версиями . Вот пример, включающий зависимость, необходимую для Navigation SDK для iOS: # Ссылка на установку Cocoapods #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '10.4.0'
   end
           

   Регулярно запускайте pod outdated для обнаружения новых версий. При необходимости обновите до последней версии .
4. Сохраните Podfile .

5. Откройте терминал и перейдите в каталог, содержащий Podfile :

   cd <path-to-project>

6. Выполните команду pod install . Это установит API, указанные в Podfile , вместе со всеми зависимостями.

   pod install

7. Закройте Xcode и дважды щёлкните по файлу .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента для открытия проекта необходимо использовать файл .xcworkspace .

Чтобы обновить API для существующего проекта, выполните следующие действия:

1. Откройте терминал и перейдите в каталог проекта, содержащий Podfile .
2. Выполните команду pod update . Это обновит все API, указанные в Podfile до последней версии.

Быстрый

Добавьте свой ключ API в AppDelegate.swift следующим образом:

1. Добавьте следующие операторы импорта:

   import GoogleMaps
   import GoogleNavigation

2. Добавьте следующее в метод application(_:didFinishLaunchingWithOptions:) :

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

Добавьте свой ключ API в AppDelegate.m следующим образом:

1. Добавьте следующие операторы импорта:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Добавьте в application:didFinishLaunchingWithOptions: следующее:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];