이전 목록으로
#Dart#Flutter

Flutter 백그라운드 콜백에 `@pragma('vm:entry-point')`가 필요한 이유

AOT Tree Shaking과 네이티브에서 호출되는 Dart 진입점의 관계, 선언 및 테스트 방법을 정리한다.

Debug에서는 실행되던 백그라운드 콜백이 Release에서만 사라질 수 있다. Dart 호출 그래프에 없는 함수가 AOT 최적화 과정에서 제거될 수 있기 때문이다.

@pragma('vm:entry-point')
Future<void> backgroundCallback() async {
  // 백그라운드 작업
}

적용 대상은 네이티브 코드나 플러그인이 런타임에 호출하는 함수, 백그라운드 메시지 콜백, 별도 Isolate 진입점 등이다. 일반 함수 전체에 붙이는 어노테이션은 아니다.

class BackgroundEntrypoints {
  @pragma('vm:entry-point')
  static void onStart() {
    // 이 Isolate에서 필요한 의존성 초기화
  }
}

플러그인 요구사항에 따라 top-level 또는 static 함수로 선언한다. 백그라운드 Isolate는 메인 Isolate의 메모리 상태를 그대로 공유하지 않으므로 DI와 플러그인 초기화도 확인한다.

이 문제는 Debug만으로 찾기 어렵다. Release/Profile을 실기기에 설치해 프로세스 종료와 재부팅 조건까지 테스트한다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.