adwhale_sdk_flutter
ADwhale Android 네이티브 광고 미디에이션 SDK를 Flutter 환경에서 사용할 수 있도록 제공하는 공식 SDK입니다.
- Android 네이티브 SDK 기반
- 배너, 전면, 보상형, 네이티브 광고 지원
Installation
flutter pub add adwhale_sdk_flutter
Version Policy
본 SDK는 Android 네이티브 SDK 버전과의 대응 관계를 명확히 유지하기 위해 다음과 같은 버전 규칙을 사용합니다.
- 앞 세 자릿수(Major.Minor.Patch) 는 Android SDK 버전과 동일
- Flutter 전용 수정 사항은 Patch 값을 확장하여 관리
Version Mapping Example
| Android SDK | Flutter SDK | Description |
|---|---|---|
| 2.7.1 | 2.7.1+0 | Android 2.7.1 기반 Flutter SDK 최초 릴리스 |
| 2.7.1 | 2.7.1+1 | Flutter 레이어 핫픽스 |
| 2.7.1 | 2.7.1+2 | Flutter 버그 수정 |
| 2.7.2 | 2.7.2+0 | Android SDK 2.7.2 반영 |
Version Usage Guide
프로젝트 상황에 따라 아래 방식을 권장합니다.
Android SDK 버전에 고정하여 사용하는 경우 (권장)
운영 안정성을 중시하는 경우
{
adwhale_sdk_flutter: ~2.7.2+6
}
- Android SDK 2.7.2 기반 유지
- Flutter 핫픽스만 자동 반영
-
=2.7.2+6 <2.8.0 범위
특정 버전을 완전히 고정하여 사용하는 경우
{
adwhale_sdk_flutter: 2.7.2+6
}
- 버전 변경 없음
- 재현성, 장애 분석에 최적
- QA / 장애 재현 환경
- 장기 유지 브랜치
Example Project
SDK 동작을 바로 확인할 수 있는 example 프로젝트를 제공합니다.
flutter pub add adwhale_sdk_flutter
Supported Features
- SDK 초기화
- 배너 광고
- 전면 광고
- 보상형 광고
- 네이티브 광고 (Template / Custom)
- 광고 이벤트 리스너 제공
Troubleshooting
Android 빌드 오류 발생 시:
cd android
./gradlew clean
환경 점검:
flutter doctor
Changelog
| 배포버전 | 내용 | 배포날짜 |
|---|---|---|
| 2.7.2+6 | 버그 수정 | 2026.01.26 |
| 2.7.2+2 | 네이밍 정리 | 2026.01.19 |
| 2.7.2+1 | 네이밍 정리, 지역타겟팅 적용, setPlacementName추가, 샘플UI 변경 | 2026.01.12 |
| 2.7.2+0 | GDPR, COPPA, 적응형 배너, 앱 오프닝 추가. | 2026.01.09 |
| 2.7.1+1 | dart 인터페이스 수정. | 2025.12.23 |
| 2.7.1+0 | Initial release for ADwhale Mediation SDK 2.7.1. | 2025.12.15 |