Como depurar Dynamic Links

Fluxograma da página de visualização

Para ajudar a depurar Dynamic Links, visualize um fluxograma gerado automaticamente sobre o comportamento deles em diferentes plataformas e configurações. Gere o fluxograma com a adição do parâmetro d=1 a qualquer link dinâmico curto ou longo. Por exemplo, example.page.link/suffix?d=1 para um link dinâmico curto.

A página de visualização tem a seguinte aparência:

Uma captura de tela da página de visualização

Ferramenta de autodiagnóstico para iOS

Se você tiver problemas com a integração de links dinâmicos no iOS, use a ferramenta de autodiagnóstico integrada às versões 2.1.0 e mais recentes do SDK do Dynamic Links.

A ferramenta pode ser chamada de qualquer ponto no seu código conforme mostramos abaixo.

Swift

Observação: este produto do Firebase não está disponível para destinos macOS, Mac Catalyst, tvOS ou watchOS.
DynamicLinks.performDiagnostics(completion: nil)

Objective-C

Observação: este produto do Firebase não está disponível para destinos macOS, Mac Catalyst, tvOS ou watchOS.
[FIRDynamicLinks performDiagnosticsWithCompletion:nil];

Por padrão, a ferramenta imprime informações de depuração, incluindo qualquer erro detectado, na saída padrão. Por exemplo, digamos que seu app iOS não receba Dynamic Links como esperado. As informações geradas pela ferramenta de autodiagnóstico serão as seguintes:

---- Firebase Dynamic Links diagnostic output start ----
Firebase Dynamic Links framework version 2.1.0
System information: OS iOS, OS version 11.0, model iPhone
Current date 2017-08-14 22:52:56 +0000
AutomaticRetrievalEnabled: YES
ERROR: Specified custom URL scheme is com.google.AppInvitesSample.dev but Info.plist do not contain such scheme in CFBundleURLTypes key.
AppID Prefix: EQHXZ8M8AV, Team ID: EQHXZ8M8AV, AppId Prefix equal to Team ID: YES
performDiagnostic detected 1 ERRORS.
---- Firebase Dynamic Links diagnostic output end ----

Nesse exemplo, Dynamic Links não funcionam porque o esquema de URL personalizado não está configurado corretamente.

Erros e avisos comuns

O app Android não tem SHA256. O AppLinks não está ativado para o app.

Para usar links de apps para Android no seu app, crie um certificado SHA256.

Depois de criar o certificado SHA256, adicione-o ao seu app no Console do Firebase. Consulte Adicionar uma impressão digital SHA.

Não conseguimos encontrar o nome do pacote para Android "com.example" e/ou o código do pacote para iOS "com.example"

Para usar Dynamic Links com seu app Android ou iOS, adicione o app ao seu projeto do Firebase. Consulte Adicionar um app.

O app para iOS não contém um Team ID. O UniversalLinks não está ativado para o app.

Para usar links universais no app, adicione um Team ID no Console do Firebase. Consulte Adicionar um ID da App Store ou um Team ID.

Localize o Team ID no Apple Member Center, na guia "Membership".

O ID da App Store da Apple não existe no pacote do iOS fornecido. O app será ignorado.

Isso significa que o app listado em https://itunes.apple.com/us/app/yourapp/idSTOREID não contém o ID do pacote.

Esquema personalizado de iOS inválido

Um esquema personalizado tem que começar com um caractere alfabético (A a Z, a a z) e pode ser seguido por qualquer número de caracteres alfanuméricos, +, - ou .. Também não pode ser o seguinte: "javascript", "vbscript", "data", "blob", "http", "https", "mailto", "showscript", "facetime", "facetime-audio".

O projeto não tem Dynamic Links configurados

Para começar a usar Dynamic Links, você precisa ativá-los para seu projeto no Console do Firebase.

Algo mais?

Se você tiver outro problema, consulte a página de suporte do Firebase.