Inizia

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.

$ sudo gem install cocoapods

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 con lo 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:

  1. Nella stessa directory del file .xcworkspace del progetto, aggiungi un nuovo file di intestazione (assegna un nome a piacere e utilizza l'estensione ".h").
  2. Incolla il seguente codice nel file che hai creato: #import <GNSMessages.h>.
  3. Salva il file.
  4. Nel riquadro a sinistra dell'editor del progetto, seleziona il progetto principale.
  5. Fai clic su Impostazioni di compilazione nella parte superiore dell'editor di compilazione.
  6. In Impostazioni di compilazione, vai a "Compilatore Swift - Generazione codice" (digita "Compilatore Swift" nella casella di ricerca per trovarla rapidamente).
  7. Fai clic sulla freccia per espandere la sezione Intestazione di bridging Objective-C.
  8. In Debug e Release, aggiungi il percorso del file di intestazione che hai creato.
  9. 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:

  1. Vai a Google Developers Console.
  2. Crea o seleziona un progetto a cui registrare l'applicazione.
  3. Fai clic su Continua per abilitare l'API.
  4. Nella pagina Credenziali, crea una nuova chiave per iOS (e imposta le credenziali API).
    Nota: se hai già una chiave per iOS, puoi utilizzarla.
  5. Nella finestra di dialogo visualizzata, inserisci l'identificatore del bundle della tua app. Ad esempio: 
    com.example.nearbyexample
  6. 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
  7. Per evitare il furto di quote, metti al sicuro 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.

Objective-CSwift

#import <GNSMessages.h>

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


let messageManager = GNSMessageManager(APIKey: "API_KEY")