Integrate

0. 최신 ADX iOS SDK 버전

Version 2.7.0

Release Date : 2024/12/03

1. 최소 지원 사양

  • iOS 12.0 이상

  • Xcode 15.3 이상

    • ADX iOS SDK 2.5.5 이상 사용 시, Xcode 15.3 이상에서 빌드 필요.

  • CocoaPods

Xcode15 이상에서 빌드할 경우, iOS Deployment Target 버전 (최소 지원 버전)을 12.0 이상으로 설정합니다. iOS 12.0 이상 버전으로 설정하지 않으면 특정 광고 네트워크의 초기화 과정에서 비정상 종료(Crash)가 발생할 수 있습니다.

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'      

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

# 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) 식별자를 얻을 수 있습니다. 자세한 방법은 아래 링크를 참고해주십시오.

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>

PreviousChange logNextSDK Integration

Last updated