Настройка и демонстрация

Выберите платформу: Android iOS .

На этой странице описано, как настроить библиотеку утилит для Maps SDK для iOS .

Чтобы попробовать эти утилиты, вы можете:

При желании установите CocoaPods

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

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

sudo gem install cocoapods

Подробности см. в руководстве по началу работы с CocoaPods .

Установите и запустите демо-приложение

Библиотека утилит включает демонстрационное приложение, которое вы можете установить, а затем опробовать каждую утилиту.

Установите демонстрационное приложение одним из этих двух способов:

Используйте файлы с GitHub

  1. Загрузите архив примера кода с GitHub и распакуйте архив.
  2. Откройте окно терминала, перейдите в каталог, в котором вы развернули файлы примеров, и перейдите к соответствующему каталогу примеров для языка, который вы хотите использовать:
    • Для Swift запустите cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • Для Objective-C запустите cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. Выполните следующую команду:
    pod install
  4. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

Используйте CocoaPods v1.6.1

  1. Откройте окно терминала и установите версию 1.6.1:
    sudo gem install cocoapods -v1.6.1
  2. Получите файлы Google Maps с помощью Cocoapods:
    pod try Google-Maps-iOS-Utils

    При появлении запроса выберите Swift или Objective-C. CocoaPods обновляет ваши репозитории спецификаций, а затем открывает демо-версию во временном проекте Xcode с именем SwiftDemoApp.xcodeproj или ObjCDemoApp.xcodeproj .

Добавьте ключ API в демонстрационное приложение

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

Быстрый

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

  1. Добавьте следующий оператор импорта:
    import GoogleMaps
  2. Отредактируйте следующую строку, чтобы добавить ключ API в двойные кавычки:
    // Change this key to a valid key registered with the demo app bundle id.
    let mapsAPIKey = ""

Цель-C

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

  1. Добавьте следующий оператор импорта:
    @import GoogleMaps;
  2. Отредактируйте следующую строку, чтобы добавить ключ API в двойные кавычки:
    // Change this key to a valid key registered with the demo app bundle id.
    static NSString *const kMapsAPIKey = @"";

Создайте и запустите демонстрационное приложение

После добавления ключа API соберите и запустите проект:

  • Если вы используете демо-версию Swift, вы можете выбрать, какую утилиту просматривать в приложении.
  • Если вы используете демо-версию Objective-C, вы увидите демо-версию утилиты кластеризации маркеров. Затем вы можете отредактировать демо-версию Objective-C, чтобы опробовать каждую утилиту. Дополнительную информацию см. в разделе «Добавление утилиты в ваше приложение» ниже.

Установите библиотеку утилит как проект Xcode.

Выполните следующие шаги, чтобы добавить служебную библиотеку в рабочую область Xcode:

Используйте CocoaPods

  1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке для iOS, создайте приложение с единым представлением .)
  2. Если у вас еще нет файла pod для вашего проекта, создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
  3. Отредактируйте файл модуля вашего проекта и добавьте зависимость от модуля Google-Maps-iOS-Utils . Вот пример, который включает зависимости, необходимые для Maps SDK для iOS и библиотеки утилит:
    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '13.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '7.4.0'
      pod 'Google-Maps-iOS-Utils', '4.2.2'
    end
  4. Запустите pod install .
  5. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

Примечание. Утилита кластеризации маркеров зависит от дерева квадрантов, но вы можете использовать дерево квадроциклов без кластеризации маркеров. Если вам нужна только утилита Quadtree, вы можете изменить pod 'Google-Maps-iOS-Utils' на 'Google-Maps-iOS-Utils/QuadTree' в своем файле модуля.

Используйте Карфаген

  1. Установите Карфаген. Существует несколько способов, поэтому точные шаги см. в файле README Carthage .
  2. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке iOS, создайте новый проект и выберите шаблон приложения iOS . В Xcode 11.7 или более ранней версии создайте приложение с одним представлением .)
  3. Создайте файл с именем Cartfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
  4. Отредактируйте Cartfile и добавьте зависимость Maps SDK для iOS Utility Library:
    github "googlemaps/google-maps-ios-utils"
  5. Сохраните Cartfile .
  6. В окне терминала перейдите в каталог, содержащий Cartfile :
    cd <path-to-project>
  7. Запустите команду обновления:
    carthage update --platform iOS

    При этом будут установлены API, указанные в Cartfile , вместе со всеми зависимостями, которые они могут иметь.
  8. В Finder в каталоге вашего проекта перейдите к загруженным файлам платформы в разделе Carthage/Build/iOS .
  9. Добавьте в свой проект Maps SDK для iOS, перетащив в него следующие пакеты. (При появлении запроса выберите «Копировать элементы», если необходимо. Используйте ту же версию, что и выше. )
    • GoogleMaps-xxx/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsUtils.framework
  10. Щелкните правой кнопкой мыши GoogleMaps.framework в своем проекте и выберите «Показать в Finder» .
  11. Перетащите файл Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle из папки Resources в свой проект. При появлении запроса убедитесь, что флажок «Копировать элементы в папку целевой группы» не выбран.
  12. Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
  13. Откройте вкладку «Фазы сборки» для целевого приложения и в разделе «Связывание двоичных файлов с библиотеками» добавьте следующие платформы:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте -ObjC . Если эти настройки не отображаются, измените фильтр на панели «Параметры сборки» с «Базовый» на «Все» .

Используйте диспетчер пакетов Swift

  1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке для iOS, создайте новый проект и выберите шаблон приложения iOS . В Xcode 11.7 или более ранней версии создайте приложение с одним представлением .)
  2. Добавьте Maps SDK для iOS в качестве зависимости. Дополнительные сведения см. в разделе Установка SDK .
  3. В проекте Xcode перейдите в File -> Swift Packages -> Add Package Dependency .
  4. В появившемся окне введите URL-адрес репозитория библиотеки утилит Maps SDK для iOS https://github.com/googlemaps/google-maps-ios-utils и нажмите «Далее» .
    • На этом этапе вам может быть предложено пройти аутентификацию с использованием вашей учетной записи GitHub. Следуйте инструкциям по созданию токена личного доступа GitHub, чтобы продолжить процесс.
  5. В следующем окне выберите опцию «Версия» , выберите «Точная» из раскрывающегося списка, введите последнюю версию библиотеки служебных программ Maps SDK для iOS (например, «3.4.0») и нажмите «Далее» .

Добавьте ключ API в свое приложение

См. раздел «Настройка проекта Xcode» для получения инструкций по созданию ключа API и добавлению его в проект Xcode.

Сборка и запуск проекта

После добавления ключа API соберите и запустите проект.

Добавьте утилиту в свое приложение

Дополнительную информацию об использовании каждой утилиты в вашем приложении см. в документации по каждой утилите: