MiniApp 생명주기

이 명세는 MiniApp 전역 애플리케이션의 생명주기가 무엇인지 정의하고, MiniApp이 일반적으로 수행하는 다섯 가지 중요한 전역 애플리케이션 생명주기 이벤트에 응답할 수 있도록 정의를 추가합니다:

• MiniApp 초기화

• MiniApp 포그라운드에서 실행

• MiniApp 백그라운드에서 실행

• MiniApp 오류 상태

• MiniApp 언로드 중

각 MiniApp은 초기화 후, 포그라운드에서 실행 중이거나 백그라운드에서 실행 중이 됩니다.

사용자가 MiniApp의 닫기 버튼을 클릭하여 MiniApp을 닫거나 휴대전화의 홈 화면으로 이동하는 경우, MiniApp은 즉시 파괴되지 않고 백그라운드에서 실행 중인 상태로 전환됩니다.

사용자가 동일한 MiniApp을 다시 열면, MiniApp은 백그라운드에서 실행 중인 상태에서 포그라운드에서 실행 중인 상태로 전환됩니다.

언로드 중은 MiniApp 세션의 종료와 캐시에서 모든 임시 리소스가 제거됨을 표시합니다. MiniApp 사용자 에이전트는 MiniApp이 기준을 충족하면 이 제거를 수행합니다. MiniApp이 특정 시간(예: 5분)보다 오래 백그라운드에서 실행되거나, 백그라운드에서 너무 많은 시스템 리소스를 점유하는 경우 MiniApp은 언로드되어야 합니다.

이 명세는 위의 전역 애플리케이션 생명주기 이벤트를 지원하기 위해 다섯 가지 전역 애플리케이션 생명주기 상태를 형식화합니다:

launched

MiniApp 초기화를 위한 생명주기 상태입니다. 이는 MiniApp 초기화가 완료되었음을 의미하며, 한 번만 트리거됩니다. 개발자는 이 이벤트를 통해 URI, 소스 정보 등 MiniApp의 정보를 얻을 수 있습니다.

shown

MiniApp 포그라운드에서 실행을 위한 생명주기 상태입니다. MiniApp이 launched 상태에 들어가면, 또는 MiniApp이 백그라운드에서 실행 중인 상태에서 포그라운드에서 실행 중인 상태로 전환되면 트리거됩니다.

hidden

MiniApp 백그라운드에서 실행을 위한 생명주기 상태입니다. MiniApp이 백그라운드에서 실행 중인 상태로 포그라운드에서 실행 중인 상태에서 전환되면 트리거됩니다.

error

MiniApp 오류 상태를 위한 생명주기 상태입니다. MiniApp에 스크립트 오류가 발생하면 트리거됩니다.

unloaded

MiniApp 언로드 중을 위한 생명주기 상태입니다. MiniApp이 언로드되면 트리거됩니다.

Service Workers와 같은 기존 Web 명세에 대한 매핑은 MiniApp Lifecycle Explainer에 나와 있습니다.

MiniApp 전역 애플리케이션 생명주기 상태는 API에서 GlobalState enum을 통해 반영됩니다.

WebIDLenum GlobalState {
    "launched", "shown", "hidden", "error", "unloaded"
};

GlobalState enum은 전역 애플리케이션 생명주기 상태를 나타내는 데 사용됩니다.

"launched" enum 값은 launched 전역 애플리케이션 생명주기 상태를 나타냅니다.

"shown" enum 값은 shown 전역 애플리케이션 생명주기 상태를 나타냅니다.

"hidden" enum 값은 hidden 전역 애플리케이션 생명주기 상태를 나타냅니다.

"error" enum 값은 error 전역 애플리케이션 생명주기 상태를 나타냅니다.

"unloaded" enum 값은 unloaded 전역 애플리케이션 생명주기 상태를 나타냅니다.

WebIDL[Exposed=Window]
interface Global {
 readonly attribute GlobalState globalState;
 readonly attribute InputObject inputObject;
 readonly attribute LifecycleError lifecycleError;
 attribute EventHandler ongloballaunched;
 attribute EventHandler onglobalshown;
 attribute EventHandler onglobalhidden;
 attribute EventHandler onglobalerror;
 attribute EventHandler onglobalunloaded;
};

WebIDL[Exposed=Window]
interface InputObject {
    readonly attribute DOMString pagePath;
    readonly attribute DOMString referrerInfo;
    readonly attribute DOMString lang;
    readonly attribute TextDirection dir;
};

WebIDLenum TextDirection {    
    "auto",
    "ltr",    
    "rtl"
};

텍스트 방향 값은 다음과 같으며, 사람이 읽을 수 있는 멤버의 값이 기본적으로 다음을 의미합니다:

auto

방향성은 [UAX9] Unicode Bidirectional Algorithm 알고리즘에 의해 결정됩니다.

ltr

왼쪽에서 오른쪽으로 쓰는 텍스트.

rtl

오른쪽에서 왼쪽으로 쓰는 텍스트.

WebIDL[Exposed=Window]
interface LifecycleError {
    readonly attribute DOMString errorDescription;
    readonly attribute DOMString lang;
    readonly attribute TextDirection dir;
};

