83c43fb61f
## 전면 광고 (AdService) - AdService 클래스 신규 생성 (lunchpick 패턴 참조) - Completer 패턴으로 광고 완료 대기 구현 - 로딩 오버레이로 앱 foreground 상태 유지 - 몰입형 모드 (immersiveSticky) 적용 - iOS 테스트 광고 ID 설정 ## SMS 스캔 버그 수정 - Isolate 내 Flutter 바인딩 접근 오류 해결 - _isoExtractServiceNameFromSender()에서 하드코딩 사용 - 로딩 위젯 화면 정중앙 배치 수정 ## 문서 및 설정 - CLAUDE.md 최적화 (글로벌 규칙 중복 제거) - Claude Code Skills 5개 추가 - flutter-build: 빌드/분석 - hive-model: Hive 모델 관리 - release-deploy: 릴리즈 배포 - sms-scanner: SMS 스캔 디버깅 - admob: 광고 구현 ## 버전 - 1.0.1+2 → 1.0.1+3
90 lines
1.8 KiB
Markdown
90 lines
1.8 KiB
Markdown
---
|
|
name: admob
|
|
description: AdMob 전면 광고 구현 및 디버깅. 광고 표시, 로드 실패, foreground 이슈 시 사용.
|
|
allowed-tools: Read, Edit, Grep
|
|
---
|
|
|
|
# AdMob Integration
|
|
|
|
## 핵심 파일
|
|
|
|
| 파일 | 역할 |
|
|
|------|------|
|
|
| `lib/services/ad_service.dart` | 전면 광고 서비스 |
|
|
|
|
## 광고 ID
|
|
|
|
| 플랫폼 | ID | 비고 |
|
|
|--------|-----|------|
|
|
| Android | `ca-app-pub-6691216385521068/5281562472` | 프로덕션 |
|
|
| iOS | `ca-app-pub-3940256099942544/1033173712` | 테스트 |
|
|
|
|
## Completer 패턴 (필수)
|
|
|
|
광고 완료를 기다리려면 Completer 사용:
|
|
|
|
```dart
|
|
Future<bool> showInterstitialAd(BuildContext context) async {
|
|
final completer = Completer<bool>();
|
|
|
|
ad.fullScreenContentCallback = FullScreenContentCallback(
|
|
onAdDismissedFullScreenContent: (ad) {
|
|
ad.dispose();
|
|
completer.complete(true);
|
|
},
|
|
onAdFailedToShowFullScreenContent: (ad, error) {
|
|
ad.dispose();
|
|
completer.complete(false);
|
|
},
|
|
);
|
|
|
|
ad.show();
|
|
return completer.future;
|
|
}
|
|
```
|
|
|
|
## "App not in foreground" 해결
|
|
|
|
광고 로드 중 앱이 백그라운드로 가면 오류 발생.
|
|
|
|
**해결책: 로딩 오버레이**
|
|
|
|
```dart
|
|
// 광고 로드 전 다이얼로그 표시 → 앱이 foreground 유지
|
|
final closeLoading = _showLoadingOverlay(context);
|
|
await _enterImmersiveMode();
|
|
final loaded = await _ensureAdLoaded();
|
|
closeLoading();
|
|
```
|
|
|
|
## 몰입형 모드
|
|
|
|
```dart
|
|
await SystemChrome.setEnabledSystemUIMode(
|
|
SystemUiMode.immersiveSticky,
|
|
overlays: [],
|
|
);
|
|
```
|
|
|
|
## 흐름도
|
|
|
|
```
|
|
startScan()
|
|
↓
|
|
showLoadingOverlay() ← 앱 foreground 유지
|
|
↓
|
|
enterImmersiveMode()
|
|
↓
|
|
loadAd()
|
|
↓
|
|
closeOverlay()
|
|
↓
|
|
ad.show()
|
|
↓
|
|
await Completer.future ← 광고 완료 대기
|
|
↓
|
|
restoreSystemUI()
|
|
↓
|
|
continueWithScan()
|
|
```
|