Inizia

Questo documento spiega come iniziare a sviluppare con l'API Nearby Messages su iOS.

Passaggio 1: scarica l'ultima versione di Xcode

Per creare un progetto utilizzando l'API Nearby Messages di Google per iOS, è necessaria la versione 6.3 o successiva 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 i progetti Cocoa Swift e Objective-C.

Se non hai ancora lo strumento CocoaPods, installalo su OS X eseguendo questo 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 sue dipendenze.

  • Se non hai ancora un progetto Xcode, creane uno e salvalo sulla tua macchina locale. (se non hai mai utilizzato lo sviluppo in iOS, crea un'applicazione a visualizzazione singola e assicurati che l'opzione Usa 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 una semplice 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 Podfile.

  • Apri un terminale e vai alla directory contenente Podfile:

    cd $

  • Esegui il comando pod install. Questa operazione installerà le API specificate nel podspec, insieme alle eventuali dipendenze.

    $ installazione pod

  • Chiudi Xcode, quindi apri (doppio clic) il file .xcworkspace del tuo progetto per avviare Xcode. Da questo momento in poi, dovrai utilizzare il file .xcworkspace per aprire il progetto.

Passaggio 4: crea un'intestazione di collegamento (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 del pod. Per aggiungere un'intestazione di collegamento:

  1. Nella stessa directory in cui si trova il file .xcworkspace del progetto, aggiungi un nuovo file di intestazione (puoi assegnargli il nome che preferisci e usare l'estensione di nome ".h").
  2. Incolla questo codice nel file 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 build nella parte superiore dell'editor di build.
  6. In Impostazioni build, vai a "Compilatore Swift - Generazione di codice" (digita "Swift Compiler" nella casella di ricerca per individuarlo rapidamente).
  7. Fai clic sulla freccia per espandere la sezione Intestazione bridging di Objective-C.
  8. In Debug e Release, aggiungi il percorso al file di intestazione che hai creato.
  9. Crea il progetto per rendere effettive le modifiche.

Passaggio 5: crea un Account Google

Per utilizzare le API Nearby Messages, devi avere un Account Google. Se hai già un account, non devi fare altro. Ti consigliamo anche di avere un Account Google separato per scopi di test.

Passaggio 6: ottieni una chiave API

Segui questi passaggi per abilitare l'API Google Nearby Messages per iOS e ottenere una chiave API:

  1. Vai a Google Developers Console.
  2. Crea o seleziona un progetto con cui registrare la tua applicazione.
  3. Fai clic su Continua per attivare l'API.
  4. Nella pagina Credenziali, crea una nuova chiave iOS (e imposta le Credenziali API).
    Nota: se disponi già di una chiave iOS, puoi utilizzarla.
  5. Nella finestra di dialogo visualizzata, inserisci l'identificatore del bundle dell'app. Ad esempio:
    com.example.nearbyexample
  6. La nuova chiave API iOS viene visualizzata nell'elenco delle chiavi API del progetto. Una chiave API è una stringa di caratteri, simile alla seguente:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Per evitare il furto di quota, proteggi la tua chiave API seguendo queste best practice.

Passaggio 7: crea un oggetto Message Manager

L'oggetto Message Manager consente di pubblicare e sottoscrivere un abbonamento. Lo scambio di messaggi non è autenticato, quindi devi fornire la chiave API creata nel passaggio precedente.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")