Начало работы

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

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

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

Шаг 2. Установите CocoaPods

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

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

$ sudo gem install cocoapods

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

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

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

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

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

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

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

    $ cd

  • Выполните следующую команду pod install, Будут установлены API, указанные в файле Podspec, а также все их зависимости.

    $ pod install

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

Шаг 4. Создайте связующий заголовок (только для Swift)

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

  1. В том же каталоге, где хранится файл проекта .xcworkspace, добавьте новый заголовочный файл (название может быть любым, а расширение должно быть ".h").
  2. Вставьте в созданный файл следующий код: #import <GNSMessages.h>.
  3. Сохраните файл.
  4. На панели слева в редакторе проектов выберите основной проект.
  5. В верхней части редактора сборки нажмите Настройки сборки.
  6. В разделе Build Settings (Настройки сборки) перейдите к пункту Swift Compiler - Code Generation (Компилятор Swift – генерация кода). Чтобы быстро найти его, введите "Swift Compiler" в окне поиска.
  7. Нажмите на стрелку, чтобы развернуть раздел Objective-C Bridging Header.
  8. В разделах Debug и Release добавьте путь к созданному заголовочному файлу.
  9. Чтобы изменения вступили в силу, выполните сборку проекта.

Шаг 5. Создайте аккаунт Google

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

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

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

  1. Перейдите в Google Developers Console.
  2. Создайте или выберите проект, в котором будет зарегистрировано ваше приложение.
  3. Нажмите Продолжить, чтобы включить API.
  4. На странице Credentials (Учетные данные) создайте новый ключ 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"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")