Как настроить проект Xcode

Swift Package Manager

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

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

1. Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
2. Введите URL https://github.com/googlemaps/ios-maps-sdk, нажмите Ввод, чтобы получить пакет, и нажмите "Добавить пакет".
3. Чтобы установить определенную версию version, задайте для поля Правило зависимости одно из значений, связанных с версией. Для новых проектов рекомендуется указывать последнюю версию и выбирать вариант "Точная версия". Затем нажмите "Добавить пакет".
4. В окне Choose Package Products (Выбор продуктов пакета) убедитесь, что GoogleMaps (для версий до 9.0.0 – GoogleMaps, GoogleMapsBase и GoogleMapsCore) будет добавлен в указанную цель main. Затем нажмите "Добавить пакет".
5. Чтобы проверить установку, перейдите на панель General (Общие). Установленные пакеты должны появиться в разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Вы также можете проверить пакет и его версию в разделе Package Dependencies (Зависимости пакета) в Project Navigator (Навигаторе проекта).

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

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

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

   • GoogleMapsBase (только для обновления с версий ниже 9.0.0)
   • GoogleMapsCore (только для обновления с версий ниже 9.0.0)
   • GoogleMapsM4B (только для обновления с версий ниже 9.0.0)
2. В Xcode выберите File (Файл) > Packages (Пакеты) > Update To Latest Package Versions (Обновить до последних версий пакетов).
3. Чтобы проверить установку, перейдите в раздел Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта) и проверьте пакет и его версию.

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

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

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

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

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

Установка вручную

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

1. Скачайте следующие исполняемые файлы SDK и файлы ресурсов:
   • GoogleMaps
   • GoogleMapsResources
2. Извлеките файлы, чтобы получить доступ к XCFrameworks и ресурсам.
3. Если у вас ещё нет проекта Xcode, создайте его и сохраните на локальном компьютере. Если вы только начинаете разрабатывать приложения для iOS:
   1. Создайте новый проект.
   2. Выберите шаблон iOS > App (iOS > Приложение).
   3. На экране параметров проекта:
      1. Укажите название проекта.
      2. Запишите значение поля Идентификатор пакета. Это значение можно использовать, чтобы ограничить ключ API.
      3. В разделе Интерфейс выберите Раскадровка.
      4. В поле Language (Язык) выберите Swift или Objective-C.
4. Откройте вкладку Общие. Перетащите следующие XCFrameworks в проект в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент). Убедитесь, что выбран вариант Do Not Embed (Не встраивать).
   • GoogleMaps.xcframework
5. Скопируйте файл GoogleMaps.bundle из скачанного пакета GoogleMapsResources в каталог верхнего уровня проекта Xcode. При появлении запроса выберите Скопировать объекты в папку целевой группы.
6. Выберите проект в навигаторе проектов и укажите цель приложения.
7. Откройте вкладку Build Phases (Этапы сборки) для целевого объекта приложения. В разделе 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
   • MetricKit.framework
   • OpenGLES.framework (только если вы используете OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Выберите проект, а не конкретную цель, и откройте вкладку Build Settings (Настройки сборки). В разделе Linking - General (Связывание – Общие) -> Other Linker Flags (Другие флаги компоновщика) добавьте -ObjC в Debug (Отладка) и Release (Выпуск). Если эти настройки не видны, измените фильтр на панели Build Settings (Настройки сборки) с Basic (Основные) на All (Все).

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

Swift

Чтобы добавить ключ API в AppDelegate.swift, выполните указанные ниже действия:

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

   import GoogleMaps

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

   GMSServices.provideAPIKey("YOUR_API_KEY")

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

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Чтобы добавить ключ API в AppDelegate.m, выполните указанные ниже действия:

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

   @import GoogleMaps;

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

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];