Comenzar

En este documento, se explica cómo comenzar a desarrollar con la API de Nearby Messages en iOS.

Paso 1: Descarga la última versión de Xcode

Para compilar un proyecto con la API de Google Nearby Messages para iOS, necesitas la versión 6.3 o una posterior de Xcode.

Paso 2: Obtén CocoaPods

La API de Google Nearby Messages para iOS está disponible como un pod de CocoaPods. CocoaPods es un administrador de dependencias de código abierto para proyectos de Cocoa en Swift y Objective-C.

Si todavía no tienes la herramienta CocoaPods, instálala en OS X ejecutando el siguiente comando desde el terminal. Para obtener más detalles, consulta la guía de introducción de CocoaPods.

$ sudo gem install cocoapods

Paso 3: Instala la API con CocoaPods

Crea un Podfile para la API de Google Nearby Messages para iOS y úsalo para instalar la API y sus dependencias.

  • Si aún no tienes un proyecto de Xcode, créalo y guárdalo en tu máquina local. (Si eres nuevo en el desarrollo de iOS, crea una aplicación de vista única y asegúrate de que Use Automatic Reference Counting esté activado).
  • Crea un archivo llamado Podfile en el directorio de tu proyecto. Este archivo define las dependencias de tu proyecto.

  • Edita el Podfile y agrega tus dependencias. A continuación, se muestra un Podspec simple en el que se incluye el nombre del pod que necesitas para la API de Google Nearby Messages para iOS: 

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

  • Guarda el Podfile.

  • Abre una terminal y dirígete al directorio que contiene el Podfile:

    $ cd

  • Ejecuta el comando pod install. Con esto se instalarán las APIs especificadas en el Podspec junto con las dependencias que puedan contener.

    $ pod install

  • Cierra Xcode y, luego, abre (con doble clic) el archivo .xcworkspace de tu proyecto para iniciar Xcode. A partir de este momento, debes usar el archivo .xcworkspace para abrir el proyecto.

Paso 4: Crea un encabezado puente (solo Swift)

Si creaste tu proyecto con Swift, debes agregar un encabezado puente a tu proyecto para que pueda usar las bibliotecas que instaló el archivo pod. Sigue estos pasos para agregar un encabezado puente:

  1. En el mismo directorio que el archivo .xcworkspace de tu proyecto, agrega un archivo de encabezado nuevo (asígnale el nombre que quieras y usa la extensión de nombre de archivo “.h”).
  2. Pega el siguiente código en el archivo que creaste: #import <GNSMessages.h>.
  3. Guarda el archivo.
  4. En el panel izquierdo del editor de proyectos, selecciona el proyecto principal.
  5. Haz clic en Build Settings en la parte superior del editor de compilación.
  6. En Build Settings, navega a "Swift Compiler - Code Generation" (escribe "Swift Compiler" en el cuadro de búsqueda para encontrarlo rápidamente).
  7. Haz clic en la flecha para expandir la sección Objective-C Bridging Header.
  8. En Debug y Release, agrega la ruta de acceso al archivo de encabezado que creaste.
  9. Compila el proyecto para que se apliquen los cambios.

Paso 5: Obtén una Cuenta de Google

Para usar las APIs de Nearby Messages, necesitas una Cuenta de Google. Si ya tienes una cuenta, no tienes que hacer nada más. También puedes usar una Cuenta de Google separada para fines de prueba.

Paso 6: Obtén una clave de API

Sigue estos pasos para habilitar la API de Google Nearby Messages para iOS y obtener una clave de API:

  1. Ve a Google Play Console.
  2. Crea o selecciona un proyecto para registrar tu aplicación.
  3. Haz clic en Continue para habilitar la API.
  4. En la página Credenciales, crea una nueva clave para iOS (y configura las credenciales de la API).
    Nota: Si tienes una clave de iOS existente, puedes usarla.
  5. En el cuadro de diálogo que se muestra a continuación, escribe el identificador del paquete de tu aplicación. Por ejemplo: 
    com.example.nearbyexample
  6. Tu nueva clave de la API de iOS aparece en la lista de claves de API de tu proyecto. Una clave de API es una string de caracteres similar a la siguiente: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Para evitar el robo de cuota, protege tu clave de API siguiendo estas prácticas recomendadas.

Paso 7: Crea un objeto de administrador de mensajes

El objeto del administrador de mensajes te permite publicar y suscribirte. El intercambio de mensajes no está autenticado, por lo que debes proporcionar la clave de API que creaste en el paso anterior.

Objective-CSwift

#import <GNSMessages.h>

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


let messageManager = GNSMessageManager(APIKey: "API_KEY")