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

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

1. File > Build Settings > Player Settings > Publishing Settings 로 이동합니다.
2. Publishing Settings 섹션에서 "Custom Main Manifest" 를 활성화합니다.
3. Unity가 Assets/Plugins/Android/AndroidManifest.xml 위치에 기본 AndroidManifest.xml 파일을 생성합니다.
4. 이 파일을 편집하여 필요한 권한과 구성을 추가합니다.

출처: Unity Android Manifest 문서

방법 2: Android Studio

1. File > Build Settings > Export Project 을 사용하여 Unity에서 프로젝트를 내보냅니다.
2. 내보낸 프로젝트를 Android Studio에서 엽니다.
3. Android Studio에서 AndroidManifest.xml 파일을 직접 편집합니다.

방법 1: Unity 커스텀 템플릿

1. File > Build Settings > Player Settings > Publishing Settings 로 이동합니다.
2. Publishing Settings 섹션에서 "Custom Gradle Template" 을 활성화합니다.
3. Unity가 Assets/Plugins/Android/mainTemplate.gradle 위치에 mainTemplate.gradle 파일을 생성합니다.
4. 이 파일에 커스텀 Gradle 구성을 추가합니다.

출처: Unity Gradle Overview 문서

방법 2: Android Studio

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

Unity에서 Android 앱을 빌드할 때, 여러 SDK가 동일한 전이 종속성을 포함하여 발생하는 "Duplicate class"(중복 클래스) 오류가 나타날 수 있습니다. 이는 AppLovin SDK와 Singular SDK를 함께 사용할 때 Android Vending Licensing 라이브러리에서 흔히 발생합니다.

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)

해결책 1: External Dependency Manager(EDM4U) 사용

프로젝트가 External Dependency Manager for Unity (권장)를 사용하는 경우, Dependencies 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.11.0" />
  </androidPackages>
</dependencies>

해결책 2: 커스텀 Gradle 템플릿 사용

EDM4U를 사용하지 않는 경우, Gradle 구성 파일에 직접 제외 규칙을 적용합니다.

1. File > Build Settings > Player Settings > Publishing Settings 로 이동합니다.
2. "Custom Main Gradle Template" 또는 "Custom Launcher Gradle Template" 을 활성화합니다.
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.11.0'
}

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

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

해결 확인

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

프로젝트가 코드 난독화를 위해 ProGuard를 사용하는 경우, Singular SDK가 제거되지 않도록 다음 keep 규칙을 proguard-unity.txt 파일에 추가합니다:

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

iOS용 Unity 프로젝트를 빌드한 후 Xcode에서 빌드하기 전에, 최신 SDK 버전을 사용하도록 CocoaPods 종속성을 업데이트하세요.

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

연동을 테스트할 때, IDFV(Identifier for Vendor)를 로깅하여 Singular SDK 콘솔에서 테스트 기기를 빠르게 추가하세요.

IDFV 로깅 추가

1. Unity에서 빌드한 후 Xcode 프로젝트를 엽니다.
2. Classes > 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 프로젝트에서 Associated Domains를 구성하여 딥링킹을 위한 Universal Links를 활성화하세요.

딥링크 설정 단계

1. Associated Domain 추가: Xcode에서 앱 타겟의 Signing & Capabilities 탭으로 이동합니다.
2. 기능 활성화: [+] Capability 를 클릭하고 "Associated Domains" 를 추가합니다.
3. 도메인 추가: 다음 형식으로 Singular 추적 도메인을 추가합니다: applinks:yourdomain.sng.link
4. Team ID 구성: Singular 대시보드에서 앱 설정으로 이동하여 Apple Team ID를 추가합니다. 이를 통해 Singular는 Universal Links에 필요한 Apple App Site Association(AASA) 파일을 생성하고 호스팅할 수 있습니다.

UnityAppController를 등록하는 다른 SDK(예: Firebase, Adjust, AppsFlyer)를 사용하는 경우, Singular가 제대로 초기화되지 않도록 하는 충돌이 발생할 수 있습니다. Unity에서는 한 번에 하나의 클래스만 UnityAppController로 등록할 수 있습니다.

이 충돌을 해결하려면:

