Começar

Aviso: o recurso Mensagens por perto foi descontinuado e vai deixar de funcionar em dezembro de 2023. Acesse o guia de migração para saber como migrar o uso das Mensagens por perto para a API 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 pod do 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 tiver a ferramenta CocoaPods, instale-a no OS X executando o comando abaixo no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods.

$ 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ê não tem experiência com o desenvolvimento para iOS, crie um aplicativo de visualização única e ative a opção "Use Automatic Reference Counting".)
• 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 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.

  $ pod install

• Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o Xcode. A partir desse momento, será preciso usar o arquivo .xcworkspace para abrir o projeto.

Etapa 4: criar um cabeçalho de transmissão (somente Swift)

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

1. No mesmo diretório do arquivo .xcworkspace do projeto, adicione um novo arquivo de cabeçalho (nomeie como quiser e use a extensão de nome ".h").
2. Cole o seguinte código no arquivo criado: #import <GNSMessages.h>.
3. Salve o arquivo.
4. No painel esquerdo do editor de projeto, selecione o projeto principal.
5. Clique em Build Settings 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 localizá-lo rapidamente.
7. Clique na seta para abrir a seção Objective-C Bridging Header.
8. Em Debug e Release, adicione o caminho para o arquivo de cabeçalho 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 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 nova chave do iOS e defina as credenciais da API.
   Observação: se você já tiver uma chave do iOS, poderá usá-la.
5. Na caixa de diálogo resultante, digite o identificador de 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, similar a esta:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Para evitar o roubo de cota, proteja a 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 correspondentes no mesmo projeto do console do Google Developers. Para mais informações, consulte o Guia de início para Android e Começar a usar a API REST.

Etapa 7: criar um objeto de gerenciador de mensagens

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