본문으로 건너뛰기

이벤트 (Event)

앱 생명주기 상태 변화 이벤트를 구독하는 모듈입니다.

개요​

appify.event는 앱이 포그라운드, 백그라운드, 비활성 상태로 전환될 때 콜백을 실행하는 구독 기능을 제공합니다. 반환된 Subscription 객체의 unsubscribe를 호출하여 구독을 해제할 수 있습니다. 메모리 누수 방지를 위해 컴포넌트 언마운트 시 반드시 구독을 해제해야 합니다.

API​

onAppStateChange(callback: (state: AppState) => void): Subscription​

앱 상태 변화를 구독합니다.

매개변수

이름타입필수설명
callback(state: AppState) => void예상태 변경 시 실행될 콜백 함수

AppState 값:

값설명
'active'앱이 포그라운드에서 실행 중
'background'앱이 백그라운드로 전환됨
'inactive'앱이 비활성 상태 (iOS 멀티태스킹 전환 등)

반환값: Subscription - 구독 객체. unsubscribe() 메서드로 구독을 해제합니다.

예제

import { appify } from '@nolraunsoft/appify-sdk';

const subscription = appify.event.onAppStateChange((state) => {
  if (state === 'active') {
    console.log('앱이 활성화되었습니다. 데이터를 새로고침합니다.');
  } else if (state === 'background') {
    console.log('앱이 백그라운드로 전환되었습니다.');
  }
});

// 구독 해제
subscription.unsubscribe();

플랫폼별 참고사항​

  • 'inactive' 상태는 iOS 전용입니다. Android에서는 발생하지 않습니다.
  • 앱이 완전히 종료된 경우에는 콜백이 호출되지 않습니다.

관련 문서​