Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument wird beschrieben, wie Sie mit der Nearby Messages API auf iOS-Geräten entwickeln.
Schritt 1: Neueste Version von Xcode herunterladen
Wenn du ein Projekt mit der Google Nearby Messages API for iOS einrichten möchtest, musst du mindestens Version 6.3 von Xcodeverwenden.
Schritt 2: CocoaPods herunterladen
Die Google Nearby Messages API für iOS ist als Pod von CocoaPods verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C.
Falls du das Tool „CocoaPods“ noch nicht nutzt, installiere es unter OS X, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen findest du im Startleitfaden zu CocoaPods (in englischer Sprache).
$sudogeminstallcocoapods
Schritt 3: API mit CocoaPods installieren
Erstelle eine Podfile für die Google Nearby Messages API für iOS und verwende sie, um die API und die zugehörigen Abhängigkeiten zu installieren.
Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. (Falls du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle eine Single View Application und achte darauf, dass „Use Automatic Reference Counting“ aktiviert ist.)
Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
Bearbeite die Podfile und füge ihre Abhängigkeiten hinzu. Hier ist eine einfache Pod-Spezifikation mit dem Namen des Pods, den Sie für die Google Nearby Messages API für iOS benötigen:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
Speichere die Podfile.
Öffne ein Terminalfenster und suche das Verzeichnis mit der Podfile:
$ cd
Führen Sie den Befehl pod install aus: Dadurch werden die in der Podspec angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.
$ pod install
Schließe Xcode und öffne dann mit einem Doppelklick die Datei .xcworkspace deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei .xcworkspace aufrufen.
Schritt 4: Bridging-Header erstellen (nur Swift)
Wenn Sie Ihr Projekt mit Swift erstellt haben, müssen Sie Ihrem Projekt einen Bridging-Header hinzufügen, damit es die Bibliotheken verwenden kann, die über die Pod-Datei installiert wurden.
So fügen Sie einen Überschriften-Übergang hinzu:
Fügen Sie im selben Verzeichnis wie die .xcworkspace-Datei Ihres Projekts eine neue Headerdatei hinzu. Geben Sie einen beliebigen Namen und die Dateiendung „.h“ an.
Fügen Sie den folgenden Code in die von Ihnen erstellte Datei ein:
#import <GNSMessages.h>.
Speichern Sie die Datei.
Wählen Sie im linken Bereich des Projekteditors das Hauptprojekt aus.
Klicken Sie oben im Build-Editor auf Build-Einstellungen.
Gehen Sie in den Build-Einstellungen zu „Swift Compiler – Code Generation“ (Sie können auch „Swift Compiler“ in das Suchfeld eingeben, um die Option schnell zu finden).
Klicken Sie auf den Pfeil, um den Bereich Objective-C-Bridging-Header zu maximieren.
Fügen Sie unter Debug und Release den Pfad zur von Ihnen erstellten Headerdatei hinzu.
Erstellen Sie das Projekt, damit die Änderungen wirksam werden.
Schritt 5: Google-Konto erstellen
Für die Verwendung der Nearby Messages APIs benötigen Sie ein Google-Konto.
Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.
Schritt 6: API-Schlüssel abrufen
So aktivieren Sie die Google Nearby Messages API für iOS und rufen einen API-Schlüssel ab:
Erstellen oder wählen Sie ein Projekt aus, mit dem Sie Ihre Anwendung registrieren möchten.
Klicken Sie auf Weiter, um die API zu aktivieren.
Erstelle auf der Seite Anmeldedaten einen neuen iOS-Schlüssel und lege die API-Anmeldedaten fest.
Hinweis: Wenn du bereits einen iOS-Schlüssel hast, kannst du diesen verwenden.
Geben Sie im angezeigten Dialogfeld die Bundle-ID Ihrer App ein. Beispiel:
com.example.nearbyexample
Der neue iOS-API-Schlüssel wird in der Liste der API-Schlüssel für dein Projekt angezeigt.
Ein API-Schlüssel ist eine Zeichenfolge, die in etwa so aussieht:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
Um Kontingentdiebstahl zu verhindern, sollten Sie Ihren API-Schlüssel gemäß den folgenden Best Practices schützen.
Schritt 7: Message Manager-Objekt erstellen
Mit dem Message Manager-Objekt können Sie Nachrichten veröffentlichen und abonnieren. Der Nachrichtenaustausch ist nicht authentifiziert. Sie müssen daher den API-Schlüssel angeben, den Sie im vorherigen Schritt erstellt haben.
[null,null,["Zuletzt aktualisiert: 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"]]