이 명세는 MiniApp 페이지의 생명주기가 무엇인지 정의하고, MiniApp이 일반적으로 수행하는 다섯 가지 중요한 페이지 생명주기 이벤트에 응답할 수 있도록 정의를 추가합니다:

• MiniApp 페이지 로딩

• MiniApp 페이지 첫 렌더링 준비 완료

• MiniApp 페이지가 포그라운드에서 실행 중

• MiniApp 페이지가 백그라운드에서 실행 중

• MiniApp 페이지 언로드 중

1. 사용자가 처음 MiniApp을 열면 MiniApp 초기화가 시작됩니다. 뷰 계층과 로직 계층은 동시에 초기화를 시작합니다.

2. 로직 계층 초기화가 완료되면 MiniApp 인스턴스를 생성합니다. 동시에 뷰 계층 초기화가 완료되면, 뷰 계층과 로직 계층 사이의 통신 채널을 설정하기 위해 MiniApp 페이지 로딩을 시작합니다.

3. 통신 채널이 설정된 후, 로직 계층은 첫 렌더링을 시작하기 위해 초기 데이터를 뷰 계층으로 보냅니다.

4. 뷰 계층이 로직 계층에서 입력된 초기 데이터를 기반으로 페이지 UI 업데이트를 완료하면, 첫 렌더링이 완료된 것으로 간주되며, 그 후 뷰 계층은 MiniApp 페이지 첫 렌더링 준비 완료를 트리거하도록 로직 계층에 알립니다.

5. 그 후 사용자는 MiniApp과 상호작용할 수 있습니다. 뷰 계층은 사용자 이벤트를 로직 계층에 전달하여 추가 처리하도록 트리거될 수 있으며, 이후 로직 계층은 재렌더링을 위해 결과 데이터를 뷰 계층으로 반환합니다.

6. 사용자가 현재 MiniApp 페이지를 떠나면(예: 다른 MiniApp 페이지로 이동하는 경우), MiniApp 페이지가 백그라운드에서 실행 중이 트리거됩니다. MiniApp 페이지가 다시 열리면 MiniApp 페이지가 포그라운드에서 실행 중이 트리거됩니다.

7. 사용자가 현재 MiniApp 페이지를 닫으면 MiniApp 페이지 언로드 중이 트리거됩니다.

이 명세는 위의 페이지 생명주기 이벤트를 지원하기 위해 다섯 가지 MiniApp 페이지 생명주기 상태를 형식화합니다:

page loaded

MiniApp 페이지 로딩을 위한 생명주기 상태입니다. 이는 MiniApp 페이지 로딩이 완료되었음을 의미합니다. 이 시점에 로직 계층은 초기화 데이터를 얻었으며, 개발자는 현재 MiniApp 페이지의 경로와 그 경로의 쿼리를 얻을 수 있습니다.

page ready

MiniApp 페이지 첫 렌더링 준비 완료를 위한 생명주기 상태입니다. MiniApp 페이지 첫 렌더링이 완료되면 트리거됩니다. 이 시점에 페이지 UI를 구성할 수 있습니다.

page shown

MiniApp 페이지가 포그라운드에서 실행 중을 위한 생명주기 상태입니다. 페이지가 페이지가 백그라운드에서 실행 중인 상태에서 페이지가 포그라운드에서 실행 중인 상태로 전환되면 트리거됩니다. 이 시점에 개발자는 데이터를 업데이트하고 페이지를 새로 고칠 수 있습니다.

page hidden

MiniApp 페이지가 백그라운드에서 실행 중을 위한 생명주기 상태입니다. MiniApp 페이지가 페이지가 포그라운드에서 실행 중인 상태에서 페이지가 백그라운드에서 실행 중인 상태로 전환되면 트리거됩니다.

page unloaded

MiniApp 페이지 언로드 중을 위한 생명주기 상태입니다. MiniApp 페이지가 닫히면 트리거됩니다.

Page Visibility와 같은 기존 Web 명세에 대한 매핑은 MiniApp Lifecycle Explainer에 나와 있습니다.

MiniApp 페이지 생명주기 상태는 API에서 PageState enum을 통해 반영됩니다.

WebIDLenum PageState {
    "loaded", "ready", "shown", "hidden", "unloaded"
};

PageState enum은 MiniApp 페이지 생명주기 상태를 나타내는 데 사용됩니다.

"loaded" enum 값은 page loaded 페이지 생명주기 상태를 나타냅니다.

"ready" enum 값은 page ready 페이지 생명주기 상태를 나타냅니다.

"shown" enum 값은 page shown 페이지 생명주기 상태를 나타냅니다.

"hidden" enum 값은 page hidden 페이지 생명주기 상태를 나타냅니다.

"unloaded" enum 값은 page unloaded 페이지 생명주기 상태를 나타냅니다.

WebIDL[Exposed=Window]
interface Page {
    readonly attribute PageState pageState;
    readonly attribute PageInputObject pageInputObject;
    attribute EventHandler onpageloaded;
    attribute EventHandler onpageready;
    attribute EventHandler onpageshown;
    attribute EventHandler onpagehidden;
    attribute EventHandler onpageunloaded;
};

WebIDL[Exposed=Window]
interface PageInputObject {
    readonly attribute DOMString pageInputQuery;
};