Você pode modificar o AndroidManifest usando um destes dois métodos:

Método 1: Manifesto personalizado do Unity

1. Navegue até File > Build Settings > Player Settings > Publishing Settings .
2. Ative "Custom Main Manifest" na seção Publishing Settings.
3. O Unity gera um arquivo AndroidManifest.xml padrão em Assets/Plugins/Android/AndroidManifest.xml .
4. Edite este arquivo para adicionar as permissões e configurações necessárias.

Fonte: Documentação do Unity sobre o Android Manifest

Método 2: Android Studio

1. Exporte seu projeto do Unity usando File > Build Settings > Export Project .
2. Abra o projeto exportado no Android Studio.
3. Edite o arquivo AndroidManifest.xml diretamente no Android Studio.

Método 1: Template personalizado do Unity

1. Navegue até File > Build Settings > Player Settings > Publishing Settings .
2. Ative "Custom Gradle Template" na seção Publishing Settings.
3. O Unity gera um arquivo mainTemplate.gradle em Assets/Plugins/Android/mainTemplate.gradle .
4. Adicione suas configurações personalizadas do Gradle a este arquivo.

Fonte: Documentação de visão geral do Gradle no Unity

Método 2: Android Studio

1. Exporte seu projeto do Unity.
2. Abra o projeto no Android Studio.
3. Edite o arquivo build.gradle do app diretamente.

Ao compilar apps Android no Unity, você pode encontrar erros de "Duplicate class" causados por várSDK do iOSs que incluem as mesmas dependências transitivas. Isso geralmente ocorre com a biblioteca Android Vending Licensing ao usar tanto o AppLovin SDK quanto o Singular SDK.

Duplicate class com.android.vending.licensing.ILicensingService found in modules
applovin-sdk-13.5.0.aar -> jetified-applovin-sdk-13.5.0-runtime (com.applovin:applovin-sdk:13.5.0)
and singular_sdk-12.11.0.aar -> jetified-singular_sdk-12.11.0-runtime (com.singular.sdk:singular_sdk:12.11.0)

Solução 1: Usando o External Dependency Manager (EDM4U)

Se o seu projeto usa o External Dependency Manager for Unity (recomendado), adicione regras de exclusão ao seu arquivo Dependencies XML.

1. Localize o arquivo *Dependencies.xml no seu projeto Unity (normalmente em Assets/Editor ou em um local semelhante).
2. Adicione uma regra de exclusão a uma das dependências do SDK:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.applovin:applovin-sdk:13.5.0">
      <androidSdkPackageIds>
        <exclude group="com.android.vending" module="licensing"/>
      </androidSdkPackageIds>
    </androidPackage>
    <androidPackage spec="com.singular.sdk:singular_sdk:12.11.0" />
  </androidPackages>
</dependencies>

Solução 2: Usando templates personalizados do Gradle

Se você não está usando o EDM4U, aplique as regras de exclusão diretamente nos seus arquivos de configuração do Gradle.

1. Navegue até File > Build Settings > Player Settings > Publishing Settings .
2. Ative "Custom Main Gradle Template" ou "Custom Launcher Gradle Template" .
3. Abra Assets/Plugins/Android/mainTemplate.gradle (ou launcherTemplate.gradle ).
4. Adicione a regra de exclusão ao seu bloco de dependências:

dependencies {
    implementation('com.applovin:applovin-sdk:13.5.0') {
        exclude group: 'com.android.vending', module: 'licensing'
    }
    implementation 'com.singular.sdk:singular_sdk:12.11.0'
}

Alternativa: Aplique uma exclusão global adicionando isto após o seu bloco de dependências:

configurations.all {
    exclude group: 'com.android.vending', module: 'licensing'
}

Verifique a resolução

1. Após aplicar a exclusão, limpe seu projeto excluindo as pastas Library/Bee e Temp .
2. Recompile seu projeto Android no Unity.
3. Verifique se o erro de classe duplicada não aparece mais na saída da build.

Se o seu projeto usa o ProGuard para ofuscação de código, adicione as seguintes regras de keep ao seu arquivo proguard-unity.txt para evitar que o Singular SDK seja removido:

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

Após compilar seu projeto Unity para iOS e antes de compilar no Xcode, atualize as dependências do CocoaPods para garantir que você tenha as versões mais recentes do SDK.

cd /path/to/your/ios/project
pod repo update
pod update

Para testar sua integração, registre o IDFV (Identifier for Vendor) para adicionar rapidamente seu dispositivo de teste no Singular SDK Console.

Adicionar registro do IDFV

1. Abra seu projeto Xcode após compilar a partir do Unity.
2. Navegue até Classes > UnityAppController.mm .
3. Localize o método applicationDidBecomeActive .
4. Adicione o seguinte código para registrar o IDFV:

// Log IDFV for testing
NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

5. Compile e execute seu app no Xcode.
6. Verifique os logs do console do Xcode para ver a saída do IDFV.
7. Copie o IDFV e adicione-o como dispositivo de teste no Singular SDK Console .

