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 Google Nearby Messages per iOS, devi disporre della 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 di dipendenze open source per i progetti Swift e Objective-C Cocoa.

Se non hai ancora lo strumento CocoaPods, installalo su OS X eseguendo il seguente comando dal terminale. Per maggiori dettagli, consulta la guida introduttiva a 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 mai sviluppato per iOS, crea un'applicazione Single View e assicurati che l'opzione Use Automatic Reference Counting sia attivata.
  • Crea un file denominato Podfile nella directory del progetto. Questo file definisce le dipendenze del progetto.

  • Modifica il file Podfile e aggiungi le dipendenze. Ecco un 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. 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 bridging header (solo Swift)

Se hai creato il progetto utilizzando Swift, devi aggiungere un bridging header 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 il nome che preferisci 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 build nella parte superiore dell'editor di build.
  6. In Impostazioni di compilazione, vai a "Swift Compiler - Code Generation" (digita "Swift Compiler" nella casella di ricerca per individuarlo rapidamente).
  7. Fai clic sulla freccia per espandere la sezione Objective-C Bridging Header.
  8. In Debug e Release, aggiungi il percorso del 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 disporre di un Account Google. Se hai già un account, è tutto pronto. Ti consigliamo anche di disporre di un Account Google separato per i 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 a cui registrare la tua applicazione.
  3. Fai clic su Continua per abilitare l'API.
  4. Nella pagina Credenziali, crea una nuova chiave iOS (e imposta le credenziali API).
    Nota: se hai una chiave iOS esistente, puoi utilizzarla.
  5. Nella finestra di dialogo risultante, inserisci l'identificatore 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 tuo progetto. Una chiave API è una stringa di caratteri, ad esempio: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Per evitare il furto di quote, proteggi la tua chiave API seguendo queste best practice.

Passaggio 7: crea un oggetto Message Manager

L'oggetto Message Manager ti consente di pubblicare e abbonarti. Lo scambio di messaggi non è autenticato, quindi devi fornire la chiave API che hai creato nel passaggio precedente.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")