Integrate

0. 최신 ADX iOS SDK 버전

Version 2.8.1

Release Date : 2025/09/22

1. 최소 지원 사양

• iOS 13.0 이상

• Xcode 16.0 이상

• CocoaPods

2025년 4월 24일부터 앱 스토어 커넥트에 업로드하는 앱은 Xcode 16 이상 버전을 사용하여 빌드해야 합니다. https://developer.apple.com/kr/news/

ADX iOS SDK 2.7.1 버전부터, iOS 앱 프로젝트의 info.plist 파일에 "AppLovinSdkKey" 키가 포함되어 있으면 앱 실행 후 아래의 에러 메시지가 Xcode 콘솔에 출력되고 비정상 종료가 발생하므로 제거해야 합니다. [AppLovinSdk] ERROR [ALSdk] Invalid initialization process: please remove the AppLovinSdkKey entry from your Info.plist and set your SDK key with the ALSdkInitializationConfiguration object. Then initialize the SDK as soon as possible with -[ALSdk initializeWithConfiguration:completionHandler:] before accessing any SDK fields or APIs.

2. ADX iOS SDK 추가

ADX iOS SDK 업데이트에 따라 아래 내용이 변경될 수 있습니다.

1) 프로젝트의 Podfile을 열고 아래 내용을 추가합니다.

# 라이브러리 다운로드 소스 추가
source 'https://github.com/adxcorp/AdxLibrary_iOS_Release.git'
source 'https://github.com/CocoaPods/Specs.git'

# 배포 타겟 버전 (Deployment Target Version)
platform :ios, '13.0'

# ADX 라이브러리 추가 (배너,네이티브,전면,보상)
pod 'ADXLibrary', '2.8.1'

# ADX Lite version
pod 'ADXLibrary/Lite', '2.8.1'

# Xcode 15.0 이상 버전에서, TOOL CHAIN 관련 빌드 에러가 발생한다면 아래 코드를 추가하십시오.
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
    xcconfig_path = config.base_configuration_reference.real_path
    xcconfig = File.read(xcconfig_path)
    xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
    File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
    end
  end
end

Xcode 15.0 이상 버전에서 빌드 시, 일부 광고 네트워크 SDK에서 아래와 같은 에러가 발생할 수 있습니다. 이 경우 위의 Podfile 내용을 참조하여 수정합니다.

---

DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS, use TOOLCHAIN_DIR instead

2) 아래 명령어를 사용하여 라이브러리를 설치하고, 파일 확장자가 .xcworkspace 파일을 찾아 열기합니다.

pod install --repo-update

3. Project Setting

1) 프로젝트의 Bulid Settings에서 Enable Bitcode를 No로 변경합니다.

2) XCode > Build Settings > Ohter Linker Flags 에서 "-all-load" 또는 "-force_load" 플래그를 사용하여 빌드 할 경우, 심볼 중복 (Symbol Duplicate)가 발생할 수 있습니다. 이 경우 "-ObjC" 플래그로 변경하십시오.

3) 빌드 타겟 선택 후 > Build Settings > Framework Search Paths 에서 "$(inherited)" 값이 추가 되어 있는지 확인하고 추가되어 있지 않다면 관련 라이브러리를 찾을 수 없다는 빌드 에러가 발생할 수 있으므로 반드시 추가해주십시오.

4. iOS 14+ 지원

iOS 14+ 이상 지원하는 경우 ATT(App Tracking Transparency) Framework를 적용해야 IDFA (Identifier for Advertisers) 식별자를 얻을 수 있습니다. 자세한 방법은 아래 링크를 참고해주십시오.

App Tracking Transparency

5. AdMob APP ID 설정

• Info.plist 파일에 GADApplicationIdentifier 키와 발급된 AdMob APP ID를 추가합니다.

  GADApplicationIdentifier를 추가하지 않으면 다음 메시지가 Xcode 콘솔에 표시되며 앱이 비정상 종료됩니다. The Google Mobile Ads SDK was initialized incorrectly.

  ---

  <key>GADApplicationIdentifier</key> <string>ADMOB_APP_ID</string>