iOS 앱에 Adrop SDK 설치하기

• Adrop iOS SDK

GitHub - OpenRhapsody/adrop-ads-podGitHub

• Adrop iOS SDK - Example

OpenRhapsody/adrop-ads-example-iosGitHub

사전 준비사항

다음을 설치해주세요.

• Xcode 14.1 혹은 그 이상의 버전

Adrop은 최소한 다음의 환경에서 동작합니다.

• iOS 13 혹은 그 이상의 버전

• Swift 5.0 혹은 그 이상의 버전

이메일 또는 구글 계정을 통해 Adrop에 로그인하세요.

1. Adrop 설정 파일 추가하기

설정 파일 준비하기 가이드를 참고해 주세요.

2. 앱에 Adrop SDK 추가하기

GitHub - OpenRhapsody/adrop-ads-podGitHub

2-1. CocoaPods

CocoaPods을 활용해 Adrop dependency를 설치하고 관리하세요. 아래는 CocoaPods을 활용해 Adrop을 설치하는 방법입니다.

1. 기존의 Podfile이 없다면, 신규 Podfile을 만들어주세요. 프로젝트 디렉토리의 루트에서 아래 코드를 실행해주세요.

pod init

1. Podfile에 대해 Adrop pod을 앱에 추가해주세요.

pod 'adrop-ads'

1. Pod을 설치하고 .xcworkspace 파일을 열어 Xcode의 프로젝트를 확인하세요.

pod install --repo-update

open your-project.xcworkspace

2-2. SPM

1. Xcode 에서 프로젝트를 엽니다.

2. 프로젝트 네비게이터에서 프로젝트 파일을 선택합니다.

3. 타겟을 선택합니다.

4. “General” 탭 내 “Frameworks, Libraries, and Embeded Content” 에서 “+” 버튼을 클릭하여 새 패키지를 추가합니다.'

5. “Add Package Dependency” 를 선택합니다.

6. 패키지의 GitHub URL(https://github.com/OpenRhapsody/adrop-ads-pod)을 입력하고 “Add Package” 버튼을 클릭합니다.

3. Adrop 초기화(initialize)하기

마지막으로, 초기화 코드를 앱에 추가해주세요. 아래 깃헙에서 예제 코드를 확인하실 수 있습니다.

OpenRhapsody/adrop-ads-example-iosGitHub

1. Adrop모듈을 UIApplicationDelegate에 Import해주세요.

import AdropAds
// ...:

@import AdropAds;
// ...

1. App delegate의 application(_:didFinishLaunchingWithOptions:) 메소드에서 Adrop 공유된 인스턴스를 초기화합니다.

2. 앱의 사용 언어에 맞게 Adrop instance를 초기화해주세요.

// production 배포 시, 'true'를 사용하세요.
// 특정 국가에서 이 SDK를 사용하고 있다면, 
// ISO 3166 alpha-2 국가 코드 array를 전달하세요.
// 타겟 링크가 열리는 브라우저 설정이 필요하다면, useInAppBrowser 값을 바꿔주세요.
Adrop.initialize(production: false, targetCountries: [], useInAppBrowser: false)

// production 배포 시, 'YES'를 사용하세요.
// 특정 국가에서 이 SDK를 사용하고 있다면, 
// ISO 3166 alpha-2 국가 코드 array를 전달하세요.
[Adrop initializeWithProduction:NO targetCountries:@[]];

1. Swift UI를 사용하는 경우, application delegate를 생성하고 이를 UIApplicationDelegateAdaptor 또는 NSApplicationDelegateAdaptor를 통해 앱 구조체(struct)에 연결할 수 있습니다.

@main
struct YourApp: App {
  // Adrop 설정을 위해 app delegate을 등록하세요.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Next Steps

1. 광고 유닛 등록하기

이제 광고 유닛을 등록하면 사용자에게 광고주의 직광고를 노출할 수 있어요.

광고 유닛 등록 방법을 알려드릴게요.

2. 광고 유닛 노출하기

이미 등록된 광고 유닛이 있다면 광고를 노출해 보세요.

(선택사항) Troubleshooting

# Add this line to your Podfile
use_frameworks!

# ...
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|

        #...
        # Add this line to your Podfile
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        end
    end
end