다음 두 가지 방법 중 하나를 사용하여 AndroidManifest를 수정할 수 있습니다:

방법 1: Unity 커스텀 매니페스트

1. 파일 > 빌드 설정 > 플레이어 설정 > 퍼블리싱 설정으로 이동합니다.
2. 퍼블리싱 설정 섹션에서 "커스텀 메인 매니페스트" 를 활성화합니다.
3. Unity는 Assets/Plugins/Android/AndroidManifest.xml에 기본 AndroidManifest.xml파일을 생성합니다.
4. 이 파일을 편집하여 필요한 권한과 구성을 추가합니다.

출처: Unity 안드로이드 매니페스트 문서

방법 2: 안드로이드 스튜디오

1. 파일 > 빌드 설정 > 프로젝트 익스포트를 사용하여 Unity에서 프로젝트를 익스포트합니다.
2. 익스포트한 프로젝트를 Android Studio에서 엽니다.
3. Android Studio에서 AndroidManifest.xml 파일을 직접 편집합니다.

방법 1: Unity 커스텀 템플릿

1. 파일 > 빌드 설정 > 플레이어 설정 > 퍼블리싱 설정으로 이동합니다.
2. 퍼블리싱 설정 섹션에서 "커스텀 그레이들 템플릿" 을 활성화합니다.
3. Unity는 Assets/Plugins/Android/mainTemplate.gradle에 mainTemplate.gradle 파일을 생성합니다.
4. 이 파일에 커스텀 Gradle 구성을 추가합니다.

출처: Unity Gradle 개요 문서

방법 2: 안드로이드 스튜디오

1. Unity에서 프로젝트를 익스포트합니다.
2. Android Studio에서 프로젝트를 엽니다.
3. 앱의 build.gradle 파일을 직접 편집합니다.

Unity에서 Android 앱을 빌드할 때 동일한 전이 종속성을 포함한 여러 SDK로 인해 "중복 클래스" 오류가 발생할 수 있습니다. 이 오류는 일반적으로 AppLovin SDK와 Singular SDK를 모두 사용할 때 Android 벤딩 라이선싱 라이브러리에서 발생합니다.

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.10.0.aar -> jetified-singular_sdk-12.10.0-runtime (com.singular.sdk:singular_sdk:12.10.0)

해결 방법 1: 외부 종속성 관리자(EDM4U) 사용

프로젝트에서 Unity용 외부 종속성 관리자를 사용하는 경우(권장), 종속성 XML 파일에 제외 규칙을 추가합니다.

1. Unity 프로젝트에서 *Dependencies.xml 파일을 찾습니다(일반적으로 Assets/Editor또는 이와 유사한 위치).
2. 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.10.0" />
  </androidPackages>
</dependencies>

해결 방법 2: 사용자 지정 Gradle 템플릿 사용

EDM4U를 사용하지 않는 경우 Gradle 구성 파일에서 직접 제외 규칙을 적용하세요.

1. 파일 > 빌드 설정 > 플레이어 설정 > 퍼블리싱 설정으로 이동합니다.
2. "커스텀 메인 그래들 템플릿" 또는 "커스텀 런처 그래들 템플릿"을 활성화합니다.
3. Assets/Plugins/Android/mainTemplate.gradle (또는 launcherTemplate.gradle)을 엽니다.
4. 종속성 블록에 제외 규칙을 추가합니다:

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

대안: 종속성 블록 뒤에 이 규칙을 추가하여 전역 제외를 적용합니다:

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

해결 방법 확인

1. 제외를 적용한 후 라이브러리/Bee 및 Temp폴더를 삭제하여 프로젝트를 정리합니다.
2. Unity에서 Android 프로젝트를 다시 빌드합니다.
3. 빌드 출력에 중복 클래스 오류가 더 이상 나타나지 않는지 확인합니다.

프로젝트에서 코드 난독화를 위해 ProGuard를 사용하는 경우 proguard-unity.txt 파일에 다음 유지 규칙을 추가하여 Singular SDK가 제거되는 것을 방지하세요:

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

iOS용 Unity 프로젝트를 빌드한 후 Xcode에서 빌드하기 전에 CocoaPods 종속성을 업데이트하여 최신 SDK 버전이 있는지 확인하세요.

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

연동을 테스트하려면 IDFV(공급업체 식별자)를 로깅하여 Singular SDK 콘솔에서 테스트 기기를 빠르게 추가하세요.

IDFV 로깅 추가하기

1. Unity에서 빌드한 후 Xcode 프로젝트를 엽니다.
2. 클래스 > UnityAppController.mm로 이동합니다.
3. applicationDidBecomeActive 메서드를 찾습니다.
4. 다음 코드를 추가하여 IDFV를 로깅합니다:

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

5. Xcode에서 앱을 빌드하고 실행합니다.
6. Xcode 콘솔 로그에서 IDFV 출력을 확인합니다.
7. IDFV를 복사하여 Singular SDK 콘솔에서 테스트 장치로 추가합니다.

