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

방법 1: Unity 사용자 지정 매니페스트

1. 다음 경로로 이동하세요. 파일 > 빌드 설정 > 플레이어 설정 > 게시 설정.
2. 'Publishing Settings' 섹션에서 "Custom Main Manifest"를 활성화합니다.
3. Unity는 Assets/Plugins/Android/AndroidManifest.xml에 기본 AndroidManifest.xml 파일을 생성합니다.
4. 이 파일을 편집하여 필요한 권한과 구성을 추가하십시오.

출처: Unity Android 매니페스트 문서

방법 2: Android Studio

1. Unity에서 파일 > 빌드 설정 > 프로젝트 내보내기를 사용하여 프로젝트를 내보냅니다.
2. Android Studio에서 내보낸 프로젝트를 엽니다.
3. Android Studio에서 AndroidManifest.xml 파일을 직접 편집하십시오.

방법 1: Unity 사용자 지정 템플릿

1. 다음 경로로 이동합니다. 파일 > 빌드 설정 > 플레이어 설정 > 게시 설정.
2. " Publishing Settings " 섹션에서 "Custom Gradle Template"을 활성화합니다.
3. Unity는 Assets/Plugins/Android/mainTemplate.gradle 경로에 mainTemplate.gradle 파일을 생성합니다.
4. 이 파일에 사용자 지정 Gradle 구성을 추가합니다.

출처: Unity Gradle 개요 문서

방법 2: Android Studio

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

Unity에서 Android 앱을 빌드할 때, 동일한 전달 의존성을 포함하는 여러 SDK로 인해 "중복 클래스" 오류가 발생할 수 있습니다. 이는 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: 외부 종속성 관리자(EDM4U) 사용

프로젝트에서 Unity용 External Dependency Manager (권장) 를 사용하는 경우, 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. 다음 경로로 이동합니다: 파일 > 빌드 설정 > 플레이어 설정 > 게시 설정.
2. "사용자 지정 메인 Gradle 템플릿" 또는 "사용자 지정 런처 Gradle 템플릿"을 활성화합니다.
3. Assets/Plugins/Android/mainTemplate.gradle (또는 launcherTemplate.gradle) 파일을 엽니다.
4. dependencies 블록에 다음 제외 규칙을 추가하세요:

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'
}

대안: 다음 코드를 dependencies 블록 뒤에 추가하여 전역 제외 규칙을 적용하세요:

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

해결 확인

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

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

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

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

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 프로젝트에서 연관 도메인을 구성하여 딥 링크용 유니버설 링크를 활성화하세요.

딥 링크 설정 단계

1. 연관 도메인 추가: Xcode에서 앱 타깃의 '서명 및 기능(Signing & Capabilities)' 탭으로 이동합니다.
2. 기능 활성화: [+] Capability를 클릭하고 "Associated Domains"를 추가합니다.
3. 도메인 추가: Singular 추적 도메인을 applinks:yourdomain.sng.link 형식으로 추가합니다.
4. 팀 ID 구성: Singular 대시보드에서 앱 설정으로 이동하여 Apple 팀 ID를 추가합니다. 이를 통해 Singular는 유니버설 링크에 필요한 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. 프로젝트 패널에서 Packages > Singular > SingularSDK > Prefabs로 이동합니다.
2. SingularSDKObject 프리팹을 Hierarchy 패널로 드래그합니다.
3. 이제 인스펙터에서 프리팹을 설정할 준비가 되었습니다.

GameObject 수동 생성

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

• Awake 시 초기화: 기본적으로 활성화되어 있습니다. GameObject가 깨어날 때 SDK가 자동으로 초기화됩니다. 개인정보 동의 또는 기타 요구 사항으로 인해 초기화를 지연해야 하는 경우 이 옵션을 비활성화하십시오.
• SKAN 활성화: 기본적으로 활성화되어 있습니다(iOS 전용). Managed Mode에서 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초). 숏링크 해결을 기다리는 최대 시간입니다. 숏링크를 해결할 수 없는 경우 긴 대기 시간을 방지하여 사용자 경험을 보호합니다.

기존 Meta 설치 리퍼러 어트리뷰션 방식을 지원해야 하는 경우, SingularSDKObject 구성에 Facebook 앱 ID를 추가하십시오.

구성 단계

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

추가 자료:

• Meta 설치 리퍼러란 무엇인가요?
• Facebook 앱 ID를 찾는 방법

업그레이드 절차

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