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

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

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

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

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

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

1. Если вы выполняете обновление с версии более ранней, чем 9.0.0, после обновления необходимо удалить следующие зависимости: GoogleMapsBase , GoogleMapsCore и GoogleMapsM4B . Не удаляйте зависимость для GoogleMaps . Дополнительную информацию см. в примечаниях к выпуску версии 9.0.0 .

   В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:

   • GoogleMapsBase (только для обновлений с версий ранее 9.0.0)
   • GoogleMapsCore (только для обновлений с версий ранее 9.0.0)
   • GoogleMapsM4B (только для обновлений с версий ранее 9.0.0)
2. В Xcode перейдите в «Файл» > «Пакеты» > «Обновить до последних версий пакетов».
3. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в «Навигаторе проекта», чтобы проверить пакет и его версию.

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

1. Закройте рабочую область Xcode. Откройте терминал и выполните следующую команду:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Удалите Podfile , Podfile.resolved и workspace Xcode, если вы не используете их ни для чего, кроме CocoaPods.

1. В настройках конфигурации проекта Xcode найдите Frameworks, Libraries и Embedded Content . Используйте знак минус (-), чтобы удалить следующую структуру:
   • GoogleMaps
   • GoogleMapsBase (только для установок до версии 9.2.0)
   • GoogleMapsCore (только для установок до версии 9.2.0)
   • GoogleMapsM4B (только для установок до версии 9.0.0)
2. Из каталога верхнего уровня вашего проекта Xcode удалите пакет GoogleMaps .

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

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

1. Загрузите следующие двоичные файлы SDK и файлы ресурсов:
   • GoogleКарты
   • GoogleMapsM4B
   • GoogleMapsРесурсы
2. Извлеките файлы, чтобы получить доступ к XCFrameworks и ресурсам.
3. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. Если вы новичок в разработке для iOS:
   1. Создайте новый проект.
   2. Выберите iOS > Шаблон приложения .
   3. На экране опций проекта:
      1. Введите название проекта .
      2. Запишите значение поля идентификатора пакета . Вы можете использовать это значение, чтобы ограничить свой ключ API ниже.
      3. Установите для интерфейса проекта значение Storyboard .
      4. Установите язык Swift или Objective-C .
4. Откройте вкладку «Общие» . Перетащите следующий XCFramework в свой проект в разделе «Платформы, библиотеки и встроенный контент» . Обязательно выберите «Не вставлять» :
   • GoogleMaps.xcframework
5. Скопируйте GoogleMaps.bundle из загруженного вами GoogleMapsResources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса обязательно выберите «Копировать элементы в папку целевой группы» .
6. Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
7. Откройте вкладку «Фазы сборки» для цели вашего приложения. В Link Binary with Libraries добавьте следующие платформы и библиотеки:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework (только если вы используете OpenGL)
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Связывание — Общие -> Другие флаги компоновщика» добавьте -ObjC в поля «Отладка» и «Выпуск». Если эти параметры не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .

9. Чтобы установить Places SDK для iOS XCFramework, см. раздел Начало работы с Places SDK для iOS .

Какао-стручки

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

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

sudo gem install cocoapods

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

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

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '9.2.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

2. Добавьте в свой application(_:didFinishLaunchingWithOptions:) следующее, используя свой ключ API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Если вы также используете Places API, добавьте свой ключ еще раз, как показано здесь:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Цель-C

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

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

   @import GoogleMaps;

2. Добавьте в свое application:didFinishLaunchingWithOptions: используя свой ключ API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Если вы также используете Places API, добавьте свой ключ еще раз, как показано здесь:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];