Начать

В этом документе объясняется, как начать разработку с использованием API Nearby Messages на iOS.

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

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

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

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

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

$ sudo gem install cocoapods

Шаг 3: Установка API с помощью CocoaPods

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

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

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

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

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

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

    $ cd

  • Выполните команду pod install . Это установит API, указанные в Podspec, вместе со всеми их зависимостями.

    $ установка пода

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

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

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

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

Шаг 5: Создайте учетную запись Google

Для использования API Nearby Messages вам понадобится учётная запись Google . Если у вас уже есть учётная запись, всё готово. Также для тестирования может понадобиться отдельная учётная запись Google.

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

Выполните следующие действия, чтобы включить API Google Nearby Messages для 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, созданный на предыдущем шаге.

Objective-C 

#import <GNSMessages.h>

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

Быстрый 

let messageManager = GNSMessageManager(APIKey: "API_KEY")