Integrate
Last updated
Was this helpful?
Last updated
Was this helpful?
Version 2.7.2
Release Date : 2025/04/07
2025년 4월 24일부터 앱 스토어 커넥트에 업로드하는 앱은 Xcode 16 이상 버전을 사용하여 빌드해야 합니다.
Xcode15 이상에서 빌드할 경우, iOS Deployment Target 버전 (최소 지원 버전)을 12.0 이상으로 설정합니다. iOS 12.0 이상 버전으로 설정하지 않으면 특정 광고 네트워크의 초기화 과정에서 비정상 종료(Crash)가 발생할 수 있습니다.
1) ADX Unity SDK를 다운로드 합니다.
2) Assets > Import Package > Custom Package를 선택하여 다운로드한 ADXUnityPackage.unitypackage 파일을 찾아 추가하거나 ADXUnityPackage.unitypackage를 더블클릭하여 실행합니다.
3) 모든 파일을 선택하고 import 합니다.
Assets/Plugins/Android 디렉토리에 mainTemplate.gradle 파일을 열어 android 섹션에서 compileOptions을 추가합니다.
Play Services Resolver 관련하여 아래 내용을 실행합니다.
Assets > External Dependency Manager > Android Resolver > Settings를 선택하고 Use Jetifier 체크 후 Force Resolver를 실행합니다.
Assets > External Dependency Manager > iOS Resolver > Settings > Add use_frameworks! to Podfile에 체크가 되어 있는지 확인합니다.
Assets > External Dependency Manager > iOS Resolver > Settings > Link frameworks statically에 체크가 되어 있는지 확인합니다. (Unity 엔진 2019.4 이상 사용 시)
유니티 에디터에서 빌드 후, *.xcworkspace (Unity-iPhone.xcworkspace) 확장자 파일을 Xcode에서 열기 합니다.
프로젝트의 Bulid Settings에서 Enable Bitcode를 No로 변경합니다.
Unity 2019.3 버전 이상의 경우 Unity-iPhone 과 UnityFramework 모두 Enable Bitcode를 No로 변경합니다.
XCode > 빌드 타겟 (UnityFramework) 선택 > Build Settings > Ohter Linker Flags 에서 "-all-load" 또는 "-force_load" 플래그를 사용하여 빌드 할 경우, 심볼 중복 (Symbol Duplicate)가 발생할 수 있습니다. 이 경우 "-ObjC" 플래그로 변경하십시오.
아래 빌드 타겟에 "$(inherited)" 추가 되어 있는지 확인하고 추가되어 있지 않다면 관련 라이브러리를 찾을 수 없다는 빌드 에러가 발생할 수 있으므로 추가해주십시오. - Xcode > 빌드 타겟 (Unity-iPhone) 선택 > Build Settings > Other Linker Flag - Xcode > 빌드 타겟 (UnityFramework) 선택 > Build Settings > Framework Search Paths
"Cannot use '@try' with Objective-C exceptions disabled" 와 같은 빌드 에러가 발생할 경우, 아래 설정 값을 'No'에서 'Yes'로 변경하여 주십시오. - Xcode > 빌드 타겟 (Unity-Framework) 선택 > Enable Objective-C Exceptions
AppStoreConnect에 업로드 (Xcode > Product > Archive) 시, "Always Embed Swift Standard Libraries" 설정값을 아래 그림과 같이 각 빌드 타겟에 맞게 설정하여 주십시오. 이 설정값에 따라서 AppStoreConnect에 업로드 실패가 발생할 수 있습니다.
ADXUnityPackage 2.4.0 이상 사용하시는 경우 Gradle 버전이 6.7.1 이상 연동해야 안정적으로 안드로이드 빌드가 진행됩니다.
Gradle 권장 버전 이하 사용시 애드몹 유니티 플러그인에 의해 This feature requires ASM7 오류가 발생되며 아래의 방법 중 하나로 해결 가능합니다.
Gradle과 Gradle Plugin 변경을 통한 해결 (권장)
유니티 엔진 업데이트를 통해 해결
android.enableDexingArtifactTransform=false를 주석처리 방법으로 해결
Gradle과 Gradle Plugin 변경 (Gradle : 6.7.1+, Gradle Plugin 4.2.0+)
Custom Base Gradle Template 사용을 안하고 계실 경우 사용하도록 변경합니다.
Build Settings -> Project Settings -> Player -> Custom Base Gradle Template 체크를 합니다.
이때 Assets/Plugins/Android/baseProjectTemplate.gradle 이 없을 경우 생성됩니다.
Gradle Plugin 버전을 변경합니다.
Assets/Plugins/Android/baseProjectTemplate.gradle 파일을 열어서 버전을 변경합니다.
'com.android.tools.build:gradle:4.2.0'
Gradle 다운로드합니다.
6.7.1로 받으신다면 아래의 링크를 통해 받으시면 됩니다.
특정 경로에 복사 및 압축 해제를 합니다.
예) ~/Users/sunny/gradle-6.7.1
Gradle 설치 경로를 변경합니다.
Preferences -> External Tools -> Gradle Installed with Unity 체크 해제합니다.
Gradle 다운로드한 경로로 설정합니다.
예) ~/Users/sunny/gradle-6.7.1
Android Resolver를 진행합니다.
Assets -> External Dependency Manager -> Android Resolver -> Delete Resolved Libraries
Assets -> External Dependency Manager -> Android Resolver -> Force Resolve
마지막으로 Target API Level이 33이상 되었는지 확인 후 빌드를 진행합니다.
GoogleMobileAdsSettings에 입력한 App ID가 삭제되는 경우 Unity > Assets > Google Mobile Ads > Settings에서 Delay app measure를 체크 했다가 해제하여 주시기 바랍니다.
전체 :
리워드 비디오 전용 :
4) 가 이미 포함되어 있으시면 ADXUnityPackage에서 ExternalDependencyManager를 제외하신 후 import 해주시면 됩니다.
iOS 14 이상 지원하는 경우 IDFA (Identifier for Advertisers) 식별자를 얻기 위해 를 반드시 적용해야 합니다. 자세한 방법은 아래 링크를 참고해주세요.
에서 다운로드 가능합니다.
