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 consulta los Lineamientos de migración sobre cómo migrar el uso existente de Mensajes de Nearby a las conexiones de Nearby.

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 crear un proyecto con la API de Nearby Messages de Google para iOS, necesitas versión 6.3 o posterior de Xcode

Paso 2: Obtén CocoaPods

La API de Nearby Messages de Google para iOS está disponible como CocoaPods. CocoaPods es una dependencia de código abierto y gerente de 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 información detallada, consulta el artículo sobre cómo obtener Guía de introducción

$ sudo gem install cocoapods

Paso 3: Instala la API con CocoaPods

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

• Si aún no tienes un proyecto de Xcode, créalo ahora y guárdalo en tu máquina local. (Si es la primera vez que realizas desarrollos para iOS, crea una vista única Aplicación y asegúrate de que la opción Usar recuento automático de referencias esté activada).
• Crea un archivo llamado Podfile en el directorio de tu proyecto. Este archivo define tu las dependencias del proyecto.

• Edita el Podfile y agrega tus dependencias. Este es un Podspec simple, incluido el nombre del Pod que necesitas para la API de Nearby Messages de Google En 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 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 Pods

• 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 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 nuevo archivo de encabezado (asígnale el nombre que desees 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 Configuración de compilación en la parte superior del editor de compilación.
6. En Build Settings, navega a "Swift Compiler - Code Generation". (tipo "Swift Compiler" en el cuadro de búsqueda para encontrarla 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 crear.
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 puede ser útil una Cuenta de Google separada para realizar pruebas.

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 la 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 la API). Credenciales).
   Nota: Si tienes una clave de iOS, 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 parecida a la siguiente:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Para evitar el robo de cuota, protege tu clave de API de la siguiente manera prácticas recomendadas.

Nota: Si también desarrollas una app para Android o usas la baliza de proximidad: API de REST, asegúrate de generar todas las claves de API correspondientes dentro de la misma API proyecto de Developers Console. Para obtener más información, consulta la Guía de introducción para Android, y Comienza a usar la API de REST.

Paso 7: Crea un objeto del administrador de mensajes

El objeto del administrador de mensajes te permite publicar y suscribirte. El intercambio de mensajes es autenticados, por lo que debes proporcionar la clave de API que creaste en la paso.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")