[ARCHITECTURE.md](ARCHITECTURE.md)를 기준으로 `app/src/main/kotlin/bums/lunatic/launcher/` 경로의 핵심 Activity, Fragment, Service, Worker, Native 브리지의 데이터 흐름·호출 구조를 분석하고, **메모리 누수**, **동시성 이슈**, **누락된 예외 처리** 지점을 작업 단위로 정리한 문서입니다.
-`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` 접근 동기화 일원화 필요.
-`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` 추가.
-`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`로 전환.
-`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` 체크 추가.
-`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` 기반 안전 경로 폴백 추가 및 캐시 크기 상수 점검.
-`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` 기반 메서드로 추출하여 중복 제거.
-`LunaticLauncher.kt:132`, `ForeGroundService.kt:769, 793`, `LocationUpdateService.kt:72, 110`, `PlayerActivity.kt:662` 등 여러 클래스에서 매번 `OkHttpClient.Builder()`와 `ConnectionPool`을 새로 생성함.
- **작업**: 앱 공용 `OkHttpClient` 싱글톤(또는 DI 제공)과 공통 요청 헬퍼를 두어 커넥션 풀 재사용 및 보일러플레이트 제거.
-`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 및 저장소 크기 최적화.
-`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 모듈**로 점진적 분리를 권장합니다.
│ └── 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`는 타 화면과 결합도가 낮아 가장 먼저 독립 모듈로 분리하기 적합함.