Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento spiega come iniziare a sviluppare con l'API Nearby Messages su iOS.
Passaggio 1: installa la versione più recente di Xcode
Per creare un progetto che utilizza l'API Google Nearby Messages per iOS, devi avere la versione 6.3 o successive di Xcode.
Passaggio 2: scarica CocoaPods
L'API Google Nearby Messages per iOS è disponibile come pod CocoaPods. CocoaPods è un gestore delle dipendenze open source per progetti Cocoa in Swift e Objective-C.
Se non hai già lo strumento CocoaPods, installalo su OS X eseguendo il seguente comando dal terminale. Per maggiori dettagli, consulta la guida introduttiva di CocoaPods.
$sudogeminstallcocoapods
Passaggio 3: installa l'API utilizzando CocoaPods
Crea un Podfile per l'API Google Nearby Messages per iOS e utilizzalo per installare l'API e le relative dipendenze.
Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai esperienza nello sviluppo per iOS, crea un'applicazione con una sola vista e assicurati che l'opzione Utilizza il conteggio automatico dei riferimenti sia attivata.
Crea un file denominato Podfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
Modifica Podfile e aggiungi le dipendenze. Ecco un semplice file Podspec, incluso il nome del pod necessario per l'API Google Nearby Messages per iOS:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
Salva il Podfile.
Apri un terminale e vai alla directory contenente Podfile:
$ cd
Esegui il comando pod install. Verranno installate le API specificate nel
Podspec, insieme a eventuali dipendenze.
$ pod install
Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Da questo momento in poi, devi utilizzare il file .xcworkspace per aprire il progetto.
Passaggio 4: crea un'intestazione di bridging (solo Swift)
Se hai creato il progetto utilizzando Swift, devi aggiungere un'intestazione di bridging al progetto in modo che possa utilizzare le librerie installate dal file pod.
Per aggiungere un'intestazione di collegamento:
Nella stessa directory del file .xcworkspace del progetto, aggiungi un nuovo file di intestazione (assegna un nome a piacere e utilizza l'estensione ".h").
Incolla il seguente codice nel file che hai creato:
#import <GNSMessages.h>.
Salva il file.
Nel riquadro a sinistra dell'editor del progetto, seleziona il progetto principale.
Fai clic su Impostazioni di compilazione nella parte superiore dell'editor di compilazione.
In Impostazioni di compilazione, vai a "Compilatore Swift - Generazione codice" (digita
"Compilatore Swift" nella casella di ricerca per trovarla rapidamente).
Fai clic sulla freccia per espandere la sezione Intestazione di bridging Objective-C.
In Debug e Release, aggiungi il percorso al file di intestazione che hai creato.
Compila il progetto per rendere effettive le modifiche.
Passaggio 5: crea un Account Google
Per utilizzare le API Nearby Messages, devi disporre di un Account Google.
Se hai già un account, è tutto pronto. Ti consigliamo anche di avere un Account Google distinto per scopi di test.
Passaggio 6: ottieni una chiave API
Svolgi i seguenti passaggi per attivare l'API Google Nearby Messages per iOS e ottenere una chiave API:
Crea o seleziona un progetto a cui registrare l'applicazione.
Fai clic su Continua per abilitare l'API.
Nella pagina Credenziali, crea una nuova chiave per iOS (e imposta le credenziali API).
Nota: se hai già una chiave per iOS, puoi utilizzarla.
Nella finestra di dialogo visualizzata, inserisci l'identificatore del bundle della tua app. Ad esempio:
com.example.nearbyexample
La nuova chiave API per iOS viene visualizzata nell'elenco delle chiavi API per il progetto.
Una chiave API è una stringa di caratteri, ad esempio:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
Per evitare il furto di quote, proteggi la tua chiave API seguendo queste
best practice.
Passaggio 7: crea un oggetto gestore dei messaggi
L'oggetto gestore dei messaggi ti consente di pubblicare e iscriverti. Lo scambio di messaggi non è autenticato, quindi devi fornire la chiave API creata nel passaggio precedente.
[null,null,["Ultimo aggiornamento 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"]]
