Cette page a été traduite par l'API Cloud Translation.

Commencer

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

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

Pour compiler un projet à l'aide de l'API Google Nearby Messages pour iOS, vous devez disposer de la version 6.3 ou ultérieure de Xcode.

Étape 2: Obtenez 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 disposez pas encore de l'outil CocoaPods, installez-le sur OS X en exécutant la commande suivante à 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 ordinateur local. (Si vous débutez dans le développement iOS, créez une application Single View 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 les dépendances de votre projet.
Modifiez le Podfile et ajoutez vos dépendances. Voici une spécification de pod 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. Cette opération permet d'installer les API spécifiées dans Podspec, ainsi que toutes leurs dépendances.

$ installation de pod
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éer un en-tête de pontage (Swift uniquement)

Si vous avez créé votre projet en utilisant 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:

Dans le même répertoire que le fichier .xcworkspace de votre projet, ajoutez un nouveau fichier d'en-tête (attribuez-lui le nom de votre choix et utilisez l'extension de nom de fichier ".h").
Collez le code suivant dans le fichier que vous avez créé : #import <GNSMessages.h>.
Enregistrez le fichier.
Dans le volet gauche de l'éditeur de projet, sélectionnez le projet principal.
Cliquez sur Build Settings (Paramètres de compilation) en haut de l'éditeur de compilation.
Dans les paramètres de compilation, accédez à "Swift Compiler - Code Generation" (saisissez "Swift Compiler" dans le champ de recherche pour le localiser rapidement).
Cliquez sur la flèche pour développer la section Objective-C Bridging Header (En-tête de liaison Objective-C).
Sous Debug and Release (Déboguer et publier), ajoutez le chemin d'accès au fichier d'en-tête que vous avez créé.
Créez le projet pour que les modifications prennent effet.

Étape 5: Créez 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 avoir 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:

Accédez à la Google Developers Console.
Créez ou sélectionnez un projet pour enregistrer votre application.
Cliquez sur Continuer pour activer l'API.
Sur la page Identifiants, créez une clé iOS (et définissez les identifiants de l'API).
Remarque: Si vous disposez déjà d'une clé iOS, vous pouvez l'utiliser.
Dans la boîte de dialogue qui s'affiche, saisissez l'identifiant du bundle de votre application. Par exemple :
```
com.example.nearbyexample
```
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 à ceci :
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```
Pour éviter le vol de quotas, sécurisez votre clé API en suivant ces bonnes pratiques.

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

L'objet Gestionnaire de messages vous permet de publier vos messages 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")