Commencer

Avertissement :Nearby Messages est obsolète et ne fonctionnera plus à partir de décembre 2023. Pour obtenir de l'aide supplémentaire, consultez Connexions à proximité ou les Consignes de migration pour savoir comment migrer l'utilisation de Messages à proximité vers les connexions à proximité.

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 avez besoin de la version 6.3 ou ultérieure de Xcode.

Étape 2: Obtenir CocoaPods

L'API Google Nearby Messages pour iOS est disponible en tant que pod CocoaPods. CocoaPods est un gestionnaire de dépendances Open Source pour les projets Cocoa Swift et Objective-C.

Si vous ne possédez pas encore l'outil CocoaPods, installez-le sur OS X en exécutant la commande ci-dessous à partir du terminal. Pour en savoir plus, consultez le guide de démarrage de CocoaPods.

$ sudo gem install cocoapods

Étape 3: Installer 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 sur votre machine locale. (Si vous débutez avec le développement iOS, créez une application Single View et assurez-vous que l'option "Use Automatic Reference Counting" (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 les dépendances de votre 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 Podfile:

  $ cd

• Exécutez la commande pod install. Cela installera les API spécifiées dans le Podspec, ainsi que toutes les éventuelles dépendances.

  $ pod install

• 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 projet afin qu'il puisse 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 même répertoire que le fichier .xcworkspace de votre projet, ajoutez un fichier d'en-tête (nommez-le comme vous le souhaitez et utilisez une extension de nom de fichier ".h").
2. Collez le code suivant dans le fichier que vous avez créé : #import <GNSMessages.h>.
3. Enregistrez le fichier.
4. Dans le volet de 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 à "Compilateur Swift - Génération de code" (saisissez "Compilateur Swift" dans le champ de recherche pour le trouver rapidement).
7. Cliquez sur la flèche pour développer la section En-tête de pontage Objective-C.
8. Sous Debug (Débogage) et Release (Version), ajoutez le chemin d'accès au fichier d'en-tête que vous avez créé.
9. Compilez le projet pour que les modifications prennent effet.

Étape 5: Obtenez un compte Google

Pour utiliser les API Nearby Messages, vous avez besoin d'un compte Google. Si vous avez déjà un compte, vous êtes prêt. Vous pouvez également créer un compte Google distinct à des fins de test.

Étape 6: Obtenez une clé API

Pour activer l'API Google Nearby Messages pour iOS et obtenir une clé API, procédez comme suit:

1. Accédez à la Google Developers Console.
2. Créez ou sélectionnez un projet avec 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 les identifiants de l'API).
   Remarque: Si vous disposez 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. 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 à ce qui suit :

   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 l'API REST Proximity Beacon, veillez à générer toutes les clés API respectives dans le même projet de la console Google Developers. Pour en savoir plus, consultez le guide de démarrage pour Android et Premiers pas avec l'API REST.

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

L'objet Gestionnaire de messages vous permet de publier et de vous abonner. L'échange de messages n'est pas authentifié. Vous devez donc fournir la clé API que vous avez créée à l'étape précédente.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")