마이그레이션 가이드(v3 -> v5)

변경 요약

본 문서는 Adison SDK v3 → v5 마이그레이션 과정에서 발생한 주요 API 변경 사항을 정리한 문서입니다.

기존 코드와의 차이점을 중심으로 수정이 필요한 부분과 변경 의도를 함께 안내합니다.

API 변경

지연 로그인 Listener 변경

지연 로그인 처리를 위한 Listener 구조가 변경되었습니다. 기존에는 AdisonOfferwallListener 내부에서 로그인 요청을 처리했으나, v5부터는 로그인 전용 Listener를 분리하여 보다 명확한 책임 분리를 제공합니다.

• 기존 방식

Adison.setOfferwallListener(object : AdisonOfferwallListener() {
    override fun requestLogin(context: Context?) {
        // 사용자 식별자를 setUid로 처리해 주세요.
    }
})

• 변경 방식

// 람다 사용
Adison.setLoginListener { context ->
    context.startActivity(Intent(context, LoginActivity::class.java))
}
// object 선언 사용
Adison.setLoginListener(object : AdisonLoginListener {
    override fun requestLogin(context: Context) {
        context.startActivity(Intent(context, LoginActivity::class.java))
    }
})

적립 가능 금액 표시 방법 변경

• 기존 방식

Adison.availableReward { name, unit, points ->
    print("적립 가능한 리워드 이름: $name, 단위: $unit, 포인트: $points")
}

• 변경 방식

Adison.availableRewards { rewards ->
    Log.i("Sample", "Rewards : $rewards")
}

---

클래스 명 변경 사항

Config 관련 Class 명 변경

가독성과 네이밍 일관성 강화를 위해 Config 관련 클래스 명이 변경되었습니다.

기존	변경
ListType	AdisonListType
ButtonType	AdisonButtonType

성별 / 연령 타게팅 Class 명 변경

기존	변경
Gender	AOGender

---

테마 및 색상 변경 사항

기존에는 colorAdisonPrimary 색상이 너무 밝은 경우,

가독성을 위해 목록 아이템의 텍스트 색상 및 배경 색상을 강제로 변경하는 자동 보정 로직이 적용되었습니다.

v5부터는 변경된 UI 구조로 인해 기존에 제공되던 색상 자동 보정 기능이 삭제되었으며, 목록 아이템의 텍스트 및 배경 색상은 명시적으로 설정된 값만 사용합니다.

(변경 된 테마 및 색상)

삭제된 색상 리소스

아래 색상 리소스는 더 이상 사용되지 않으며, 선언하더라도 목록 UI에 반영되지 않습니다.

4	colorAdisonOfwListItemTextColor	목록 아이템 전체 텍스트 색상
4-1	colorAdisonListItemTitleText	목록 아이템 타이틀 텍스트 색상 (피드형 Only)
4-2	colorAdisonListItemSubtitleText	목록 아이템 서브타이틀 텍스트 색상 (피드형 Only)
4-3	colorAdisonListItemRewardText	목록 아이템 리워드 텍스트 색상 (피드형 Only)
5	colorAdisonOfwListItemBackgroundColor	목록 아이템 배경 색상