Commencer

Avertissement :Nearby Messages est obsolète et cessera de fonctionner à compter de décembre 2023. Veuillez accéder à Nearby Connections pour obtenir de l'aide ou aux Consignes de migration pour savoir comment migrer l'utilisation existante de Nearby Messages vers Nearby Connections.

Ce document explique comment commencer à développer avec l'API Nearby Messages sur iOS

Étape 1 : Obtenir la dernière version de Xcode

Pour créer un projet à l'aide de l'API Google Nearby Messages pour iOS, vous devez disposer des éléments suivants : version 6.3 ou ultérieure de Xcode.

Étape 2: Obtenir CocoaPods

L'API Google Nearby Messages pour iOS est disponible en tant que CocoaPods. CocoaPods est une dépendance Open Source responsable des projets Cocoa de Swift et d'Objective-C.

Si vous ne disposez pas encore de l'outil CocoaPods, installez-le sur OS X en exécutant la commande à partir du terminal. Pour en savoir plus, consultez le document CocoaPods Getting Guide de démarrage.

$ sudo gem install cocoapods

Étape 3: Installez l'API à l'aide de CocoaPods

Créez un Podfile pour l'API Google Nearby Messages pour iOS et utilisez-le pour installer l'API et ses dépendances.

• Si vous n'avez pas encore de projet Xcode, créez-en un et enregistrez-le dans votre sur votre ordinateur local. (Si vous débutez dans le développement sur iOS, créez une vue unique application et assurez-vous que l'option "Utiliser le comptage automatique des références" est activée.)
• Créez un fichier nommé Podfile dans le répertoire de votre projet. Ce fichier définit votre les dépendances du projet.

• Modifiez le Podfile et ajoutez vos dépendances. Voici un podspec simple. y compris le nom du pod dont vous avez besoin pour l'API Google Nearby Messages pour iOS:

  source 'https://github.com/CocoaPods/Specs.git'
  platform :ios, '7.0'
  pod 'NearbyMessages'

• Enregistrez le Podfile.

• Ouvrez un terminal et accédez au répertoire contenant le fichier Podfile:

  $ cd

• Exécutez la commande pod install. Les API spécifiées dans la section Podspec, ainsi que toutes ses dépendances.

  $ installation de pods

• Fermez Xcode, puis ouvrez (double-cliquez) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier .xcworkspace pour ouvrir le projet.

Étape 4: Créez un en-tête de pontage (Swift uniquement)

Si vous avez créé votre projet à l'aide de Swift, vous devez ajouter un en-tête de pontage à votre pour pouvoir utiliser les bibliothèques installées par le fichier pod. Pour ajouter un en-tête de pontage, procédez comme suit:

1. Dans le répertoire contenant le fichier .xcworkspace de votre projet, ajoutez un (nom de fichier de votre choix avec l'extension ".h").
2. Collez le code suivant dans le fichier que vous avez créé: #import <GNSMessages.h>
3. Enregistrez le fichier.
4. Dans le volet gauche de l'éditeur de projet, sélectionnez le projet principal.
5. Cliquez sur Build Settings (Paramètres de compilation) en haut de l'éditeur de compilation.
6. Dans les paramètres de compilation, accédez à "Swift Compiler - Code Generation". (saisissez "Compilateur Swift" dans le champ de recherche pour la retrouver rapidement).
7. Cliquez sur la flèche pour développer la section En-tête de pont Objective-C.
8. Sous Debug (Débogage) et Release (Publier), ajoutez le chemin d'accès au fichier d'en-tête que vous créé.
9. Créez le projet pour que les modifications soient prises en compte.

Étape 5: Obtenez un compte Google

Pour utiliser les API Nearby Messages, vous devez disposer d'un compte Google. Si vous avez déjà un compte, vous êtes prêt. Vous voudrez peut-être aussi un compte Google distinct à des fins de test.

Étape 6: Obtenez une clé API

Suivez ces étapes pour activer l'API Google Nearby Messages pour iOS et obtenir une Clé API:

1. Accédez à la Google Play Console
2. Créez ou sélectionnez un projet dans lequel enregistrer votre application.
3. Cliquez sur Continuer pour activer l'API.
4. Sur la page Identifiants, créez une clé iOS (et définissez l'API identifiants).
   Remarque: Si vous disposez déjà d'une clé iOS, vous pouvez l'utiliser.
5. Dans la boîte de dialogue qui s'affiche, saisissez l'identifiant du bundle de votre application. Par exemple :

   com.example.nearbyexample

6. Votre nouvelle clé API iOS s'affiche dans la liste des clés API de votre projet. Une clé API est une chaîne de caractères semblable à celle-ci:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Pour éviter le vol de quotas, sécurisez votre clé API en suivant ces bonnes pratiques.

Remarque :Si vous développez également une application Android ou si vous utilisez Proximity Beacon API REST, veillez à générer toutes les clés API correspondantes au sein du même Projet Developers Console. Pour en savoir plus, consultez les Guide de démarrage pour Android et Premiers pas avec l'API REST.

Étape 7: Créez un objet de gestionnaire de messages

L'objet Gestionnaire de messages vous permet de publier du contenu et de vous abonner. L'échange de messages est non authentifiées. Vous devez donc fournir la clé API que vous avez créée étape.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")