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 avere Versione 6.3 o successiva di Xcode.

Passaggio 2: scarica CocoaPods

L'API Google Nearby Messages per iOS è disponibile come CocoaPods. CocoaPods è una dipendenza open source per i progetti Swift e Objective-C Cocoa.

Se non hai ancora lo strumento CocoaPods, installalo su OS X eseguendo il comando seguente dal terminale. Per i dettagli, consulta la pagina relativa alla documentazione su CocoaPods Guida introduttiva.

$ 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 ora e salvalo nel tuo dalla macchina locale. Se non hai familiarità con lo sviluppo di iOS, crea una visualizzazione singola e assicurati che l'opzione Usa conteggio riferimenti automatico sia attivata.)
  • Crea un file denominato Podfile nella directory del tuo progetto. Questo file definisce delle dipendenze del progetto.

  • Modifica Podfile e aggiungi le tue 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, nonché le eventuali dipendenze.

    $ installazione di pod

  • Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del tuo progetto per avviare Xcode. D'ora 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 ponte al tuo progetto in modo da poter utilizzare le librerie installate dal file del pod. Per aggiungere un'intestazione ponte:

  1. Nella stessa directory del file .xcworkspace del progetto, aggiungi una nuova file di intestazione (denominalo come preferisci e utilizza l'estensione ".h").
  2. Incolla il codice seguente nel file creato: #import <GNSMessages.h>.
  3. Salva il file.
  4. Nel riquadro sinistro dell'editor del progetto, seleziona il progetto principale.
  5. Fai clic su Impostazioni build nella parte superiore dell'editor della build.
  6. Nelle impostazioni della build, vai a "Compiler Swift - Generazione del codice" (tipo "Compilatore Swift" nella casella di ricerca per individuarlo rapidamente).
  7. Fai clic sulla freccia per espandere la sezione Intestazione ponte Objective-C.
  8. In Debug e Release, aggiungi il percorso del file di intestazione è stato creato.
  9. Crea il progetto per applicare 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, non devi fare altro. Potresti anche volere Account Google separato a scopo di test.

Passaggio 6: ottieni una chiave API

Segui questi passaggi per attivare l'API Google Nearby Messages per iOS e ottenere un Chiave API:

  1. Vai alla pagina Google Developers Console.
  2. Crea o seleziona un progetto con 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 l'API) credenziali).
    Nota: se hai una chiave iOS esistente, puoi usarla.
  5. Nella finestra di dialogo visualizzata, inserisci l'identificatore pacchetto dell'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 simile alla seguente: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Per evitare il furto di quota, proteggi la tua chiave API seguendo queste indicazioni: best practice.
di Gemini Advanced.

Passaggio 7: crea un oggetto Gestione messaggi

L'oggetto Gestione messaggi consente di pubblicare e sottoscrivere. Scambio di messaggi corrente non autenticata, quindi devi fornire la chiave API che hai creato passaggio.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")