На этой странице описано, как настроить библиотеку утилит для SDK карт для iOS .
Чтобы опробовать эти утилиты, вы можете сделать одно из следующих действий:
- Установите библиотеку утилит в существующий проект Xcode . Добавьте эти утилиты в свой собственный проект.
- Установите и запустите демонстрационное приложение . Демонстрационное приложение представляет собой автономный проект, содержащий весь код, необходимый для тестирования утилит.
Добавьте библиотеку утилит Maps SDK для iOS в проект Xcode.
Выполните следующие шаги, чтобы добавить библиотеку утилит в рабочую область Xcode:
Используйте менеджер пакетов Swift.
- Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. (Если вы новичок в разработке под iOS, создайте новый проект и выберите шаблон iOS App . В Xcode 11.7 или более ранних версиях создайте Single View Application .)
- Добавьте SDK карт для iOS в качестве зависимости. См. раздел «Установка SDK» для получения информации о доступных вариантах.
- В вашем проекте Xcode перейдите в меню File -> Swift Packages -> Add Package Dependency .
- В появившемся окне введите URL-адрес репозитория библиотеки утилит Maps SDK для iOS
https://github.com/googlemaps/google-maps-ios-utilsи нажмите «Далее» . - На этом этапе вам может быть предложено пройти аутентификацию с помощью вашей учетной записи GitHub. Следуйте инструкциям, чтобы создать персональный токен доступа GitHub и продолжить процесс.
- В следующем окне выберите переключатель «Версия» , выберите из выпадающего списка «До следующей основной версии» и введите последнюю версию библиотеки утилит Maps SDK для iOS (например, «6.0.0»).
- Щелкните раскрывающийся список рядом с кнопкой «Добавить в проект» , выберите свой проект и нажмите «Добавить пакет» .
Добавьте ключ API в ваше приложение.
Инструкции по генерации ключа API и его добавлению в проект Xcode см. в разделе «Настройка проекта Xcode».Соберите и запустите проект.
После добавления ключа API соберите и запустите проект.
Используйте вспомогательную функцию в своем приложении.
Для получения более подробной информации об использовании каждой утилиты в вашем приложении см. документацию:
Установите и запустите демонстрационное приложение.
В библиотеку утилит входит демонстрационное приложение, которое можно установить и опробовать каждую утилиту.
Установите демо-версию приложения:Используйте файлы из GitHub.
- Загрузите архив с примерами кода с GitHub и распакуйте его.
- Откройте окно терминала, перейдите в каталог, куда вы распаковали примеры файлов, и углубитесь в соответствующий каталог примеров для языка, который вы хотите использовать:
- Для Swift выполните
cd google-maps-ios-utils-master/samples/SwiftDemoApp - Для Objective-C выполните команду
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- Для Swift выполните
- Выполните следующую команду:
pod install
- Закройте Xcode, а затем откройте (дважды щелкните) файл
.xcworkspaceвашего проекта, чтобы запустить Xcode. С этого момента для открытия проекта необходимо использовать файл.xcworkspace.
Добавьте ключ API в демонстрационное приложение.
В разделе «Получить ключ API» вы генерируете ключ API для своего приложения. Теперь добавьте этот ключ в проект Xcode для демонстрационного приложения.Быстрый
Добавьте свой API-ключ в файл AppDelegate.swift следующим образом:
- Добавьте следующую инструкцию импорта:
import GoogleMaps
- Отредактируйте следующую строку, добавив свой API-ключ в двойные кавычки:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Добавьте свой API-ключ в файл AppDelegate.m следующим образом:
- Добавьте следующую инструкцию импорта:
@import GoogleMaps;
- Отредактируйте следующую строку, добавив свой 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, чтобы попробовать каждую из утилит. Дополнительную информацию см. в разделе « Добавление утилиты в ваше приложение» ниже.