1. 열기 Xcode 프로젝트에서 SingularSwizzledAppController.m 파일을 엽니다.
2. 이 파일의 모든 코드의 주석 처리를 해제합니다.
3. 열기 SingularAppDelegate.m 을 열고 다음 줄이 주석 처리되지 않았는지 확인합니다:

   IMPL_APP_CONTROLLER_SUBCLASS(SingularAppDelegate)

이를 통해 Singular는 UnityAppController를 서브클래싱하는 대신 메서드 스위즐링을 사용하여 다른 SDK와 함께 작동할 수 있습니다.

씬에 프리팹 추가

1. Project 창에서 Packages > Singular > SingularSDK > Prefabs 로 이동합니다.
2. SingularSDKObject 프리팹을 Hierarchy 창으로 드래그합니다.
3. 이제 프리팹을 Inspector에서 구성할 준비가 되었습니다.

수동 GameObject 생성

1. Hierarchy 창에서 마우스 오른쪽 버튼을 클릭하고 Create Empty 를 선택합니다.
2. GameObject의 이름을 SingularSDKObject 로 지정합니다(정확한 이름 필수).
3. GameObject가 선택된 상태에서 Inspector 창으로 이동합니다.
4. Add Component 를 클릭합니다.
5. "Singular" 를 검색하고 Singular SDK Script 컴포넌트를 선택합니다.

• Initialize On Awake: 기본적으로 활성화되어 있습니다. GameObject가 awake될 때 SDK가 자동으로 초기화됩니다. 개인정보 동의나 기타 요구사항을 위해 초기화를 지연해야 하는 경우 이를 비활성화하세요.
• SKAN Enabled: 기본적으로 활성화되어 있습니다(iOS 전용). Singular가 구성한 컨버전 모델을 기반으로 컨버전 값을 자동으로 업데이트하는 Managed Mode에서 SKAdNetwork 어트리뷰션을 활성화합니다.
• Wait For Tracking Authorization: 0(비활성화)으로 설정됩니다. 앱에서 iOS App Tracking Transparency(ATT) 프롬프트를 표시하는 경우, 이를 300초로 설정하세요. 이는 사용자가 ATT 프롬프트에 응답할 때까지 SDK 세션을 지연시켜 동의가 부여되면 IDFA를 캡처할 수 있도록 합니다. ATT를 사용하지 않는 경우 0으로 둡니다.
• Enable Logging: 기본적으로 활성화되어 있습니다. 연동 및 문제 해결에 도움이 되도록 SDK 디버그 로그를 출력합니다. 프로덕션 빌드에서는 비활성화해야 합니다. Log Level 설정과 함께 작동합니다(아래 참조).
• Log Level: 기본적으로 3(Info)으로 설정됩니다. 로깅 상세도를 제어합니다. 숫자가 낮을수록 더 상세한 로그가 생성됩니다:
  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 Timeout Sec: 0(60초 기본값 사용)으로 설정됩니다. SDK가 서버로부터 디퍼드 딥링크 데이터를 기다리는 시간을 결정합니다. 디퍼드 딥링크를 찾지 못하면 이 타임아웃 후 서버가 검색을 중단합니다.
• Session Timeout Sec: 0(60초 기본값 사용)으로 설정됩니다. SDK가 포그라운드로 돌아올 때 새 세션을 생성하기 전에 앱이 백그라운드에 머물 수 있는 시간을 정의합니다.
• Shortlink Resolve Timeout: 0(10초 기본값 사용)으로 설정됩니다. 숏링크 확인을 기다리는 최대 시간입니다. 숏링크를 확인할 수 없는 경우 긴 대기를 방지하여 사용자 경험을 보호합니다.

기존 Meta Install Referrer 어트리뷰션 방법을 지원해야 하는 경우, Facebook App ID를 SingularSDKObject 구성에 추가하세요.

구성 단계

1. 씬 계층 구조에서 SingularSDKObject 를 선택합니다.
2. Inspector 창에서 "Facebook App ID" 필드를 찾습니다.
3. Facebook App ID를 입력합니다(Facebook Developer Console에서 확인 가능).

추가 리소스:

• Meta Install Referrer란?
• Facebook App ID를 찾는 위치

업그레이드 절차

Unity Package Manager를 통해 SDK를 설치하기 전에 다음 단계를 순서대로 완료하세요: