Começar

Aviso: o recurso Mensagens por perto foi descontinuado e vai parar de funcionar em dezembro de 2023. Acesse Nearby Connections para mais suporte ou Diretrizes de migração sobre como migrar o uso atual 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 Nearby Messages do Google para iOS, você precisa da versão 6.3 ou mais recente do Xcode (em inglês).

Etapa 2: instalar o CocoaPods

A API Nearby Messages do Google para iOS está disponível como um pod do CocoaPods (em inglês). 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 verifique se a opção "Usar contagem automática de referências" está ativada.
• Crie um arquivo chamado Podfile no seu diretório do projeto Esse arquivo define as dependências do projeto.

• Edite o Podfile e adicione suas dependências. Confira um Podspec simples, incluindo o nome do pod necessário para a API Nearby Messages do Google 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, além das dependências que elas possam ter.

  $ 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 Swift, adicione um cabeçalho de ponte ao projeto para que ele possa usar as bibliotecas instaladas pelo arquivo 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 de cabeçalho (dê o nome que quiser e use a extensão ".h").
2. Cole o código a seguir no arquivo criado: #import <GNSMessages.h>.
3. Salve o arquivo.
4. No painel à esquerda 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 "Build Settings", navegue até "Swift Compiler - Code Generation" (digite "Swift Compiler" na caixa de pesquisa para localizar rapidamente).
7. Clique na seta para abrir a seção Cabeçalho de ponte Objective-C.
8. Em Debug e Release, adicione o caminho para o arquivo de cabeçalho que você criou.
9. Crie o projeto para que as mudanças entrem em vigor.

Etapa 5: ter 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 receber 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 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 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 do Proximity Beacon, gere todas as chaves de API respectivas no mesmo projeto do Google Developers Console. Para mais informações, consulte o guia de primeiros passos para Android e Começar a usar a API REST.

Etapa 7: criar um objeto gerenciador de mensagens

O objeto 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")