Начать

В этом документе объясняется, как начать разработку с помощью API близлежащих сообщений для iOS.

Шаг 1. Получите последнюю версию Xcode.

Чтобы создать проект с использованием API сообщений Google Nearby для iOS, вам потребуется версия Xcode 6.3 или более поздняя.

Шаг 2. Получите CocoaPods

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

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

$ sudo gem install cocoapods

Шаг 3. Установите API с помощью CocoaPods.

Создайте Podfile для API сообщений Google Nearby для iOS и используйте его для установки API и его зависимостей.

  • Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке для iOS, создайте приложение с единым представлением и убедитесь, что параметр «Использовать автоматический подсчет ссылок» включен.)
  • Создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.

  • Отредактируйте Podfile и добавьте свои зависимости. Вот простая спецификация, включающая имя модуля, который вам нужен для API Google Nearby Messages для iOS:

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • Сохраните Podfile .

  • Откройте терминал и перейдите в каталог, содержащий Podfile :

    $ компакт-диск

  • Запустите команду pod install . При этом будут установлены API, указанные в Podspec, а также все зависимости, которые они могут иметь.

    $ установка модуля

  • Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

Шаг 4. Создайте соединительный заголовок (только Swift)

Если вы создали свой проект с помощью Swift, вам необходимо добавить в проект связующий заголовок, чтобы он мог использовать библиотеки, установленные файлом pod. Выполните следующие действия, чтобы добавить связующий заголовок:

  1. В том же каталоге, что и файл .xcworkspace вашего проекта, добавьте новый файл заголовка (назовите его по своему усмотрению и используйте расширение имени файла «.h»).
  2. Вставьте следующий код в созданный вами файл: #import <GNSMessages.h> .
  3. Сохраните файл.
  4. На левой панели редактора проектов выберите основной проект.
  5. Нажмите «Настройки сборки» в верхней части редактора сборки.
  6. В настройках сборки перейдите к «Swift Compiler — Генерация кода» (введите «Swift Compiler» в поле поиска, чтобы быстро найти его).
  7. Щелкните стрелку, чтобы развернуть раздел «Заголовок моста Objective-C» .
  8. В разделе «Отладка и выпуск» добавьте путь к созданному вами заголовочному файлу.
  9. Соберите проект, чтобы изменения вступили в силу.

Шаг 5. Получите учетную запись Google.

Чтобы использовать API сообщений поблизости, вам потребуется учетная запись Google . Если у вас уже есть учетная запись, то все готово. Вам также может потребоваться отдельная учетная запись Google для целей тестирования.

Шаг 6. Получите ключ API

Выполните следующие действия, чтобы включить API сообщений Google Nearby для iOS и получить ключ API:

  1. Перейдите в консоль разработчиков Google .
  2. Создайте или выберите проект для регистрации вашего приложения.
  3. Нажмите «Продолжить» , чтобы включить API.
  4. На странице «Учетные данные» создайте новый ключ iOS (и установите учетные данные API).
    Примечание. Если у вас есть ключ iOS , вы можете использовать его.
  5. В появившемся диалоговом окне введите идентификатор пакета вашего приложения. Например: 
    com.example.nearbyexample
  6. Ваш новый ключ API iOS появится в списке ключей API для вашего проекта. Ключ API — это строка символов, примерно такая: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Чтобы предотвратить кражу квот, защитите свой ключ API, следуя этим рекомендациям .

Шаг 7. Создайте объект диспетчера сообщений.

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

Цель-C 

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Быстрый 

let messageManager = GNSMessageManager(APIKey: "API_KEY")