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 versión posterior de Xcode.

Paso 2: Obtén CocoaPods

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

Si todavía no tienes la herramienta CocoaPods, instálala en OS X ejecutando el siguiente comando desde la 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 a fin de 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 es la primera vez que usas iOS, crea una Single View Application y asegúrate de que la opción Use Automatic Reference Counting esté activada).
  • 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. Aquí tienes un Podspec simple, incluido 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 ve al directorio que contiene el archivo Podfile:

    $ cd

  • Ejecuta el comando pod install. Eso hará que se instalen las API especificadas en el Podspec, junto con las dependencias que puedan tener.

    $ pod install

  • Cierra Xcode. Luego, haz doble clic en el archivo .xcworkspace de tu proyecto para abrirlo y que se inicie Xcode. A partir de este momento, usa el archivo .xcworkspace para abrir el proyecto.

Paso 4: Crea un encabezado de puente (solo Swift)

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

  1. En el mismo directorio que el archivo .xcworkspace de tu proyecto, agrega un archivo de encabezado nuevo (dale el nombre que quieras y usa una 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 ubicarlo 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 los cambios surtan efecto.

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 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 Developers Console.
  2. Crea o selecciona un proyecto para registrar tu aplicación.
  3. Haz clic en Continuar para habilitar la API.
  4. En la página Credenciales, crea una clave de iOS nueva (y configura las credenciales de la API).
    Nota: Si tienes una clave de iOS existente, puedes usarla.
  5. En el diálogo resultante, ingresa el identificador del paquete de tu app. Por ejemplo: 
    com.example.nearbyexample
  6. Tu nueva clave de API de iOS aparece en la lista de claves de API de tu proyecto. Una clave de API es una cadena 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 administrador de mensajes

El objeto 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-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")