Comenzar

Advertencia: Nearby Messages dejó de estar disponible y dejará de funcionar a partir de diciembre de 2023. Navega a Conexiones de Nearby para obtener más asistencia o a los Lineamientos de migración para migrar el uso existente de Nearby Messages a Nearby Connections.

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

Si quieres compilar un proyecto con la API de Google Nearby Messages para iOS, necesitarás la versión 6.3 de Xcode o una posterior.

Paso 2: Obtén CocoaPods

La API de Nearby Messages de Google para iOS está disponible como pod de 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 objeto 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 es la primera vez que usas el desarrollo de iOS, crea una aplicación de vista única y asegúrate de que la opción Usar el recuento automático de referencias 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. A continuación, se muestra un Podspec simple, incluido el nombre del Pod que necesitas para la API de Nearby Messages de Google 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. Esto instalará las APIs especificadas en el Podspec, junto con las dependencias que puedan tener.

  instalación de Pod de $

• Cierra Xcode y, luego, abre el archivo .xcworkspace de tu proyecto (con doble clic) para iniciarlo. 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 del Pod. Sigue estos pasos para agregar un encabezado puente:

1. En el mismo directorio que el archivo .xcworkspace de tu proyecto, agrega un nuevo archivo de encabezado (nombra el archivo como 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 del proyecto, 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 Encabezado puente de Objective-C.
8. En Depurar y Versión, 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 aparte para realizar pruebas.

Paso 6: Obtén una clave de API

Sigue estos pasos para habilitar la API de Nearby Messages de Google 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 API).
   Nota: Si tienes una clave de iOS existente, puedes usarla.
5. En el cuadro de diálogo que se muestra a continuación, ingresa el identificador de 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 lo siguiente:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Para evitar el robo de cuota, protege tu clave de API con estas prácticas recomendadas.

Nota: Si también desarrollas una app para Android o usas la API de REST de Proximity Beacon, asegúrate de generar todas las claves de API respectivas dentro del mismo proyecto de Google Developers Console. Para obtener más información, consulta la guía de introducción para Android y cómo comenzar a usar la API de REST.

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‑C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")