Habilite os Universal Links para deep linking configurando os Associated Domains no seu projeto Xcode.

Etapas de configuração do Deep Link

1. Adicione o Associated Domain: No Xcode, navegue até a aba Signing & Capabilities do target do seu app.
2. Habilite a capability: Clique em [+] Capability e adicione "Associated Domains" .
3. Adicione o domínio: Adicione seu domínio de tracking da Singular no formato: applinks:yourdomain.sng.link
4. Configure o Team ID: No dashboard da Singular, navegue até as configurações do seu app e adicione seu Apple Team ID. Isso permite que a Singular gere e hospede o arquivo Apple App Site Association (AASA) exigido para os Universal Links.

Se você está usando outros SDKs que registram o UnityAppController (como Firebase, Adjust ou AppsFlyer), você pode encontrar conflitos que impedem a inicialização correta da Singular. No Unity, apenas uma classe pode se registrar como UnityAppController por vez.

Para resolver esse conflito:

1. Abra o arquivo SingularSwizzledAppController.m no seu projeto Xcode.
2. Descomente todo o código deste arquivo.
3. Abra SingularAppDelegate.m e valide se a seguinte linha não está comentada:

   IMPL_APP_CONTROLLER_SUBCLASS(SingularAppDelegate)

Isso permite que a Singular funcione em conjunto com outros SDKs usando method swizzling em vez de criar uma subclasse do UnityAppController.

Adicionar o Prefab à cena

1. No painel Project , navegue até Packages > Singular > SingularSDK > Prefabs .
2. Arraste o prefab SingularSDKObject para o seu painel Hierarchy .
3. O prefab agora está pronto para ser configurado no Inspector.

Criação manual do GameObject

1. No painel Hierarchy , clique com o botão direito e selecione Create Empty .
2. Nomeie o GameObject como SingularSDKObject (nome exato obrigatório).
3. Com o GameObject selecionado, navegue até o painel Inspector .
4. Clique em Add Component .
5. Pesquise por "Singular" e selecione o componente de script Singular SDK .

• Initialize On Awake: Habilitado por padrão. O SDK é inicializado automaticamente quando o GameObject é despertado (awake). Desabilite isto se você precisar atrasar a inicialização por consentimento de privacidade ou outros requisitos.
• SKAN Enabled: Habilitado por padrão (apenas iOS). Habilita a atribuição via SKAdNetwork em Managed Mode, onde a Singular atualiza automaticamente os conversion values com base no seu modelo de conversão configurado.
• Wait For Tracking Authorization: Definido como 0 (desabilitado). Se o seu app exibe o prompt do iOS App Tracking Transparency (ATT), defina isto como 300 segundos. Isso atrasa a sessão do SDK até que o usuário responda ao prompt do ATT, garantindo que o IDFA possa ser capturado se o consentimento for concedido. Deixe em 0 se não estiver usando o ATT.
• Enable Logging: Habilitado por padrão. Gera logs de debug do SDK para ajudar na integração e no troubleshooting. Deve ser desabilitado em builds de produção. Funciona com a configuração Log Level (veja abaixo).
• Log Level: Definido como 3 (Info) por padrão. Controla a verbosidade do logging. Números menores produzem logs mais verbosos:
  C#

  // Based on Android Logger log levels
  public enum LogLevel {
     Verbose = 2,  // Most verbose
     Debug   = 3,
     Info    = 4,  // Default
     Warn    = 5,
     Error   = 6,
     Assert  = 7   // Least verbose
  }

  Observação: Logs detalhados estão disponíveis principalmente no Android.

• DDL Timeout Sec: Definido como 0 (usa o padrão de 60 segundos). Determina por quanto tempo o SDK aguarda os dados de deferred deep link do servidor. O servidor para de pesquisar após esse timeout se nenhum deferred deep link for encontrado.
• Session Timeout Sec: Definido como 0 (usa o padrão de 60 segundos). Define por quanto tempo o app pode ficar em segundo plano antes de o SDK criar uma nova sessão ao retornar ao primeiro plano.
• Shortlink Resolve Timeout: Definido como 0 (usa o padrão de 10 segundos). Tempo máximo de espera para a resolução de short links. Protege a experiência do usuário evitando longas esperas se um short link não puder ser resolvido.

Se você precisar dar suporte ao método legado de atribuição do Meta Install Referrer, adicione seu Facebook App ID à configuração do SingularSDKObject.

Etapas de configuração

1. Selecione o SingularSDKObject na hierarquia da sua cena.
2. No painel Inspector, localize o campo "Facebook App ID" .
3. Insira seu Facebook App ID (encontre-o no seu Facebook Developer Console).

Recursos adicionais:

• O que é o Meta Install Referrer?
• Onde encontrar seu Facebook App ID

Procedimento de upgrade

Conclua estas etapas em ordem antes de instalar o SDK via Unity Package Manager: