Começar

Instalar a versão mais recente do Xcode

Para usar o Nearby Connections no seu projeto, é necessário o Xcode 13.0 ou mais recente.

Adicionar o pacote Nearby Connections ao projeto

O Xcode vem com um gerenciador de pacotes integrado. Para adicionar o Nearby Connections ao seu projeto do Xcode, selecione Arquivo > Adicionar pacotes… e pesquise google/nearby. Em seguida, clique em Adicionar pacote e aguarde a conclusão do processo (isso pode levar alguns minutos).

Solicitar acesso a recursos protegidos

O Nearby Connections precisa de acesso ao Bluetooth e à rede local para anunciar, descobrir, fazer conexões e transferir dados. Forneça uma descrição de uso para cada recurso necessário no Info.plist do app. Caso contrário, as tentativas de acessar o recurso vão falhar e podem até causar falhas no app.

Chaves de descrição de uso obrigatórias:

  • NSBluetoothAlwaysUsageDescription
  • NSLocalNetworkUsageDescription

Além das chaves de descrição de uso, também é necessário adicionar uma chave NSBonjourServices com uma lista dos tipos de serviço que serão navegados pelo app. O único tipo de serviço que precisa ser adicionado pode ser gerado usando os primeiros 12 bytes do hash SHA-256 do ID do serviço do app.

Você pode usar a seguinte ferramenta para gerar esse valor automaticamente: