Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 aún 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.
$sudogeminstallcocoapods
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 es la primera vez que usas iOS, crea una aplicación de vista única 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 las dependencias de tu proyecto.
Edita el Podfile y agrega tus dependencias. Este es un Podspec simple, que 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 ve al directorio que contiene el Podfile:
$ cd
Ejecuta el comando pod install. Esto instalará las APIs especificadas en el Podspec, junto con las dependencias que puedan tener.
$ pod install
Cierra Xcode y, luego, abre (haz 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 de puente (solo para Swift)
Si creaste tu proyecto con Swift, debes agregarle un encabezado de puente para que pueda usar las bibliotecas que instaló el archivo pod.
Sigue estos pasos para agregar un encabezado de puente:
En el mismo directorio en el que se encuentra 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”).
Pega el siguiente código en el archivo que creaste: #import <GNSMessages.h>.
Guarda el archivo.
En el panel izquierdo del editor de proyectos, selecciona el proyecto principal.
Haz clic en Build Settings en la parte superior del editor de compilación.
En Build Settings, navega a "Swift Compiler - Code Generation" (escribe "Swift Compiler" en el cuadro de búsqueda para encontrarlo rápidamente).
Haz clic en la flecha para expandir la sección Objective-C Bridging Header.
En Debug y Versión, agrega la ruta de acceso al archivo de encabezado que creaste.
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:
Crea o selecciona un proyecto para registrar tu aplicación.
Haz clic en Continuar para habilitar la API.
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.
En el diálogo resultante, ingresa el identificador de paquete de tu app. Por ejemplo:
com.example.nearbyexample
Tu nueva clave de API de iOS aparecerá 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
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.
[null,null,["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eThe Nearby Messages API is deprecated and will stop working in December 2023, with users encouraged to migrate to Nearby Connections.\u003c/p\u003e\n"],["\u003cp\u003eDeveloping with the Nearby Messages API on iOS requires Xcode version 6.3 or later and the use of CocoaPods for dependency management.\u003c/p\u003e\n"],["\u003cp\u003eInstallation of the API is done via creating and editing a \u003ccode\u003ePodfile\u003c/code\u003e with a simple \u003ccode\u003epod install\u003c/code\u003e command in the terminal.\u003c/p\u003e\n"],["\u003cp\u003eSwift projects additionally require the creation of a bridging header file, referencing GNSMessages.h, and specifying the path to this in the project's build settings.\u003c/p\u003e\n"],["\u003cp\u003eUsing the API requires a Google account and an API key, which is generated in the Google Developers Console by enabling the Nearby Messages API.\u003c/p\u003e\n"]]],["The guide outlines the process for developing with the deprecated Nearby Messages API on iOS. Key actions include: installing Xcode (v6.3+), setting up CocoaPods for dependency management, creating a `Podfile` to install the 'NearbyMessages' pod, and adding a bridging header for Swift projects. A Google account and an iOS API key are needed, generated via the Google Developers Console using the app's bundle identifier. Finally, a message manager object is created using the API key to enable publishing and subscribing.\n"],null,["# Get Started\n\n| **Warning:** Nearby Messages is deprecated and will stop working as of December 2023. Please navigate to [Nearby Connections](//developers.google.com/nearby/connections/overview) for further support or [Migration Guideline](//developers.google.com/nearby/messages/ios/migrate-to-nc) on how to migrate existing Nearby Messages usage to Nearby Connections.\n\nThis document explains how to start developing with the Nearby Messages API on\niOS.\n\nStep 1: Get the latest version of Xcode\n---------------------------------------\n\nTo build a project using the Google Nearby Messages API for iOS, you need\n**version 6.3** or later of [Xcode](https://developer.apple.com/xcode/).\n\nStep 2: Get CocoaPods\n---------------------\n\nThe Google Nearby Messages API for iOS is available as a\n[CocoaPods](https://cocoapods.org/) pod. CocoaPods is an open source dependency\nmanager for Swift and Objective-C Cocoa projects.\n\nIf you don't already have the CocoaPods tool, install it on OS X by running the\nfollowing command from the terminal. For details, see the [CocoaPods Getting\nStarted guide](https://guides.cocoapods.org/using/getting-started.html). \n\n $ sudo gem install cocoapods\n\nStep 3: Install the API using CocoaPods\n---------------------------------------\n\nCreate a `Podfile` for the Google Nearby Messages API for iOS and use it to\ninstall the API and its dependencies.\n\n- If you don't have an Xcode project yet, create one now and save it to your local machine. (If you're new to iOS development, create a Single View Application, and ensure that Use Automatic Reference Counting is turned on.)\n- Create a file named `Podfile` in your project directory. This file defines your project's dependencies.\n- Edit the `Podfile` and add your dependencies. Here is a simple Podspec,\n including the name of the pod you need for the Google Nearby Messages API for\n iOS:\n\n ```text\n source 'https://github.com/CocoaPods/Specs.git'\n platform :ios, '7.0'\n pod 'NearbyMessages'\n ```\n\n \u003cbr /\u003e\n\n- Save the `Podfile`.\n\n- Open a terminal and go to the directory containing the `Podfile`:\n\n $ cd\n- Run the `pod install` command. This will install the APIs specified in the\n Podspec, along with any dependencies they may have.\n\n $ pod install\n- Close Xcode, and then open (double-click) your project's `.xcworkspace` file\n to launch Xcode. From this time onwards, you must use the `.xcworkspace` file to\n open the project.\n\nStep 4: Create a bridging header (Swift only)\n---------------------------------------------\n\nIf you created your project using Swift, you must add a bridging header to your\nproject so that it can use the libraries that were installed by the pod file.\nTake these steps to add a bridging header:\n\n1. In the same directory as your project's `.xcworkspace` file, add a new header file (name it whatever you like and use a filename extension of \".h\").\n2. Paste the following code into the file you created: `#import \u003cGNSMessages.h\u003e`.\n3. Save the file.\n4. In the project editor left pane, select the main project.\n5. Click **Build Settings** at the top of the build editor.\n6. In Build Settings, navigate to \"Swift Compiler - Code Generation\" (type \"Swift Compiler\" into the search box to locate it quickly).\n7. Click the arrow to expand the **Objective-C Bridging Header** section.\n8. Under **Debug** and **Release**, add the path to the header file you created.\n9. Build the project to make the changes take effect.\n\nStep 5: Get a Google account\n----------------------------\n\nTo use the Nearby Messages APIs, you need a [Google Account](//www.google.com/accounts/NewAccount).\nIf you already have an account, then you're all set. You may also want a\nseparate Google Account for testing purposes.\n\nStep 6: Get an API key\n----------------------\n\nTake these steps to enable the Google Nearby Messages API for iOS and get an\nAPI key:\n\n1. Go to the [Google Developers Console](https://console.developers.google.com/flows/enableapi?apiid=copresence&keyType=CLIENT_SIDE_IOS&reusekey=true).\n2. Create or select a project to register your application with.\n3. Click **Continue** to Enable the API.\n4. On the **Credentials** page, create a new **iOS key** (and set the API Credentials). \n Note: If you have an existing **iOS key**, you may use that key.\n5. In the resulting dialog, enter your app's bundle identifier. For example: \n\n ```\n com.example.nearbyexample\n ```\n6. Your new iOS API key appears in the list of API keys for your project. An API key is a string of characters, something like this: \n\n ```\n AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0\n ```\n7. To prevent quota theft, secure your API key following these [best practices](/console/help/console#apikeybestpractices).\n\n| **Note:** If you are also developing an Android app, or using the Proximity Beacon REST API, make sure you generate all respective API keys within the same Google Developers Console project. For more information, see the [Getting Started guide for Android](/nearby/messages/android/get-started), and [Get Started with the REST API](/beacons/proximity/get-started).\n\nStep 7: Create a message manager object\n---------------------------------------\n\nThe message manager object lets you publish and subscribe. Message exchange is\nunauthenticated, so you must supply the API key you created in the previous\nstep.\n\n\u003cbr /\u003e\n\n### Objective-C\n\n\u003cbr /\u003e\n\n #import \u003cGNSMessages.h\u003e\n\n GNSMessageManager *messageManager =\n [[GNSMessageManager alloc] initWithAPIKey:@\"API_KEY\"];\n\n\u003cbr /\u003e\n\n### Swift\n\n\u003cbr /\u003e\n\n let messageManager = GNSMessageManager(APIKey: \"API_KEY\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e"]]
