chrome.app.runtime

설명

chrome.app.runtime API를 사용하여 앱 수명 주기를 관리합니다. 앱 런타임은 앱 설치를 관리하고, 이벤트 페이지를 제어하며, 언제든지 앱을 종료할 수 있습니다.

유형

ActionData

Chrome 54 이상

속성

  • actionType

    "new_note"

ActionType

Chrome 54 이상

앱은 특정 작업(예: 새 메모 만들기)을 염두에 두고 실행할 수 있습니다. 앱이 실행된 작업 유형은 LaunchData 인스턴스의 actionData 필드 내에서 사용할 수 있습니다.

값

"new_note"

EmbedRequest

속성

  • 데이터

    any 선택사항

    삽입할 앱이 삽입 결정을 내릴 때 사용할 수 있는 개발자 지정 데이터(선택사항)입니다.

  • embedderId

    문자열

  • 허용

    void

    embedderId가 이 앱을 <appview> 요소에 삽입하도록 허용합니다. url는 삽입할 콘텐츠를 지정합니다.

    allow 함수는 다음과 같습니다. 

    (url: string) => {...}

    • URL

      문자열

  • deny

    void

    embedderId가 이 앱을 <appview> 요소에 삽입하지 못하도록 합니다.

    deny 함수는 다음과 같습니다. 

    () => {...}

LaunchData

속성

  • actionData

    ActionData 선택사항

    Chrome 54 이상

    이 앱이 실행된 ActionType를 지정하는 데이터를 포함합니다. 앱이 특정 작업 인텐트로 실행되지 않은 경우 null입니다.

  • id

    문자열 선택사항

    앱이 호출되는 파일 또는 URL 핸들러의 ID입니다. 핸들러 ID는 매니페스트의 file_handlers 또는 url_handlers 사전에서 최상위 키입니다.

  • isKioskSession

    불리언 선택사항

    앱이 Chrome OS 키오스크 세션에서 실행 중인지 여부입니다.

  • isPublicSession

    불리언 선택사항

    Chrome 47 이상

    앱이 Chrome OS 공개 세션에서 실행 중인지 여부입니다.

  • 항목

    LaunchItem[] 선택사항

    file_handlers 매니페스트 키의 일치하는 파일 핸들러에 의해 트리거된 onLaunched 이벤트의 파일 항목입니다.

  • referrerUrl

    문자열 선택사항

    url_handlers 매니페스트 키의 일치하는 URL 핸들러에 의해 트리거된 onLaunched 이벤트의 리퍼러 URL입니다.

  • source

    LaunchSource 선택사항

    앱이 실행되는 위치입니다.

  • URL

    문자열 선택사항

    url_handlers 매니페스트 키의 일치하는 URL 핸들러에 의해 트리거된 onLaunched 이벤트의 URL입니다.

LaunchItem

속성

  • entry

    항목

    상품 항목입니다.

  • 유형

    문자열 선택사항

    파일의 MIME 유형입니다.

LaunchSource

앱 실행 소스의 열거형입니다. 이는 components/services/app_service/public/mojom/types.mojom의 AppLaunchSource 및 extensions/browser/api/app_runtime/app_runtime_api.cc의 GetLaunchSourceEnum()과 동기화되어야 합니다. 열거형은 UMA 히스토그램에 사용되므로 항목을 재정렬하거나 삭제해서는 안 됩니다.

열거형

'추적되지 않음'

"app_launcher"

"new_tab_page"

'새로고침'

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

'keyboard'

"extensions_page"

'management_api'

"ephemeral_app"

'background'

'kiosk'

"chrome_internal"

'test'

"installed_notification"

"context_menu"

'arc'

"intent_url"

"app_home_page"

"focus_mode"

'sparky'

이벤트

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

삽입 앱이 이 앱 삽입을 요청할 때 실행됩니다. 이 이벤트는 --enable-app-view 플래그가 있는 개발자 채널에서만 사용할 수 있습니다.

매개변수

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

런처에서 앱이 실행될 때 실행됩니다.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

Chrome이 마지막으로 종료될 때 실행 중이던 앱 또는 다른 이유로 앱이 이전 상태에서 다시 시작하도록 요청받은 경우 (예: 사용자가 앱의 보관 파일에 대한 액세스 권한을 취소하면 런타임에서 앱을 다시 시작함) Chrome 시작 시 실행됩니다. 이러한 상황에서 앱에 onRestarted 핸들러가 없으면 대신 onLaunched 이벤트가 전송됩니다.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    () => void