chrome.app.runtime

설명

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

유형

ActionData

Chrome 54 이상

속성

  • actionType

ActionType

Chrome 54 이상

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

값

EmbedRequest

속성

  • 데이터

    모든 선택사항

    선택사항인 개발자가 삽입을 결정할 때 삽입할 앱에서 사용할 수 있는 데이터를 지정했습니다.

  • 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 공개 세션에서 실행되는지 여부입니다.

  • items

    LaunchItem[] 선택사항

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

  • referrerUrl

    문자열 선택사항

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

  • source

    LaunchSource 선택사항

    앱이 실행된 위치입니다.

  • url

    문자열 선택사항

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

LaunchItem

속성

  • entry

    항목

    항목의 항목입니다.

  • 유형

    문자열 선택사항

    파일의 MIME 유형입니다.

LaunchSource

앱 실행 소스의 열거형입니다. 이 API는 구성요소/services/app_service/public/mojom/types.mojom의 AppLaunchSource와 extensions/browser/api/app_runtime/app_runtime_api.cc의 GetLaunchSourceEnum()과 동기화를 유지해야 합니다. 열거형은 UMA 히스토그램에서 사용되므로 항목의 순서를 바꾸거나 제거해서는 안 됩니다.

enum

"new_tab_page"

"load_and_launch"

"file_handler"

"url_handler"

"about_page"

"management_api"

"context_menu"

"intent_url"

"app_home_page"

이벤트

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