Начать

В этом документе объясняется, как начать разработку с использованием 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, создайте приложение с одним представлением (Single View Application) и убедитесь, что параметр «Использовать автоматический подсчёт ссылок» (Use Automatic Reference Counting) включен.)
  • Создайте файл с именем 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, а также все необходимые зависимости.

    $ pod install

  • Закройте 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. В разделах «Отладка» и «Выпуск» укажите путь к созданному вами заголовочному файлу.
  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")