매니페스트 업데이트

V2 매니페스트를 V3 매니페스트로 변환

manifest.json 파일의 경우 매니페스트 V3의 형식이 매니페스트 V2의 형식과 약간 다릅니다. 이 페이지에서는 manifest.json 파일에만 영향을 미치는 변경사항을 설명합니다. 하지만 스크립트와 페이지를 변경할 때는 매니페스트도 변경해야 하는 경우가 많습니다. 이러한 변경사항은 이러한 변경사항이 필요한 이전 작업에서 다룹니다.

매니페스트 버전 번호 변경

"manifest_version" 필드의 값을 2에서 3으로 변경합니다.

Manifest V2
{
 
...
 
"manifest_version": 2
 
...
}
Manifest V3
{
 
...
 
"manifest_version": 3
 
...
}

호스트 권한 업데이트

매니페스트 V3의 호스트 권한은 별도의 필드입니다. "permissions" 또는 "optional_permissions"에서 지정하지 않습니다.

콘텐츠 스크립트"content_scripts.matches" 아래에 유지됩니다. "content_scripts.matches"에 관한 자세한 내용은 정적 선언으로 삽입을 참고하세요.

Manifest V2
{
 
...
 
"permissions": [
   
"tabs",
   
"bookmarks",
   
"https://www.blogger.com/",
 
],
 
"optional_permissions": [
   
"unlimitedStorage",
   
"*://*/*",
 
]
 
...
}
Manifest V3
{
 
...
 
"permissions": [
   
"tabs",
   
"bookmarks"
 
],
 
"optional_permissions": [
   
"unlimitedStorage"
 
],
 
"host_permissions": [
   
"https://www.blogger.com/",
 
],
 
"optional_host_permissions": [
   
"*://*/*",
 
]
 
...
}

웹에서 액세스할 수 있는 리소스 업데이트

웹 액세스 가능 리소스는 웹페이지 또는 다른 확장 프로그램에서 액세스할 수 있는 확장 프로그램 내 파일입니다. Manifest V2에 구현된 "web_accessible_resources" 필드는 확장 프로그램이 리소스를 노출하도록 선택한 경우 웹사이트와 공격자가 확장 프로그램을 감지할 수 있도록 했습니다. 이로 인해 핑거프린팅 또는 의도하지 않은 리소스 액세스가 발생할 수 있습니다.

Manifest V3는 확장 프로그램의 리소스에 액세스할 수 있는 웹사이트와 확장 프로그램을 제한하여 노출을 제한합니다. 이전과 같이 파일 목록을 제공하는 대신 이제 각 리소스 세트를 URL 또는 확장 프로그램 ID 세트에 매핑하는 객체 배열을 제공합니다.

아래 예에서는 매니페스트 V2와 매니페스트 V3 간의 웹 액세스 가능한 리소스를 비교합니다. Manifest V2에서는 기본적으로 모든 웹사이트에서 지정된 리소스에 액세스할 수 있었습니다. 아래에 표시된 매니페스트 V3 코드에서 이러한 리소스는 https://example.com에서만 사용할 수 있으며 특정 이미지만 모든 웹사이트에서 사용할 수 있습니다.

자세한 내용은 웹 액세스 가능한 리소스일치 패턴을 참고하세요.

Manifest V2
{
 
...
 
"web_accessible_resources": [
   
"images/*",
   
"style/extension.css",
   
"script/extension.js"
 
],
 
...
}
Manifest V3
{
 
...
   
"web_accessible_resources": [
   
{
     
"resources": [
       
"images/*"
     
],
     
"matches": [
       
"*://*/*"
     
]
   
},
   
{
     
"resources": [
       
"style/extension.css",
       
"script/extension.js"
     
],
     
"matches": [
       
"https://example.com/*"
     
]
   
}
 
],
 
...
}