Files
android_multiviewwer/TODO.md
T
lun_admin 6570929608 fix: Task 10 완료 - PlayerActivity lifecycleScope 전환 및 Surface NPE 방어
- PlayerActivity.kt:
  * 비관리 CoroutineScope(Dispatchers.Main/IO).launch 5곳(uiUpdateJob, leftLongPressJob, downloadSubtitle, subtitleSyncJob, translateSubtitles)을 lifecycleScope.launch로 전환하여 Activity 종료 시 자동 취소 보장
  * rebootEngine() 내 onPreparedListener에서 isDestroyed/isFinishing 체크 및 videoTextureView.surfaceTexture!! -> safe let 전환으로 NPE 방지
- TODO.md: 3-4 항목 완료 처리
- 검증: ./gradlew :app:compileDebugKotlin 빌드 성공 확인 (3s)
2026-11-16 11:21:45 +09:00

19 KiB

LunarLauncher 핵심 클래스 분석 및 개선 TODO

ARCHITECTURE.md를 기준으로 app/src/main/kotlin/bums/lunatic/launcher/ 경로의 핵심 Activity, Fragment, Service, Worker, Native 브리지의 데이터 흐름·호출 구조를 분석하고, 메모리 누수, 동시성 이슈, 누락된 예외 처리 지점을 작업 단위로 정리한 문서입니다.


1. 핵심 클래스 데이터 흐름 및 호출 구조

[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 참조 제거 (onDestroy/onDestroyView 해제 처리 완료)

    • 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] 불필요·미사용 코드, 파일 및 의존성 정리

  • 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 구버전/중복 라이브러리 정리 (구버전 okhttp:2.7.5 및 주석 의존성 제거 완료; 이미지 로더 단일화는 추후 검토)

    • 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 모듈로 점진적 분리를 권장합니다.

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은 런처 홈과 서비스 진입점만 유지.