Xcode 프로젝트에서 연관 도메인을 구성하여 딥링크를 위한 유니버설 링크를 활성화합니다.

딥 링크 설정 단계

1. 연관 도메인 추가: Xcode에서 앱 대상의 서명 및 기능탭으로 이동합니다.
2. 기능을 활성화합니다: [+] 기능을 클릭하고 "연결된 도메인"을 추가합니다.
3. 도메인 추가: 형식에 따라 Singular 추적 도메인을 추가합니다: applinks:yourdomain.sng.link
4. 팀 ID 구성: Singular 대시보드에서 앱의 설정으로 이동하여 Apple 팀 ID를 추가합니다. 이렇게 하면 Singular가 유니버설 링크에 필요한 Apple 앱 사이트 연결(AASA) 파일을 생성하고 호스팅할 수 있습니다.

씬에 프리팹 추가

1. 프로젝트 패널에서 패키지 > Singular > SingularSDK > 프리팹으로 이동합니다.
2. SingularSDKObject 프리팹을 계층구조 패널로 드래그합니다.
3. 이제 인스펙터에서 프리팹을 구성할 준비가 되었습니다.

수동 게임 오브젝트 생성

1. 계층 구조 창에서 마우스 오른쪽 버튼을 클릭하고 비어 있음 생성을 선택합니다.
2. 게임 오브젝트의 이름을 SingularSDKObject (정확한 이름 필요)로 지정합니다.
3. 게임 오브젝트를 선택한 상태에서 인스펙터 창으로 이동합니다.
4. 컴포넌트 추가를 클릭합니다.
5. "Singular" 를 검색하고 Singular SDK Script 컴포넌트를 선택합니다.

• 깨어 있을 때 초기화: 기본적으로 활성화되어 있습니다. 게임 오브젝트가 깨어날 때 SDK가 자동으로 초기화됩니다. 개인정보 동의 또는 기타 요구 사항을 위해 초기화를 지연해야 하는 경우 이 옵션을 비활성화합니다.
• SKAN 활성화: 기본적으로 활성화됨(iOS만 해당). 관리 모드에서 SKAdNetwork 어트리뷰션을 활성화하여, Singular가 구성된 전환 모델에 따라 전환 값을 자동으로 업데이트합니다.
• 추적 승인 대기: 0으로 설정합니다(비활성화). 앱에 iOS 앱 트래킹 투명성(ATT) 프롬프트가 표시되는 경우, 300초로 설정합니다. 이렇게 하면 사용자가 ATT 프롬프트에 응답할 때까지 SDK 세션이 지연되어 동의가 부여된 경우 IDFA를 캡처할 수 있습니다. ATT를 사용하지 않는 경우 0으로 둡니다.
• 로깅 사용: 기본적으로 활성화되어 있습니다. 연동 및 문제 해결에 도움이 되는 SDK 디버그 로그를 출력합니다. 프로덕션 빌드에서는 비활성화해야 합니다. 로그 수준 설정과 함께 작동합니다(아래 참조).
• 로그 수준: 기본적으로 3(정보)으로 설정됩니다. 로깅 상세도를 제어합니다. 숫자가 낮을수록 더 자세한 로그를 생성합니다:
  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
  }

  참고: 자세한 로그는 주로 Android에서 사용할 수 있습니다.

• DDL 시간 초과 초: 0으로 설정합니다(기본값은 60초 사용). SDK가 서버에서 디퍼드 딥링크 데이터를 기다리는 시간을 결정합니다. 이 시간 초과 후에도 디퍼드 딥링크를 찾지 못하면 서버는 검색을 중지합니다.
• 세션 타임아웃 초: 0으로 설정합니다(기본값은 60초 사용). SDK가 포그라운드로 돌아올 때 새 세션을 생성하기 전까지 앱을 백그라운드 상태로 유지할 수 있는 시간을 정의합니다.
• 쇼트링크 확인 시간 초과: 0으로 설정합니다(기본값은 10초 사용). 짧은 링크가 해결될 때까지 기다리는 최대 시간입니다. 짧은 링크를 해결할 수 없는 경우 오래 기다리지 않도록 하여 사용자 경험을 보호합니다.

기존 메타 인스톨 리퍼러 어트리뷰션 방법을 지원해야 하는 경우, 페이스북 앱 ID를 SingularSDKObject 구성에 추가하세요.

구성 단계

1. 씬 계층 구조에서 SingularSDKObject를 선택합니다.
2. 인스펙터 창에서 "Facebook 앱 ID"필드를 찾습니다.
3. Facebook 앱 ID를 입력합니다(Facebook 개발자 콘솔에서 찾을 수 있음).

추가 리소스:

• 메타 인스톨 리퍼러란 무엇인가요?
• Facebook 앱 ID를 찾을 수 있는 위치

업그레이드 절차

Unity 패키지 관리자를 통해 SDK를 설치하기 전에 다음 단계를 순서대로 완료하세요: