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

Swift Package Manager

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

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

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

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

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

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

   • GoogleMapsBase (Только для обновлений с версий ниже 9.0.0)
   • GoogleMapsCore (только для обновлений с версий ниже 9.0.0)
   • GoogleMapsM4B (Только для обновлений с версий ниже 9.0.0)
2. В Xcode перейдите в меню "Файл > Пакеты > Обновить до последних версий пакетов".
3. Чтобы проверить установку, перейдите в раздел «Зависимости пакетов» в 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 и workspace Xcode, если вы используете их только для CocoaPods.

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

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

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

1. Загрузите следующие исполняемые файлы SDK и файлы ресурсов:
   • Google Карты
   • GoogleКартыРесурсы
2. Распакуйте файлы, чтобы получить доступ к XCFrameworks и ресурсам.
3. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. Если вы новичок в разработке под iOS:
   1. Создать новый проект.
   2. Выберите шаблон iOS > Приложение .
   3. На экране параметров проекта:
      1. Введите название проекта .
      2. Запишите значение поля «Идентификатор пакета» . Вы можете использовать это значение для ограничения доступа к вашему API-ключу ниже.
      3. Установите для проекта интерфейс «Раскадровка» .
      4. Выберите язык программирования Swift или Objective-C .
4. Откройте вкладку «Общие» . Перетащите следующие XCFrameworks в свой проект в разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Убедитесь, что выбран параметр «Не встраивать» :
   • GoogleMaps.xcframework
5. Скопируйте файл GoogleMaps.bundle из загруженного вами репозитория GoogleMapsResources в корневую директорию вашего проекта Xcode. При появлении соответствующего запроса обязательно выберите опцию «Копировать элементы в папку целевой группы» .
6. Выберите свой проект в навигаторе проектов и укажите целевую платформу для вашего приложения.
7. Откройте вкладку «Этапы сборки» для целевого объекта вашего приложения. В разделе «Связывание бинарных файлов с библиотеками» добавьте следующие фреймворки и библиотеки:
   • 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. Выберите свой проект, а не конкретную целевую платформу, и откройте вкладку «Параметры сборки ». В разделе «Компоновка — Общие» -> «Другие флаги компоновщика» добавьте -ObjC к значениям «Отладка» и «Выпуск». Если эти параметры не отображаются, измените фильтр на панели параметров сборки с «Основные» на «Все» .

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

CocoaPods

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

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

sudo gem install cocoapods

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

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

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

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"];