Primeiros passos

Este documento explica como começar a desenvolver com a API Nearby Messages em no iOS.

Etapa 1: obter a versão mais recente do Xcode

Para criar um projeto usando a API Google Nearby Messages para iOS, você precisa: versão 6.3 ou mais recente do Xcode.

Etapa 2: acessar o CocoaPods

A API Google Nearby Messages para iOS está disponível como um CocoaPods (em inglês). O CocoaPods é uma dependência de código aberto de projeto para projetos Cocoa em Swift e Objective-C.

Se você ainda não tem a ferramenta CocoaPods, instale-a no OS X executando o a seguir no terminal. Para mais detalhes, consulte Obter CocoaPods Guia de iniciação

$ sudo gem install cocoapods

Etapa 3: instalar a API usando o CocoaPods

Crie um Podfile para a API Google Nearby Messages para iOS e use-o para: instalar a API e as dependências dela.

  • Se você ainda não tiver um projeto Xcode, crie um agora e salve-o em seu máquina local. Se você não tem experiência com desenvolvimento para iOS, crie uma visualização única Application, e certifique-se de que a opção Usar contagem automática de referência esteja ativada.)
  • Crie um arquivo chamado Podfile no seu diretório do projeto Esse arquivo define seu dependências do projeto.

  • Edite o Podfile e adicione suas dependências. Este é um Podspec simples, incluindo o nome do pod que você precisa para a API Google Nearby Messages No iOS: 

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • Salve o Podfile.

  • Abra um terminal e acesse o diretório que contém o Podfile:

    $ cd

  • Execute o comando pod install. Isso instalará as APIs especificadas no Podspec e as respectivas dependências.

    $ instalação de pod

  • Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto. para iniciar o Xcode. A partir desse momento, você vai precisar usar o arquivo .xcworkspace para abrir o projeto.

Etapa 4: criar um cabeçalho de ponte (somente Swift)

Se você criou seu projeto usando Swift, adicione um cabeçalho de ponte ao seu para que ele possa usar as bibliotecas que foram instaladas pelo arquivo pod. Siga estas etapas para adicionar um cabeçalho de transmissão:

  1. No mesmo diretório do arquivo .xcworkspace do seu projeto, adicione um novo arquivo principal (nomeie-o como quiser e use uma extensão de nome de arquivo ".h").
  2. Cole o seguinte código no arquivo criado: #import <GNSMessages.h>:
  3. Salve o arquivo.
  4. No painel esquerdo do editor de projetos, selecione o projeto principal.
  5. Clique em Build Settings na parte de cima do editor de builds.
  6. Em "Build Settings", navegue até "Swift Compiler - Code Generation" (tipo "Compilador Swift" na caixa de pesquisa para localizá-lo rapidamente).
  7. Clique na seta para expandir a seção Objective-C Bridging Header.
  8. Em Depurar e Liberar, adicione o caminho para o arquivo principal que você criados.
  9. Crie o projeto para que as mudanças entrem em vigor.

Etapa 5: criar uma Conta do Google

Para usar as APIs do Nearby Messages, você precisa de uma Conta do Google. Se você já tem uma conta, então está tudo pronto. Você também pode querer uma uma Conta do Google separada para fins de teste.

Etapa 6: gerar uma chave de API

Siga estas etapas para ativar a API Google Nearby Messages para iOS e receber uma Chave de API:

  1. Vá para a Google Developers Console.
  2. Crie ou selecione um projeto para registrar seu aplicativo.
  3. Clique em Continuar para ativar a API.
  4. Na página Credenciais, crie uma nova chave do iOS e defina a API Credenciais).
    Observação: se você já tem uma chave do iOS, é possível usá-la.
  5. Na caixa de diálogo exibida, insira o identificador do pacote do app. Exemplo: 
    com.example.nearbyexample
  6. A nova chave de API para iOS aparece na lista de chaves de API do projeto. Uma chave de API é uma string de caracteres semelhante a esta: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Para evitar roubo de cota, proteja sua chave de API seguindo estas práticas recomendadas.
.

Etapa 7: criar um objeto do gerenciador de mensagens

O objeto gerenciador de mensagens permite publicar e se inscrever. A troca de mensagens é não autenticado; por isso, você deve fornecer a chave de API que você criou na última etapa.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")