이 페이지는 Cloud Translation API를 통해 번역되었습니다.

매니페스트 파일 형식

모든 확장 프로그램은 루트 디렉터리에 manifest.json 파일이 있어야 합니다. 에는 해당 확장 프로그램의 구조 및 동작에 대한 중요한 정보가 나열됩니다. 이 페이지에서는 확장 프로그램 매니페스트의 구조와 확장 프로그램 매니페스트의 기능을 설명합니다. 포함할 수 있습니다.

예

다음 예시 매니페스트는 기본 매니페스트 구조와 매니페스트를 만들기 위한 시작점으로 흔히 사용되는 기능을 살펴봅니다.

최소 매니페스트

{
  "manifest_version": 3,
  "name": "Minimal Manifest",
  "version": "1.0.0",
  "description": "A basic example extension with only required keys",
  "icons": {
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
}

콘텐츠 스크립트 등록

{
  "manifest_version": 3,
  "name": "Run script automatically",
  "description": "Runs a script on www.example.com automatically when user installs the extension",
  "version": "1.0",
  "icons": {
    "16": "images/icon-16.png",
    "32": "images/icon-32.png",
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
  "content_scripts": [
    {
      "js": [
        "content-script.js"
      ],
      "matches": [
        "http://*.example.com//"
      ]
    }
  ]
}

콘텐츠 스크립트 삽입

{
  "manifest_version": 3,
  "name": "Click to run",
  "description": "Runs a script when the user clicks the action toolbar icon.",
  "version": "1.0",
  "icons": {
    "16": "images/icon-16.png",
    "32": "images/icon-32.png",
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
  "background": {
    "service_worker": "service-worker.js"
  },
  "action": {
    "default_icon": {
      "16": "images/icon-16.png",
      "32": "images/icon-32.png",
      "48": "images/icon-48.png",
      "128": "images/icon-128.png"
    }
  },
  "permissions": ["scripting", "activeTab"]
}

{
  "manifest_version": 3,
  "name": "Popup extension that requests permissions",
  "description": "Extension that includes a popup and requests host permissions and storage permissions .",
  "version": "1.0",
  "icons": {
    "16": "images/icon-16.png",
    "32": "images/icon-32.png",
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
  "action": {
    "default_popup": "popup.html"
  },
  "host_permissions": [
    "https://*.example.com/"
  ],
  "permissions": [
    "storage"
  ]
}

측면 패널

{
  "manifest_version": 3,
  "name": "Side panel extension",
  "version": "1.0",
  "description": "Extension with a default side panel.",
  "icons": {
    "16": "images/icon-16.png",
    "48": "images/icon-48.png",
    "128": "images/icon-128.png"
  },
  "side_panel": {
    "default_path": "sidepanel.html"
  },
  "permissions": ["sidePanel"]
}

매니페스트 키

다음은 지원되는 모든 매니페스트 키 목록입니다.

확장 프로그램 플랫폼에 필요한 키

"manifest_version": 실행되는 매니페스트 파일 형식의 버전을 지정하는 정수 확장 프로그램 사용의 예입니다. 유일하게 지원되는 값은 3입니다.
"name": Chrome 웹에서 확장 프로그램을 식별하는 문자열입니다. Store, 설치 대화상자, 사용자의 Chrome 확장 프로그램 페이지 (chrome://extensions) 이 최대 길이는 75자(영문 기준)입니다. 언어별 이름 사용에 대한 자세한 내용은 다국어 지원을 참조하세요.
"version": 확장 프로그램의 버전 번호를 식별하는 문자열입니다. 자세한 내용은 버전 번호 형식은 버전을 참고하세요.

Chrome 웹 스토어에 필요한 키

"description": Chrome 웹 스토어 및 사용자의 확장 프로그램 관리 페이지 최대 길이는 132자(영문 기준)입니다. 정보 자세한 내용은 다국어화를 참고하세요.
"icons": 확장 프로그램을 나타내는 하나 이상의 아이콘입니다. Kubernetes에 대한 아이콘을 참고하세요.

선택적 키

"action": Google 툴바. 자세한 내용은 chrome.action를 참조하세요.
"author": 확장 프로그램일 수도 있습니다.
"background": 확장 프로그램의 서비스 워커가 포함된 자바스크립트 파일을 지정합니다. 서비스 워커는 이벤트 핸들러입니다. 자세한 내용은 확장 프로그램 서비스 정보 작업자가 포함되어 있습니다.
"chrome_settings_overrides": 선택한 Chrome 설정의 재정의를 정의합니다. 자세한 내용은 Chrome 설정 재정의
"chrome_url_overrides": 기본 Chrome 페이지의 재정의를 정의합니다. 자세한 내용은 Chrome 페이지 재정의하기
"commands": 확장 프로그램 내에서 단축키를 정의합니다. 자세한 내용은 자세한 내용은 chrome.commands를 참고하세요.
"content_scripts": 사용자가 특정 웹을 열 때 사용할 JavaScript 또는 CSS 파일 지정 페이지를 참조하세요. 자세한 내용은 콘텐츠 스크립트를 참고하세요.
"content_security_policy": 확장 프로그램의 스크립트, 스타일, 기타 리소스에 대한 제한사항을 정의합니다. 있습니다. 자세한 내용은 콘텐츠 보안 정책을 참고하세요.
"cross_origin_embedder_policy": Cross-Origin-Embedder-Policy HTTP 헤더 값을 지정합니다. 확장 프로그램 페이지에 교차 출처 리소스 삽입을 구성합니다.
"cross_origin_opener_policy": Cross-Origin-Opener-Policy HTTP 헤더의 값을 지정합니다. 최상위 확장 프로그램 페이지가 탐색 컨텍스트를 공유하지 않도록 해야 합니다. 교차 출처 문서로 그룹화합니다
"declarative_net_request": declarativeNetRequest의 정적 규칙을 정의합니다. API - 네트워크 요청을 차단 및 수정할 수 있습니다.
"default_locale": 다음을 지원하는 확장 프로그램의 기본 언어를 정의하는 문자열입니다. 여러 언어를 지원합니다. 예: 'en' 'pt_BR'입니다. 이 키는 현지화되지 않은 확장 프로그램에 사용되어서는 안 됩니다. 자세한 내용은 다국어화를 참고하세요.
"devtools_page": DevTools API를 사용하는 페이지를 정의합니다.
"export": 확장 프로그램에서 리소스를 내보낼 수 있도록 허용합니다. 자세한 내용은 내보내기.
"externally_connectable": 확장 프로그램에 연결할 수 있는 다른 페이지 및 확장 프로그램을 지정합니다. 대상 자세한 내용은 "externally_connectable"를 참고하세요.
"homepage_url": 확장 프로그램의 홈페이지 URL을 지정하는 문자열입니다. 이 필드가 정의되지 않은 경우 홈페이지는 기본적으로 확장 프로그램의 Chrome 웹 스토어 페이지로 설정됩니다. 이 필드는 특히 확장 프로그램을 호스팅할 때 유용합니다. 참고하시기 바랍니다.
"host_permissions": 확장 프로그램이 상호작용할 수 있고 다음을 사용하여 정의된 웹페이지를 나열합니다. URL 일치 패턴 설치 시 이 사이트에 대한 사용자 권한이 요청됩니다. 있습니다. 자세한 내용은 호스트 권한을 참고하세요.
"import": 리소스를 확장 프로그램으로 가져오도록 허용합니다. 자세한 내용은 가져오기.
"incognito": 시크릿 모드에서 확장 프로그램이 작동하는 방식을 정의합니다. 지원되는 값: "spanning", "split", "not_allowed" 자세한 내용은 시크릿 모드:
"key": 다양한 개발 사용 사례에 맞게 확장 프로그램의 ID를 지정합니다. 자세한 내용은 자세한 내용은 키를 참고하세요.
"minimum_chrome_version": 확장 프로그램을 설치할 수 있는 가장 오래된 Chrome 버전을 정의합니다. 값은 기존 Chrome 브라우저 버전 문자열의 하위 문자열(예: "107" 또는 "107.0.5304.87" 다음 이전 버전의 Chrome을 사용 중인 사용자는 최소 버전에는 '호환되지 않음'이라고 표시됨 경고가 표시되고 확장 프로그램을 설치할 수 없습니다. 이 광고 확장을 기존 광고 확장에 추가하면 이전 버전의 Chrome 사용자에게는 확장자가 포함됩니다. 여기에는 임시 모드입니다.
"oauth2": OAuth 2.0 보안 ID를 사용하도록 허용합니다. 이 키의 값은 "client_id" 및 "scopes" 속성이 있는 객체 자세한 내용은 OAuth를 2.0 튜토리얼을 참조하세요.
"omnibox": 확장 프로그램이 Chrome 주소 표시줄에 키워드를 등록하도록 허용합니다. 자세한 내용은 자세한 내용은 검색주소창을 참고하세요.
"optional_host_permissions": 선택적 호스트를 선언합니다. 다음에 대한 권한: 선택합니다.
"optional_permissions": 확장 프로그램의 선택적 권한을 선언합니다.
"options_page": 확장 프로그램이 옵션으로 사용할 options.html 파일의 경로를 지정합니다. 옵션 페이지를 참조하세요. 자세한 내용은 사용자에게 옵션을 참고하세요.
"options_ui": 사용자가 확장 프로그램 옵션을 변경할 수 있는 HTML 파일의 경로를 지정합니다. Chrome 확장 프로그램 페이지에서 Chrome 확장 프로그램 페이지로 이동합니다. 자세한 내용은 삽입된 데이터 옵션을 참고하세요.
"permissions": 특정 확장 프로그램 API를 사용 설정합니다. 권한을 참고하세요. 참조하세요. 개별 API에 대한 참조 페이지에는 액세스할 수 있습니다.
"requirements": 확장 프로그램을 사용하는 데 필요한 기술을 나열합니다. 지원되는 자세한 내용은 요구사항을 참고하세요.
"sandbox": 확장 프로그램 API에 액세스할 수 없는 확장 프로그램 페이지 집합을 정의합니다. 샌드박스 처리되지 않은 페이지에 직접 액세스할 수 없습니다. 자세한 내용은 샌드박스.
"short_name": 사용할 확장 프로그램 이름의 축약된 버전이 포함된 문자열입니다. 문자 공간이 제한된 경우. 최대 길이는 12자(영문 기준)입니다. 만약 정의되지 않음, 'name'의 잘린 버전 키가 표시됩니다.
"side_panel": sidePanel이 있습니다.
"storage": 관리형 스토리지의 JSON 스키마를 선언합니다. 영역을 참조하세요. 자세한 내용은 자세한 내용은 저장소 영역의 매니페스트를 참고하세요.
"tts_engine": 확장 프로그램을 TTS(텍스트 음성 변환) 엔진으로 등록합니다. 자세한 내용은 ttsEngine API에서 더 이상 사용할 수 없습니다.
"update_url": 확장 프로그램의 업데이트 페이지 URL이 포함된 문자열입니다. 다음과 같은 경우에 이 키를 사용합니다. 확장 프로그램을 호스팅하는 경우 Chrome 웹 스토어 외부에서 확인할 수 있습니다
"version_name": 확장 프로그램의 버전을 설명하는 문자열입니다. 예를 들면 "1.0 beta" 및 "build rc2" 지정되지 않은 경우 '버전' 값이 확장 프로그램 관리 페이지를 대신 표시합니다.
"web_accessible_resources": 웹페이지나 다른 사용자가 액세스할 수 있는 확장자 내에 파일을 정의합니다. 확장 프로그램 자세한 내용은 웹 접근성을 참조하세요. 리소스.

선택적 ChromeOS 키

"file_browser_handlers": fileBrowserHandler에 대한 액세스 권한을 제공합니다. API - 확장 프로그램이 ChromeOS 파일 브라우저에 액세스할 수 있게 해줍니다.
"file_handlers": ChromeOS 확장 프로그램에서 처리할 파일 형식을 지정합니다. 자세한 내용은 file_handlers을 참고하세요.
"file_system_provider_capabilities": fileSystemProvider 액세스를 허용합니다. API - 확장 프로그램이 ChromeOS에서 사용할 수 있는 파일 시스템을 만들 수 있게 해줍니다.
"input_components": Input Method Editor API를 사용할 수 있습니다. 자세한 내용은 input_components를 참고하세요.