Comece agora

Este documento explica como começar a desenvolver com a API Nearby Messages 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 da versão 6.3 ou mais recente do Xcode.

Etapa 2: instalar o CocoaPods

A API Google Nearby Messages para iOS está disponível como um pod CocoaPods. O CocoaPods é um gerenciador de dependências de código aberto para projetos Cocoa em Swift e Objective-C.

Se você ainda não tem a ferramenta CocoaPods, instale-a no OS X executando o comando a seguir no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods.

$ sudo gem install cocoapods

Etapa 3: instalar a API usando 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 na sua máquina local. Se você é novo no desenvolvimento para iOS, crie um aplicativo de visualização única e verifique se a opção "Usar contagem automática de referência" está ativada.
  • Crie um arquivo chamado Podfile no seu diretório do projeto Esse arquivo define as dependências do seu projeto.
  • Edite o Podfile e adicione suas dependências. Este é um Podspec simples, incluindo o nome do pod necessário para a API Google Nearby Messages para 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 vai instalar as APIs especificadas no Podspec com as respectivas dependências.

    $ instalação de pod

  • Feche o Xcode e clique duas vezes para abrir o arquivo .xcworkspace do projeto e iniciar o Xcode. A partir desse momento, use o arquivo .xcworkspace para abrir o projeto.

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

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

  1. No mesmo diretório do arquivo .xcworkspace do projeto, adicione um novo arquivo de cabeçalho. Escolha o nome que quiser e use a extensão ".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 build Editor.
  6. Em "Build Settings", navegue até "Swift Compiler - Code Generation" (digite "Swift Compiler" na caixa de pesquisa para localizá-lo rapidamente).
  7. Clique na seta para expandir a seção Cabeçalho de ponte do Objective-C.
  8. Em Debug e Release, adicione o caminho para o arquivo principal que você criou.
  9. Compile o projeto para que as alterações entrem em vigor.

Etapa 5: criar uma Conta do Google

Para usar as APIs Nearby Messages, você precisa de uma Conta do Google. Se você já tem uma conta, então está tudo pronto. Você também pode usar 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 gerar uma chave de API:

  1. Acesse o 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 iOS e defina as credenciais da API.
    Observação: se você já tem uma chave iOS, use-a.
  5. Na caixa de diálogo resultante, insira o identificador do pacote do seu aplicativo. Por 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, algo como:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Para evitar roubo de cota, proteja sua chave de API seguindo estas práticas recomendadas.

Etapa 7: criar um objeto gerenciador de mensagens

O objeto gerenciador de mensagens permite que você publique e se inscreva. A troca de mensagens não é autenticada. Portanto, você precisa fornecer a chave de API criada na etapa anterior.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")