chore: Task 1 완료 - 아키텍처/TODO 문서화 및 미사용 데드 파일·주석 정리
- ARCHITECTURE.md: 전체 Gradle 모듈(:app, :gdrive, :lun_launcher, :library, :utils) 및 핵심 컴포넌트(Activity, Fragment, Service, C++ 네이티브 엔진, Realm DB 계층) 구조 정리 - TODO.md: 메모리 누수(Unit 1), 동시성/코루틴 생명주기(Unit 2), 예외 처리/자원 관리(Unit 3), 보일러플레이트(Unit 4), 미사용 코드/의존성(Unit 5), 중·소단위 모듈화(Unit 6) 계획 작성 및 5-1 완료 처리 - app/src/main/kotlin/bums/lunatic/launcher/home/LauncherHome_old.kt 삭제: 전체 주석 처리된 구버전 홈 코드(1,321줄) 제거 및 참조 없음 검증 - app/src/main/kotlin/bums/lunatic/launcher/utils/MainActivity.kt 삭제: 전체 주석 처리된 com.example.ch16_provider 샘플 코드(78줄) 제거 및 참조 없음 검증 - app/src/main/AndroidManifest.xml: 주석 처리되어 있던 미사용 .feeds.rss.RssService 선언 제거 - 검증: ./gradlew :app:compileDebugKotlin 빌드 성공 확인
This commit is contained in:
+101
@@ -0,0 +1,101 @@
|
||||
# LunarLauncher 아키텍처 개요
|
||||
|
||||
`LunarLauncher`는 Android 홈 런처를 중심으로 RSS/커뮤니티 피드, 웹 리더(GeckoView/WebView), 토렌트 및 미디어 다운로드, 네이티브 FFmpeg 기반 미디어/문서/이미지 뷰어, 라이브 월페이퍼, Google Drive 백업, Wear OS 제스처 연동을 통합한 멀티 모듈 Android 프로젝트입니다.
|
||||
|
||||
---
|
||||
|
||||
## 1. Gradle 모듈 구성
|
||||
|
||||
`settings.gradle.kts` 기준 총 5개 모듈로 구성되어 있습니다.
|
||||
|
||||
| 모듈 | 역할 | 비고 |
|
||||
| :--- | :--- | :--- |
|
||||
| `:app` | 메인 Android 애플리케이션 (`bums.lunatic.launcher`) | `compileSdk 35`, `minSdk 26`, `arm64-v8a` 네이티브(C++/CMake) 포함 |
|
||||
| `:gdrive` | Google Drive `appDataFolder` 기반 로그인 및 백업 모듈 | `:app`에서 `implementation(project(":gdrive"))`로 참조 |
|
||||
| `:lun_launcher` | Wear OS 컴패니언 앱 (`bums.lunatic.launcher`, `minSdk 30`, `compileSdk 36`) | Compose for Wear OS, Tile, Complication, 제스처 전송(`MessageClient`) |
|
||||
| `:library` | 커스텀 WebView(`awesomewebview`) 라이브러리 모듈 | `settings.gradle.kts`에 포함 (현재 `app/build.gradle.kts`에서는 주석 처리) |
|
||||
| `:utils` | 공통 유틸리티/로그/뷰 헬퍼 모듈 | `settings.gradle.kts`에 포함 (현재 `app/build.gradle.kts`에서는 주석 처리) |
|
||||
|
||||
---
|
||||
|
||||
## 2. `:app` 패키지 구조 (`bums.lunatic.launcher`)
|
||||
|
||||
```text
|
||||
app/src/main/
|
||||
├── cpp/ # C++ 네이티브 엔진 (FFmpeg, AAudio, Sonic, Live Wallpaper 렌더러)
|
||||
└── kotlin/bums/lunatic/launcher/
|
||||
├── LunaticLauncher.kt # Application 클래스 (GeckoRuntime, Picasso, 로그 초기화)
|
||||
├── LauncherActivity.kt # 메인 홈 런처 Activity (HOME/LAUNCHER)
|
||||
├── apps/ # 앱 서랍, 앱/연락처 어댑터, 아이콘 팩, 검색 메뉴
|
||||
├── behavior/ # 화면 전환/동작 인터랙션 전략 패턴
|
||||
├── common/ # 공통 Activity 기반 클래스, 리모트 제스처 Fragment, 타입 별칭
|
||||
├── feeds/ # 시스템 상태, 앱 위젯 호스트(WidgetHost), RSS 파서/어댑터
|
||||
├── helpers/ # ForegroundService, WorkManager 워치독, 설정(PrefHelper), 잠금/수신기
|
||||
├── home/ # 홈 피드(RssHome), NeoRssActivity, 파일/웹/번역 화면 및 각종 BottomSheet
|
||||
│ ├── adapters/ # 북마크, 알림, 통화/SMS, RSS, 토렌트, 날씨 RecyclerView 어댑터
|
||||
│ ├── tokiz/ # 텍스트/웹툰/소설 리더(TokiFragment, HistoryManager, PagedTextLayout)
|
||||
│ └── weather/ # 날씨 API 클라이언트 및 파서
|
||||
├── model/ # Realm Kotlin 데이터 모델 (AppInfo, RssData, WeatherForcast 등)
|
||||
├── player/ # 네이티브 미디어 플레이어, 문서/이미지 뷰어 Activity
|
||||
├── qaccess/ # 퀵 액세스 패널
|
||||
├── receiver/ # NotificationListenerService(NLService), 전화/SMS/패키지/연락처 리시버
|
||||
├── settings/ # 런처 및 하위 카테고리별 설정 Activity/Fragment
|
||||
├── utils/ # 한글 초성/자모 변환, 파일/이미지/인코딩/Jsoup 유틸리티
|
||||
├── view/ # 커스텀 UI 뷰 (FloatingActionMenu, LunaticBrowserLayout, ZoomImageView 등)
|
||||
├── wall/ # 라이브 월페이퍼 서비스(MyWallpaperService) 및 JNI 브리지(NativeRenderer)
|
||||
└── workers/ # Realm DB(WorkersDb), 백그라운드 수집기(*Getter), 토렌트/위치/워치 서비스
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 핵심 컴포넌트 역할 요약
|
||||
|
||||
### 3.1. Activity
|
||||
- **`LauncherActivity`**: `MAIN` / `HOME` / `LAUNCHER` 인텐트를 처리하는 메인 홈 런처. 앱 위젯 호스트, 앱 서랍(`AppDrawerBottomSheet`), 키보드/게임패드/리모트 입력 및 `SEND`/`SEND_MULTIPLE` 공유 수신을 담당합니다.
|
||||
- **`NeoRssActivity`**: RSS/커뮤니티 피드(`RssHome`), 웹/콘텐츠 리더(`TokiFragment`) 등을 호스팅하며 `WEB_SEARCH` 및 `SEND` 인텐트를 처리합니다.
|
||||
- **`WebReaderActivity`**: 별도 런처 아이콘(`리더`)으로 실행되는 WebView 기반 웹 리더. 파일 업로드/백업 복원(`ActivityResultContracts`) 및 JS 브리지를 제공합니다.
|
||||
- **`CompletedFilesActivity`**: 별도 런처 아이콘(`파일즈`)으로 실행되는 다운로드/완료 파일 탐색기. 파일 목록 조회, 미리보기, 문서/이미지 뷰어 연동을 수행합니다.
|
||||
- **`TranslatorActivity`**: ML Kit 언어 식별(`LanguageIdentification`) 및 번역(`Translation`), Android `TextToSpeech`를 연동한 번역기 화면입니다.
|
||||
- **`PlayerActivity`**: `TextureView`와 `NativePlayer`를 사용해 동영상을 재생하는 플레이어. 외부/내장 자막 동기화 및 ML Kit 기반 자막 실시간 번역, 재생 오류 시 엔진 복구(`rebootEngine`)를 지원합니다.
|
||||
- **`DocumentViewerActivity`**: `PageIndexer`와 `PagedTextLayout`을 이용해 대용량 텍스트 문서를 인코딩 감지 후 페이지 단위로 렌더링하는 뷰어입니다.
|
||||
- **`ImageViewerActivity`**: `PhotoView`와 `ExifInterface`를 이용해 이미지 확대/축소 및 EXIF 메타데이터 오버레이를 제공합니다.
|
||||
- **`SettingsActivity` / `home.tokiz.Settings`**: 런처 전반 설정(`APPLICATION_PREFERENCES`) 및 리더 전용 설정 화면입니다.
|
||||
|
||||
### 3.2. 주요 Fragment & BottomSheet
|
||||
- **`RssHome` / `RssViewer` / `BookmarkPagerFragment`**: 홈 피드, RSS 기사 뷰어, 북마크 페이저 UI.
|
||||
- **`CompletedFilesFragment` / `TorrentListFragment` / `SystemStatusFragment` / `LearningFragment`**: 완료 파일 목록, 토렌트 진행 목록, 시스템 상태, 학습/단어장 화면.
|
||||
- **`TokiFragment` / `RemoteGestureFragment`**: 텍스트/웹 콘텐츠 리더 및 워치/리모트 제스처 연동 Fragment.
|
||||
- **`AppDrawer` / `AppDrawerBottomSheet` / `SearchBottomSheet` / `WebBottomSheet` / `VideoPreviewBottomSheet`**: 앱 서랍, 통합 검색, 인앱 웹 바텀시트, 영상 미리보기 시트.
|
||||
|
||||
### 3.3. Service & BroadcastReceiver
|
||||
- **`ForeGroundService`**: `youtubedl-android`(yt-dlp) 및 OkHttp를 활용한 영상/파일 다운로드, 블루투스/미디어 버튼 처리, WorkManager 작업 스케줄링을 담당하는 포그라운드 서비스.
|
||||
- **`TorrentService`** (`workers/TorrentManager.kt`): `jlibtorrent` 기반 토렌트 다운로드 포그라운드 서비스. Wi-Fi 및 충전 상태에 따라 세션을 제어하고, 미리보기용 핵심 피스 우선 다운로드(`previewPiecesMap`)를 지원합니다.
|
||||
- **`MyWallpaperService`**: `WallpaperService` 구현체로, C++ `NativeRenderer`를 통해 라이브 월페이퍼 표면을 렌더링하고 날씨 비트맵/미디어 전환을 처리합니다.
|
||||
- **`NLService`**: `NotificationListenerService`로 외부 앱 알림을 수집·가공하여 Realm DB 및 로그에 기록합니다.
|
||||
- **`WatchGestureService`**: `WearableListenerService`로 Wear OS 앱(`:lun_launcher`)에서 보낸 `/gesture/next`, `/gesture/prev` 등의 메시지를 수신합니다.
|
||||
- **`LocationUpdateService`**: 위치 변경을 수신하고 `Geocoder`로 주소를 변환해 Realm `LocationLog`에 저장합니다.
|
||||
- **기타 리시버**: `CallReceiver`(통화 상태), `SmsReceiver`(SMS/WAP Push), `PackageEventReceiver`(앱 설치/삭제), `ContactReceiver`, `AdminReceiver`, `BatteryReceiver`, `HeadsetActionButtonReceiver`.
|
||||
|
||||
### 3.4. 미디어·렌더링 네이티브 모듈 (`app/src/main/cpp/`)
|
||||
`CMakeLists.txt`에서 `native_renderer` 공유 라이브러리로 빌드되며 `libavformat`, `libavcodec`, `libavutil`, `libswscale`, `libswresample`, `aaudio`, `jnigraphics`를 링크합니다.
|
||||
- **미디어 플레이어 엔진 (`PlayerEngine.cpp/.h`, `native_player.cpp`, `sonic.c`, `PacketQueue.h`)**:
|
||||
- Kotlin `NativePlayer`와 JNI로 연결됩니다.
|
||||
- FFmpeg 기반 비디오/오디오 디코딩, `AAudio` 네이티브 오디오 출력, `sonic` 기반 배속 재생, 내장/외부 자막 트랙 추출 및 탐색(`seekTo`/`seekBy`)을 처리합니다.
|
||||
- **라이브 월페이퍼 렌더러 (`Renderer.cpp/.h`, `native_renderer.cpp`, `Preloader.cpp/.h`, `MediaAsset.cpp/.h`, `AnimationStrategy`, `TransitionStrategy`)**:
|
||||
- Kotlin `NativeRenderer`와 JNI로 연결됩니다.
|
||||
- 미디어 에셋 프리로딩, 전환/애니메이션 전략 적용, `Surface` 직접 렌더링을 수행합니다.
|
||||
|
||||
### 3.5. 데이터 계층 및 백그라운드 수집기 (`workers/`, `model/`)
|
||||
- **`WorkersDb`**: Realm Kotlin(`io.realm.kotlin`) 싱글톤/스키마 관리 및 `CustMigration`을 담당합니다.
|
||||
- **`TaskAggregator` & `*Getter.kt`**: 앱 목록(`AppInfoGetter`), 연락처(`ContactInfoGetter`), 통화/SMS(`RecentCallGetter`, `RecentSmsGetter`), 캘린더(`CalendarGetter`), 위치(`LocationGetter`), 날씨(`OpenWeatherGetter`), 커뮤니티/RSS/유튜브/텔레그램(`DCGetter`, `FmKoreaGetter`, `ClienGetter`, `ArcaGetter`, `RuliWebGetter`, `RedditGetter`, `TheQooGetter`, `DotaxGetter`, `NewsFeedsGetter`, `YoutubeGetter`, `TelegramBotGetter`) 데이터를 비동기로 수집해 Realm에 병합합니다.
|
||||
|
||||
---
|
||||
|
||||
## 4. 서브 모듈 요약
|
||||
|
||||
- **`:gdrive` (`kr.gdrive.bums.lunatic.utils`)**:
|
||||
- `GDriveLoginManager`: `GoogleSignIn`과 `DriveScopes.DRIVE_APPDATA` 권한 요청을 캡슐화합니다.
|
||||
- `GDriveBackupTask`: `appDataFolder`에 `manifest.json` 및 백업 대상 JSON 파일들을 업로드하는 코루틴 기반 백업 태스크입니다.
|
||||
- **`:lun_launcher` (Wear OS)**:
|
||||
- `MainActivity`: Wear OS Compose UI 및 센서 리스너를 통해 런처로 제스처 메시지를 전송합니다.
|
||||
- `MainTileService`, `MainComplicationService`, `TileActionReceiver`: 워치 페이스 컴플리케이션 및 Wear Tile을 제공합니다.
|
||||
@@ -0,0 +1,188 @@
|
||||
# LunarLauncher 핵심 클래스 분석 및 개선 TODO
|
||||
|
||||
[ARCHITECTURE.md](ARCHITECTURE.md)를 기준으로 `app/src/main/kotlin/bums/lunatic/launcher/` 경로의 핵심 Activity, Fragment, Service, Worker, Native 브리지의 데이터 흐름·호출 구조를 분석하고, **메모리 누수**, **동시성 이슈**, **누락된 예외 처리** 지점을 작업 단위로 정리한 문서입니다.
|
||||
|
||||
---
|
||||
|
||||
## 1. 핵심 클래스 데이터 흐름 및 호출 구조
|
||||
|
||||
```text
|
||||
[LunaticLauncher (Application)]
|
||||
├── 초기화: PrefHelper, Base64ImageCache, HourlyLogWriter, Picasso(OkHttp3), GeckoRuntime(지연 초기화)
|
||||
│
|
||||
├── [UI 계층: Activity / Fragment]
|
||||
│ ├── LauncherActivity (HOME/LAUNCHER)
|
||||
│ │ ├── AppWidgetHost / AppDrawerBottomSheet / SearchBottomSheet
|
||||
│ │ └── WorkersDb (Realm) ↔ TaskAggregator (*Getter 병렬 수집)
|
||||
│ ├── NeoRssActivity
|
||||
│ │ ├── RssHome (Fragment) ──▶ WorkersDb.asFlow() ──▶ RecyclerView(RssItemAdapter)
|
||||
│ │ ├── TokiFragment / BookmarkPagerFragment
|
||||
│ │ └── hiddenLoader (HashMap<String, GeckoWeb>) 백그라운드 프리로드
|
||||
│ ├── CompletedFilesActivity / WebReaderActivity / TranslatorActivity
|
||||
│ └── PlayerActivity / DocumentViewerActivity / ImageViewerActivity
|
||||
│ └── NativePlayer (JNI) ──▶ C++ PlayerEngine (FFmpeg + AAudio + Sonic)
|
||||
│
|
||||
└── [백그라운드 계층: Service / Receiver]
|
||||
├── ForeGroundService ──▶ youtubedl-android / OkHttp / WorkManager / BluetoothReceiver
|
||||
├── TorrentService (TorrentManager.kt) ──▶ jlibtorrent SessionManager + StateFlow
|
||||
├── MyWallpaperService ──▶ NativeRenderer (JNI) ──▶ C++ Renderer / Preloader
|
||||
├── NLService (NotificationListenerService) ──▶ 파일 로그 + WorkersDb
|
||||
├── WatchGestureService (WearableListenerService) ◀── :lun_launcher (Wear OS)
|
||||
└── LocationUpdateService ──▶ Geocoder ──▶ WorkersDb(LocationLog) + OkHttp(위치/날씨 API)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 작업 단위별 개선 TODO
|
||||
|
||||
### [Unit 1] 메모리 누수(Memory Leak) 제거
|
||||
|
||||
- [ ] **1-1. 정적(Companion) Activity / Fragment 참조 제거**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:89` — `@JvmStatic var lActivity: NeoRssActivity? = null`가 `onDestroy()`(`701-708`행)에서 `null`로 초기화되지 않아 Activity 인스턴스가 GC되지 않음.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LauncherActivity.kt:329` — `var sActivity: Activity? = null`가 `onDestroy()`(`973-981`행)에서 해제되지 않음.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/RssHome.kt:95` — `var home: RssHome? = null` 정적 참조로 Fragment 및 연결된 View/Binding 누수 위험.
|
||||
- **작업**: 정적 Activity/Fragment 참조를 `WeakReference` 또는 이벤트 버스(`SharedFlow`/`ViewModel`)로 대체하고, 최소한 `onDestroy()`/`onDestroyView()`에서 `null` 처리.
|
||||
|
||||
- [ ] **1-2. 전역 `Toast` 인스턴스의 `Context` 누수 해결**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LunaticLauncher.kt:62-75` — `companion object`의 `var toast: Toast? = null`에 `Context.toast()` 호출 시 전달된 `Context`(Activity일 수 있음)로 `Toast(this)`를 생성해 정적으로 유지함.
|
||||
- **작업**: `Toast(applicationContext)`를 사용하거나 매 호출 시 지역 `Toast`를 생성하고 기존 `toast?.cancel()` 후 참조를 유지하지 않도록 변경.
|
||||
|
||||
- [ ] **1-3. `BroadcastReceiver` 및 `Wearable.MessageClient` 리스너 미해제**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/helpers/ForeGroundService.kt:443` — `onCreate()`에서 `registerReceiver(bluetoothreceiver, filter)`를 호출하지만, `ForeGroundService` 클래스에 `onDestroy()`가 구현되어 있지 않아 리시버가 해제되지 않음.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:715` — `onResume()`에서 `Wearable.getMessageClient(this).addListener(messageListener)`를 등록하나 대응하는 `onPause()`/`onDestroy()`의 `removeListener` 호출 여부 점검 및 해제 보장 필요.
|
||||
- **작업**: `ForeGroundService.onDestroy()`를 추가해 `unregisterReceiver(bluetoothreceiver)` 및 `serviceScope.cancel()` 수행, `NeoRssActivity.onPause()`에서 `removeListener(messageListener)` 호출 추가.
|
||||
|
||||
- [ ] **1-4. `hiddenLoader` 내 `GeckoWeb` 인스턴스 정리 누락**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:92-107` — `hiddenLoader: HashMap<String, GeckoWeb>`에 `GeckoWeb(this)`를 생성해 보관하나 `onDestroy()`(`701-708`행)에서 세션 종료 및 `clear()`가 없음.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LauncherActivity.kt:335-351` — 동일하게 `hiddenLoader`에 `GeckoWeb(this)`를 보관하나 `onDestroy()`(`973-981`행)에서 정리하지 않음.
|
||||
- **작업**: `onDestroy()`에서 `hiddenLoader.values`의 `GeckoSession`을 닫고 `hiddenLoader.clear()` 수행.
|
||||
|
||||
- [ ] **1-5. `Handler` 콜백 미제거**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LauncherActivity.kt:1102` (`callBackHandler`), `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:272, 789` (`flingHandler`, `callBackHandler`), `app/src/main/kotlin/bums/lunatic/launcher/home/RssHome.kt:168, 1026` (`commandHandler`, `mainHandler`)
|
||||
- **작업**: `onDestroy()` / `onDestroyView()`에서 `handler.removeCallbacksAndMessages(null)` 호출 추가.
|
||||
|
||||
---
|
||||
|
||||
### [Unit 2] 동시성 및 코루틴 생명주기(Structured Concurrency) 개선
|
||||
|
||||
- [ ] **2-1. 비관리 `CoroutineScope(...).launch`를 수명주기 스코프로 전환**
|
||||
- Activity/Fragment/Service의 수명주기와 무관하게 독립 스코프를 생성해 취소되지 않는 코루틴 다수 존재:
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LauncherActivity.kt:247` (`CoroutineScope(Dispatchers.IO).launch`)
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:529` (`CoroutineScope(Dispatchers.IO).launch`)
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/RssHome.kt:804, 947` (`infosJob = CoroutineScope(Dispatchers.IO).launch`, `CoroutineScope(Dispatchers.IO).launch`)
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/CompletedFilesActivity.kt:394, 539, 767, 1171, 1516`
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/player/PlayerActivity.kt:373, 490, 655, 717, 882` (특히 `655`, `882`행은 `Job` 참조를 저장하지 않아 `onDestroy()`에서도 취소 불가)
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/helpers/ForeGroundService.kt:545, 768, 785, 893` (`serviceScope`가 `437`행에 선언되어 있음에도 새 `CoroutineScope` 생성)
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/receiver/NLService.kt:186` (`CoroutineScope(Dispatchers.IO).launch`)
|
||||
- **작업**: Activity는 `lifecycleScope`, Fragment는 `viewLifecycleOwner.lifecycleScope`, Service는 `SupervisorJob()`이 포함된 `serviceScope`를 사용하고 `onDestroy()`에서 `serviceScope.cancel()` 호출.
|
||||
|
||||
- [ ] **2-2. `LocationUpdateService` 내 `Executors` 스레드 풀 누수**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/workers/LocationUpdateService.kt:68, 106` — `pushLocation()` 호출마다 `Executors.newSingleThreadScheduledExecutor().schedule(...)`로 새 스레드 풀을 생성하고 `shutdown()`을 호출하지 않음. 또한 `130-131`행에서 `Companion.lastWeather.clear()` / `addAll()`을 백그라운드 스레드에서 동기화 없이 수정함.
|
||||
- **작업**: 단일 공유 `CoroutineScope` + `delay(5000)`으로 대체하고 `lastWeather` 갱신 시 스레드 안전한 컬렉션 또는 `StateFlow` 사용.
|
||||
|
||||
- [ ] **2-3. `ForeGroundService` 공유 상태 및 `YoutubeDL` 동시 실행 제어**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/helpers/ForeGroundService.kt:426, 542-598` — `companion object`의 `targetUrls`(일반 `ArrayList`)와 `lastProGress`, `currentProcessId`가 여러 `CoroutineScope(Dispatchers.IO)`에서 동기화 없이 접근/수정됨.
|
||||
- **작업**: `Channel` 또는 `Mutex` 기반 순차 다운로드 큐로 전환하고, `targetUrls`를 스레드 안전 구조로 교체.
|
||||
|
||||
- [ ] **2-4. `RssHome` Realm Flow 수집과 UI 리스트 동기화 정리**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/RssHome.kt:804-817` — `CoroutineScope(Dispatchers.IO)`에서 `synchronized(lasted)` 블록 안에서 `WorkersDb.getRealm()`으로 `copyFromRealm()` 후 `commandHandler.post(infoUpdate)` 호출. `infosJob?.start()`는 `launch` 직후 불필요한 호출이며, Fragment `onDestroyView()` 시 `infosJob` 취소 및 `lasted` 접근 동기화 일원화 필요.
|
||||
|
||||
---
|
||||
|
||||
### [Unit 3] 누락된 예외 처리 및 자원 관리 보강
|
||||
|
||||
- [ ] **3-1. 네트워크 호출 및 `OkHttpClient` 인스턴스 남발/미종료**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/helpers/ForeGroundService.kt:768-806` (`sendToI`): `try-catch`가 없어 네트워크 오류 시 `CoroutineScope(Dispatchers.IO)`에서 미처리 예외 발생. 매 호출마다 `OkHttpClient.Builder()`를 새로 생성하며 `response.body?.close()`(`use {}`) 누락.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/player/PlayerActivity.kt:662` (`downloadSubtitle`): 매번 `OkHttpClient()` 신규 생성 및 `response.use {}` 미사용.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/workers/LocationUpdateService.kt:72-99, 110-135`: 매 요청마다 `OkHttpClient.Builder()` 생성 및 `response.use {}` 누락.
|
||||
- **작업**: 싱글톤 `OkHttpClient` 공유, 모든 `Response`에 `.use { ... }` 적용, 코루틴 내부 네트워크 호출에 `try-catch` 또는 `CoroutineExceptionHandler` 추가.
|
||||
|
||||
- [ ] **3-2. `LocationUpdateService` `addresses.first()` 및 NPE 위험**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/workers/LocationUpdateService.kt:50-52` — `geocoder.getFromLocation(...) { addresses -> addresses.first()?.let { ... } }`에서 `addresses`가 빈 리스트일 경우 `NoSuchElementException` 발생 가능 (`105`, `127`행에서도 `addresses.first()` 재호출).
|
||||
- **작업**: `addresses.firstOrNull()?.let { address -> ... }`로 변경하고 단일 변수 `address` 재사용.
|
||||
|
||||
- [ ] **3-3. `WorkersDb` 및 `TaskAggregator` Realm 트랜잭션 예외 처리**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/workers/WorkersDb.kt:88-160` — `writeBlocking` 호출 시 예외 처리가 없어 DB 잠금/마이그레이션/스키마 오류 시 크래시 위험.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/workers/TaskAggregator.kt:16-55` — `CoroutineScope(Dispatchers.IO).launch` 내부에 `try-catch`가 없어 `AppInfoGetter`/`ContactInfoGetter` 또는 `realm.write` 실패 시 조용히 실패하거나 앱 크래시 유발.
|
||||
- **작업**: `TaskAggregator`에 `try-catch` 및 실패 로깅 추가, 메인 스레드에서의 `writeBlocking` 호출 여부 점검 후 비동기 `write`로 전환.
|
||||
|
||||
- [ ] **3-4. `PlayerActivity` `Surface` null 단언(`!!`) 및 `rebootEngine` 동시성 방어**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/player/PlayerActivity.kt:78-80` — `rebootEngine` 콜백에서 `Surface(videoTextureView.surfaceTexture!!)` 사용 시, 비동기 준비 완료 시점에 `TextureView`가 이미 해제(`surfaceTexture == null`)되었으면 `NullPointerException` 발생.
|
||||
- **작업**: `videoTextureView.surfaceTexture?.let { nativePlayer?.play(Surface(it)) }`로 null-safe 처리 및 `isDestroyed`/`isFinishing` 체크 추가.
|
||||
|
||||
- [ ] **3-5. `LunaticLauncher` 초기화 시 외부 저장소/GeckoRuntime 예외 처리**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LunaticLauncher.kt:119-126` — 하드코딩된 경로(`/storage/emulated/0/bums_ob/...`) 접근 시 권한이 없거나 경로 생성 실패 시 예외 처리 부재.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LunaticLauncher.kt:130` — 주석은 `// 60MB`이나 실제 계산식은 `1024L * 1024 * 1024 * 6` (6GB)로 되어 있어 디스크 공간/캐시 정책 확인 필요.
|
||||
- **작업**: `getExternalFilesDir` 기반 안전 경로 폴백 추가 및 캐시 크기 상수 점검.
|
||||
|
||||
---
|
||||
|
||||
### [Unit 4] 보일러플레이트 코드 제거 및 리팩토링
|
||||
|
||||
- [ ] **4-1. `LauncherActivity` ↔ `NeoRssActivity` 중복 로직 통합**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/LauncherActivity.kt:335-360`와 `app/src/main/kotlin/bums/lunatic/launcher/home/NeoRssActivity.kt:92-120`에 `hiddenLoader` + `contentsLoad(url)` 및 `onConfigurationChanged()`(`isOpendFold`, `PointerIcon.TYPE_NULL`) 로직이 거의 동일하게 중복됨.
|
||||
- **작업**: `GeckoPreloadManager`(Delegate) 및 `CommonActivity` 기반 메서드로 추출하여 중복 제거.
|
||||
|
||||
- [ ] **4-2. `OkHttpClient` 생성 및 네트워크 호출 보일러플레이트 제거**
|
||||
- `LunaticLauncher.kt:132`, `ForeGroundService.kt:769, 793`, `LocationUpdateService.kt:72, 110`, `PlayerActivity.kt:662` 등 여러 클래스에서 매번 `OkHttpClient.Builder()`와 `ConnectionPool`을 새로 생성함.
|
||||
- **작업**: 앱 공용 `OkHttpClient` 싱글톤(또는 DI 제공)과 공통 요청 헬퍼를 두어 커넥션 풀 재사용 및 보일러플레이트 제거.
|
||||
|
||||
- [ ] **4-3. ML Kit 언어 감지 + 번역 보일러플레이트 통합**
|
||||
- `PlayerActivity.kt`, `TranslatorActivity.kt`, `CompletedFilesActivity.kt`가 각각 `LanguageIdentification`, `Translation`, `TranslatorOptions`를 개별적으로 초기화·호출함.
|
||||
- **작업**: 공통 `MlKitTranslationHelper` 클래스로 캡슐화하여 모델 다운로드, 언어 감지, 번역 캐싱 로직을 일원화.
|
||||
|
||||
- [ ] **4-4. `ForeGroundService` 텔레그램 전송 메서드 통합 및 토큰 분리**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/helpers/ForeGroundService.kt:766-809` — `sendToI(msg: String)`과 `sendToI(boolean: Boolean)`이 URL 조합 및 OkHttp 호출 코드를 중복 구현하고 있으며, 봇 토큰이 소스 코드에 하드코딩되어 있음.
|
||||
- **작업**: 단일 `sendTelegramMessage(text: String)`로 통합하고 봇 토큰을 `BuildConfig`/`local.properties` 또는 `PrefHelper` 설정으로 분리.
|
||||
|
||||
- [ ] **4-5. `workers/*Getter.kt` 스크래핑/파싱 보일러플레이트 정리**
|
||||
- `DCGetter`, `FmKoreaGetter`, `ClienGetter`, `ArcaGetter`, `RuliWebGetter`, `RedditGetter`, `TheQooGetter`, `DotaxGetter`, `NewsFeedsGetter`, `YoutubeGetter` 등이 `BaseGetter.kt`를 상속하며 유사한 Jsoup/HTTP 요청, User-Agent 설정, `RssData` 변환 로직을 반복함.
|
||||
- **작업**: `BaseGetter`에 공통 HTTP 요청/Jsoup 파싱 템플릿 메서드 및 에러 핸들링을 내재화하고, 각 사이트별 파싱 규칙만 선언적으로 분리.
|
||||
|
||||
---
|
||||
|
||||
### [Unit 5] 불필요·미사용 코드, 파일 및 의존성 정리
|
||||
|
||||
- [x] **5-1. 전체 주석 처리된 레거시/샘플 파일 제거**
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/home/LauncherHome_old.kt:1-1321` — 파일 전체가 주석 처리된 구버전 홈 코드.
|
||||
- `app/src/main/kotlin/bums/lunatic/launcher/utils/MainActivity.kt:1-78` — `com.example.ch16_provider` 템플릿 코드가 전체 주석 처리된 채 남아 있음.
|
||||
- **작업**: Git 히스토리 보존 확인 후 두 파일 삭제.
|
||||
|
||||
- [ ] **5-2. 미연결 Gradle 모듈(`:library`, `:utils`) 및 루트 폴더 정리**
|
||||
- `settings.gradle.kts:25`에는 `library`, `utils` 모듈이 포함되어 있으나, `app/build.gradle.kts:167-168`에서 `// implementation(project(":library"))`, `// implementation(project(":utils"))`로 주석 처리되어 실제로 사용되지 않음.
|
||||
- 루트 디렉토리의 `ffmpeg-kit-main/` 소스 폴더와 `app/libs/ffmpeg-kit-full-6.0-2.LTS.aar`, `app/src/main/jniLibs/arm64-v8a/` 간 빌드 의존성 확인 필요 (`app/build.gradle.kts:201-205`의 주석 처리된 ffmpeg-kit 의존성 포함).
|
||||
- **작업**: 미사용 모듈/아카이브를 정리해 Gradle Sync 및 저장소 크기 최적화.
|
||||
|
||||
- [ ] **5-3. `app/build.gradle.kts` 구버전/중복 라이브러리 정리**
|
||||
- `app/build.gradle.kts:158` — 레거시 `com.squareup.okhttp:okhttp:2.7.5`가 `okhttp3`/`retrofit2`와 함께 선언되어 있음.
|
||||
- `app/build.gradle.kts:165, 169-170, 187-188` — 이미지 로더가 `Picasso`, `Glide`, `Coil` 3종이 모두 혼재되어 있음.
|
||||
- **작업**: 실제 사용처 전수 조사 후 `okhttp 2.x` 제거 및 이미지 로더(예: `Coil` 또는 `Glide` 단일화) 단계적 통합.
|
||||
|
||||
---
|
||||
|
||||
### [Unit 6] 패키지 및 중·소단위 모듈화 재설계
|
||||
|
||||
현재 `:app` 모듈에 런처 UI, RSS 스크래핑, 웹 리더, 토렌트, 네이티브 미디어 플레이어, 라이브 월페이퍼, 파일 관리, Realm DB가 모두 결합되어 있어 빌드 시간과 결합도가 높습니다. 다음과 같이 **중·소단위 Gradle 모듈**로 점진적 분리를 권장합니다.
|
||||
|
||||
```text
|
||||
lunar_launcher/
|
||||
├── app/ # 조립 레이어 (LunaticLauncher, LauncherActivity, AppDrawer, WidgetHost, Settings, ForeGroundService)
|
||||
├── core/
|
||||
│ ├── core-common/ # 공통 유틸, 확장함수, PrefHelper, ML Kit 번역 헬퍼, BaseGetter 기반
|
||||
│ ├── core-network/ # 공용 OkHttpClient, Retrofit/Jsoup 클라이언트, 텔레그램 전송 헬퍼
|
||||
│ └── core-database/ # Realm 스키마(model/*), WorkersDb, CustMigration
|
||||
├── feature/
|
||||
│ ├── feature-feeds/ # NeoRssActivity, RssHome, TaskAggregator, *Getter 스크래퍼군
|
||||
│ ├── feature-reader/ # WebReaderActivity, TokiFragment, PagedTextLayout, GeckoWeb 래퍼
|
||||
│ ├── feature-player/ # PlayerActivity, DocumentViewerActivity, ImageViewerActivity, NativePlayer + C++ PlayerEngine
|
||||
│ ├── feature-torrent/ # TorrentService, TorrentListFragment, TorrentListAdapter, jlibtorrent(.jar) 격리
|
||||
│ └── feature-wallpaper/ # MyWallpaperService, NativeRenderer + C++ Renderer/Preloader
|
||||
├── gdrive/ # (기존 유지) Google Drive appDataFolder 백업 모듈
|
||||
└── lun_launcher/ # (기존 유지) Wear OS 컴패니언 앱
|
||||
```
|
||||
|
||||
#### 단계별 모듈화 실행 순서
|
||||
- [ ] **6-1. `:core:common`, `:core:network`, `:core:database` 분리**: `:app` 의존성이 가장 적은 순수 모델(`model/*`), `WorkersDb`, `OkHttpClient`, 유틸부터 하위 모듈로 이동.
|
||||
- [ ] **6-2. 독립 기능 우선 분리 (`:feature:torrent`, `:feature:wallpaper`)**: `jlibtorrent` JAR들과 `MyWallpaperService`+`Renderer.cpp`는 타 화면과 결합도가 낮아 가장 먼저 독립 모듈로 분리하기 적합함.
|
||||
- [ ] **6-3. 뷰어/리더 분리 (`:feature:player`, `:feature:reader`)**: `PlayerActivity`/`NativePlayer`(+ `PlayerEngine.cpp`)와 `DocumentViewerActivity`/`ImageViewerActivity`, `TokiFragment`/`WebReaderActivity`를 분리.
|
||||
- [ ] **6-4. 피드/수집기 분리 (`:feature:feeds`)**: `RssHome`, `NeoRssActivity`, `TaskAggregator`, `*Getter`군을 분리하고 `:app`은 런처 홈과 서비스 진입점만 유지.
|
||||
@@ -270,11 +270,6 @@
|
||||
</intent-filter>
|
||||
</activity>
|
||||
|
||||
<!-- <service-->
|
||||
<!-- android:name=".feeds.rss.RssService"-->
|
||||
<!-- android:permission="android.permission.BIND_JOB_SERVICE"-->
|
||||
<!-- android:exported="false"/>-->
|
||||
|
||||
<provider
|
||||
android:name="androidx.core.content.FileProvider"
|
||||
android:authorities="bums.lunatic.launcher.fileprovider"
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,78 +0,0 @@
|
||||
//package com.example.ch16_provider
|
||||
//
|
||||
//import android.content.Intent
|
||||
//import android.content.pm.PackageManager
|
||||
//import android.os.Bundle
|
||||
//import android.provider.ContactsContract
|
||||
//import android.util.Log
|
||||
//import androidx.activity.result.ActivityResultLauncher
|
||||
//import androidx.activity.result.contract.ActivityResultContracts
|
||||
//import androidx.appcompat.app.AppCompatActivity
|
||||
//import androidx.core.app.ActivityCompat
|
||||
//import androidx.core.content.ContextCompat
|
||||
//import com.example.ch16_provider.databinding.ActivityMainBinding
|
||||
//
|
||||
//class MainActivity : AppCompatActivity() {
|
||||
// lateinit var binding: ActivityMainBinding
|
||||
// lateinit var requestLauncher: ActivityResultLauncher<Intent>
|
||||
//
|
||||
// override fun onCreate(savedInstanceState: Bundle?) {
|
||||
// super.onCreate(savedInstanceState)
|
||||
// binding = ActivityMainBinding.inflate(layoutInflater)
|
||||
// setContentView(binding.root)
|
||||
//
|
||||
// // 퍼미션 허용했는지 확인
|
||||
// val status = ContextCompat.checkSelfPermission(this, "android.permission.READ_CONTACTS")
|
||||
// if (status == PackageManager.PERMISSION_GRANTED) {
|
||||
// Log.d("test", "permission granted")
|
||||
// } else {
|
||||
// // 퍼미션 요청 다이얼로그 표시
|
||||
// ActivityCompat.requestPermissions(this, arrayOf<String>("android.permission.READ_CONTACTS"), 100)
|
||||
// Log.d("test", "permission denied")
|
||||
// }
|
||||
//
|
||||
// // ActivityResultLauncher 초기화, 결과 콜백 정의
|
||||
// requestLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {
|
||||
// if (it.resultCode == RESULT_OK) {
|
||||
// Log.d("test", "Uri : ${it.data!!.data!!}")
|
||||
// val cursor = contentResolver.query(
|
||||
// it.data!!.data!!,
|
||||
// arrayOf<String>(
|
||||
// ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
|
||||
// ContactsContract.CommonDataKinds.Phone.NUMBER,
|
||||
// ),
|
||||
// null,
|
||||
// null,
|
||||
// null
|
||||
// )
|
||||
// Log.d("test", "cursor size : ${cursor?.count}")
|
||||
//
|
||||
// if (cursor!!.moveToFirst()) {
|
||||
// val name = cursor.getString(0)
|
||||
// val phone = cursor.getString(1)
|
||||
// binding.textView.text = "name: $name, phone: $phone"
|
||||
// }
|
||||
// }
|
||||
// }
|
||||
//
|
||||
// binding.button.setOnClickListener {
|
||||
// // 주소록 앱 연동
|
||||
// val intent = Intent(Intent.ACTION_PICK, ContactsContract.CommonDataKinds.Phone.CONTENT_URI)
|
||||
// requestLauncher.launch(intent)
|
||||
// }
|
||||
// }
|
||||
//
|
||||
// // 다이얼로그에서 퍼미션 허용했는지 확인
|
||||
// override fun onRequestPermissionsResult(
|
||||
// requestCode: Int,
|
||||
// permissions: Array<out String>,
|
||||
// grantResults: IntArray
|
||||
// ) {
|
||||
// super.onRequestPermissionsResult(requestCode, permissions, grantResults)
|
||||
// if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
|
||||
// Log.d("test", "permission granted")
|
||||
// } else {
|
||||
// Log.d("test", "permission denied")
|
||||
// }
|
||||
// }
|
||||
//}
|
||||
Reference in New Issue
Block a user