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

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

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

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

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

• Xcode версии 15.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 найдите 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.

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

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 — это менеджер зависимостей с открытым исходным кодом для проектов Swift и Objective-C Cocoa.

Если у вас еще нет инструмента 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 , до последней версии.

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

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

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

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

Быстрый

Добавьте свой ключ 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"];

Шаг 4 (необязательно). Проверьте файл манифеста конфиденциальности Apple.

Примечание. Нижеследующее актуально при развертывании приложения в интернет-магазине.

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 .