Começar

Aviso: o recurso Nearby Messages está obsoleto e vai parar de funcionar em dezembro de 2023. Acesse o Nearby Connections para mais suporte ou o guia de migração sobre como migrar o uso do Nearby Messages para o Nearby Connections.

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 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 essa ferramenta, instale-a no OS X executando o seguinte comando no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods (em inglês).

$ 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 no computador local. Se você tem pouca experiência com desenvolvimento para iOS, crie um aplicativo de visualização única e ative a opção "Usar contagem automática de referências".
• Crie um arquivo chamado Podfile no diretório do projeto. para definir as dependências.

• Edite o Podfile e adicione suas dependências. Confira 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 instalará as APIs especificadas no Podspec e as respectivas dependências.

  $ pod install

• Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. Depois disso, é preciso usar o arquivo .xcworkspace para abrir o projeto.

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

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

1. No mesmo diretório do arquivo .xcworkspace do projeto, adicione um novo arquivo principal (dê o nome que 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 Configurações de build na parte de cima do editor de build.
6. Em "Configurações de build", navegue até "Compilador Swift - Geração de código" (digite "Compilador Swift" na caixa de pesquisa para encontrá-lo rapidamente).
7. Clique na seta para abrir a seção Cabeçalho de ponte Objective-C.
8. Em Depurar e Versão, adicione o caminho para o arquivo principal criado.
9. Crie o projeto para que as mudanças 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. Para fins de teste, utilize uma Conta do Google separada.

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 do iOS e defina as credenciais da API.
   Observação: se você já tiver uma chave do iOS, use-a.
5. Na caixa de diálogo resultante, insira o identificador do pacote do app. Exemplo:

   com.example.nearbyexample

6. A nova chave de API do iOS aparece na lista de chaves de API do projeto. Uma chave de API é uma string de caracteres, similar a esta:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Para evitar o roubo de cota, proteja sua chave de API seguindo estas práticas recomendadas.

Observação: se você também estiver desenvolvendo um app Android ou usando a API REST Proximity Beacon, gere todas as chaves de API respectivas no mesmo projeto do Google Developers Console. Para mais informações, consulte o guia Primeiros passos para Android, e Começar a usar a API REST.

Etapa 7: criar um objeto de gerenciador de mensagens

O objeto de gerenciador de mensagens permite publicar e se inscrever. 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")