Pré-requisitos de ligações singulares

Para iOS: O Singular Links usa o iOS Universal Links e esquemas de aplicativos para links diretos. Para habilitar esses recursos, siga estas etapas:

1. Configurar Universal Links:

   • Faça login no Portal do desenvolvedor da Apple.
   • Vá para Identificadores e selecione o aplicativo para o qual deseja habilitar os Links universais.
     

     

   • No menu Capacidades, selecione a caixa de verificação Domínios associados e clique em Guardar.
     

     

2. Adicione o direito de Domínios associados:

   • Abra o Xcode e navegue até Definições do projeto > Capacidades > Domínios associados.
   • Adicione seus domínios de links singulares usando o seguinte formato: applinks:jhflasjfhlasfu
     

     

   • Copie o Prefixo do aplicativo (também conhecido como ID da equipe) do Portal do desenvolvedor da Apple.

   • No Singular, vá para Configuração de aplicativos, localize seu aplicativo, expanda a opção"Mostrar configurações avançadas" do site do aplicativo iOS e cole o ID da equipe no campo apropriado. Isso permite que o Singular hospede o arquivo apple-app-site-association no seu domínio Singular para Universal Links.

     

   Nota: A conclusão deste passo é crucial para cenários em que os Universal Links podem não funcionar corretamente. Saiba mais sobre as limitações dos Universal Links aqui. Se este passo for omitido, todos os Singular Links serão redireccionados para a App Store e os deep links não funcionarão.

3. Opcional - Configure o Esquema de aplicações se não estiver a utilizar Ligações universais:

   • Abaixo do campo ID da equipa, introduza o Esquema de aplicações da sua aplicação iOS para ativar a hiperligação profunda do esquema de aplicações tradicional como uma alternativa aos Universal Links.
     

   Se esta for a primeira vez que a sua aplicação suporta um esquema de aplicações iOS, registe o esquema de aplicações como um Tipo de URL no seu projeto Xcode.
   
   Para obter mais informações, consulte o artigo de ajuda do desenvolvedor da Apple.

Para Android: O Singular Links usa o Android App Links e o Scheme Links para ativar o deep linking. Para configurar esses recursos, siga estas etapas:

1. Gerar e fornecer impressões digitais SHA256:

   Para produção:

   • Aceder à Consola do Google Play.
   • Navegue até Configuração > Assinatura de aplicativos para encontrar a impressão digital SHA256 pública.
   • Envie a impressão digital SHA256 para o seu comerciante de aplicativos, para aplicação na etapa 4 abaixo.

     

   Para desenvolvimento:

   • Localize o ficheiro keystore da sua aplicação. Geralmente, ele está em debug.keystore.

     Windows:

     C:\Users\USERNAME\.android\debug.keystore

     Linux/Mac:

     ~/.android/debug.keystore

   • Abra a linha de comando, navegue até a pasta keystore e execute:

     keytool -list -v -keystore debug.keystore

   A palavra-passe predefinida para debug.keystore é "android". Envie a impressão digital SHA256 encontrada na saída para o seu comerciante de aplicativos, para aplicação na etapa 4 abaixo.

2. Configurar links de aplicativos:

   Nota: Neste exemplo, o domínio verificado é: example.sng.link
   • Se quiser verificar vários domínios, cada um receberá um bloco de filtro de intenção separado (crie um bloco de código por domínio).
   • Para as aplicações com ligações existentes, pode migrar as ligações para a tecnologia de ligações de aplicações Android agora suportada ou mantê-las com o esquema de URL (inalterado).
   • Para migrar para a tecnologia de links de aplicativos Android agora suportada:
     Permitir os seguintes domínios de caminho: "/E" e "/F" e "/A" e "/B"
   • Adicione o seguinte filtro de intenção ao seu AndroidManifest.xml para lidar com ligações de aplicações:

     <intent-filter android:autoVerify="true">
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="http" />
         <data android:scheme="https" />
         <data android:host="example.sng.link" />
         <data android:pathPrefix="/A"/>
         <data android:pathPrefix="/B"/>
         <data android:pathPrefix="/E"/>
         <data android:pathPrefix="/F"/>
     </intent-filter>

     Esta configuração permite que a sua aplicação abra ligações como: https://example.sng.link/Eabcd/1234
3. Opcional - Configure o esquema de aplicações se não estiver a utilizar ligações de aplicações:
   • Adicione o seguinte filtro de intenção ao seu AndroidManifest.xml para lidar com ligações de aplicações:

     <intent-filter>
         <data android:scheme="https"/>
         <data android:host="example.sng.link" />
         <action android:name="android.intent.action.VIEW"/>
         <category android:name="android.intent.category.DEFAULT"/>
         <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>

4. Configurar o esquema de aplicativos do Android:

   • No Singular, aceda a Definições > Aplicações, localize a sua aplicação, expanda a opção"Mostrar Definições Avançadas" do site da aplicação Android e introduza as impressões digitais SHA256 das Ligações de Aplicações Android no campo Impressões digitais SHA256 das Ligações de Aplicações.
   • Opcionalmente, adicione o Esquema do Android se não estiver a utilizar Ligações de Aplicações para corresponder ao scheme://host conforme introduzido no filtro de intenções AndroidManifest.xml.