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

После включения биллинга и создания ключа API вы готовы настроить проект Xcode, который вы используете для разработки своего приложения.

Примечания к выпуску доступны для каждого выпуска.

Шаг 1: Установите необходимое программное обеспечение

Чтобы создать проект с использованием Maps SDK для iOS, необходимо загрузить и установить:

• Xcode версии 16.0 или более поздней

Шаг 2: Создайте проект Xcode и установите Maps SDK для iOS

Примечание: Maps SDK для iOS добавляет средний размер IPA-файла 5,7 МБ для приложений, разработанных для конкретных устройств. Размер загружаемых файлов универсальных приложений может быть больше.

Размер установочного SDK может варьироваться. Например, размер установочного файла Maps SDK для iOS версии 9.0 составляет около 18 МБ.

Примечание: Начиная с версии 9.2.0, GoogleMapsCore и GoogleMapsBase объединены в GoogleMaps XCFramework. Дополнительная настройка не требуется.

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

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

Важно: данные инструкции подразумевают использование Xcode 15 или более поздней версии, но должны быть аналогичны и для предыдущих версий Xcode.

Чтобы добавить 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 найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) , чтобы удалить следующий фреймворк:

   • 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.

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

1. В настройках проекта Xcode найдите разделы «Фреймворки», «Библиотеки» и «Встроенный контент» . Используйте знак минус (-) , чтобы удалить следующий фреймворк:
   • 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 и файлы ресурсов:
   • GoogleMaps
   • GoogleMapsResources
2. Извлеките файлы для доступа к XCFrameworks и ресурсам.
3. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. Если вы новичок в разработке для iOS:
   1. Создайте новый проект.
   2. Выберите шаблон iOS > Приложение .
   3. На экране параметров проекта:
      1. Введите название проекта .
      2. Запишите значение поля «Идентификатор пакета» . Вы можете использовать это значение для ограничения вашего ключа API ниже.
      3. Установите Интерфейс проекта на Раскадровку .
      4. Установите язык Swift или Objective-C .
4. Откройте вкладку «Общие» . Перетащите следующий XCFramework в свой проект в раздел «Фреймворки», «Библиотеки» и «Встроенное содержимое» . Убедитесь, что выбран параметр «Не встраивать» :
   • 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
   • OpenGLES.framework (только если вы используете OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

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

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

CocoaPods

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. Установите Интерфейс проекта на Раскадровку .
      4. Установите язык Swift или Objective-C .
2. Создайте файл Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
3. Отредактируйте Podfile и добавьте зависимости вместе с их версиями . Вот пример, включающий зависимость, необходимую для Maps SDK для iOS:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '10.1.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 , до последней версии.

Шаг 3: Добавьте свой ключ API в проект

В разделе «Получить ключ API» вы сгенерировали ключ API для своего приложения. Теперь добавьте этот ключ в свой проект Xcode.

В следующих примерах замените YOUR_API_KEY на ваш ключ API.

Примечание: Если вы записали идентификатор пакета (Bundle identifier) своего проекта или получили его из свойств проекта, вы можете использовать его, чтобы ограничить использование ключа API только приложениями iOS с этим идентификатором пакета. Подробнее см. в разделе Ограничение ключей API .

Быстрый

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

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

   import GoogleMaps

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

   GMSServices.provideAPIKey("YOUR_API_KEY")

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

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

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

   @import GoogleMaps;

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

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Шаг 4 (необязательно): проверьте файл Apple Privacy Manifest

Примечание: Следующая информация актуальна при размещении приложения в интернет-магазине.

Apple требует предоставления сведений о конфиденциальности приложений в App Store. Посетите страницу сведений о конфиденциальности Apple App Store для получения обновлений и дополнительной информации.

Файл манифеста конфиденциальности Apple входит в комплект ресурсов SDK. Чтобы убедиться в наличии файла манифеста конфиденциальности и изучить его содержимое, создайте архив приложения и сгенерируйте отчёт о конфиденциальности на основе архива.

Шаг 5 (необязательно): Объявите схемы URL, используемые API.

Начиная с iOS 9 и Xcode 7, приложения могут объявлять схемы URL, которые они намерены открыть, указывая их в файле Info.plist приложения. Maps SDK для iOS открывает мобильное приложение Google Maps, когда пользователь нажимает на логотип Google на карте, и, таким образом, ваше приложение может объявлять соответствующие схемы URL.

Чтобы объявить схемы URL, используемые Maps SDK для iOS, добавьте следующие строки в файл Info.plist :

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

На следующем снимке экрана показана конфигурация в пользовательском интерфейсе Xcode:

Без вышеуказанного заявления при нажатии пользователем логотипа Google на карте могут возникнуть следующие ошибки:

• -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
• -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Чтобы устранить эти ошибки, добавьте объявление в ваш Info.plist .

Что дальше?

Теперь, когда у вас есть ключ API и проект Xcode, вы можете создавать и запускать приложения. Navigation SDK для iOS содержит множество обучающих материалов и примеров приложений, которые помогут вам начать работу. Подробнее см.:

• В качестве отправной точки рекомендуется использовать следующие учебные пособия:
  • Добавить карту с маркером .
  • Выберите текущее место и покажите подробности на карте .
  • Обратное геокодирование .
• Ознакомьтесь с доступными примерами кода и практическими заданиями .
• Для комплексных решений ознакомьтесь с доступными решениями Maps .