Manifest V2 확장 프로그램을 Manifest V3 확장 프로그램으로 전환하는 방법에 관한 가이드
이 섹션에서는 확장 프로그램을 Manifest V2에서 Chrome 확장 프로그램 플랫폼의 최신 버전인 Manifest V3로 업그레이드할 수 있습니다. 마이그레이션 작업은 크게 아래의 카테고리로 나뉩니다. 작업을 추적할 수 있도록 문서의 내용을 요약한 체크리스트를 제공합니다. 체크리스트를 통해 콘텐츠에 액세스하거나 콘텐츠를 자세히 살펴볼 수 있습니다. 두 경로 모두 업그레이드된 확장으로 끝납니다.
- 매니페스트 업데이트:
manifest.json는 V3 전용이어야 합니다. 이 섹션에는 직접 변경할 수 있는 변경사항이 설명되어 있습니다. 코드와 관련된 매니페스트 변경사항은 지원되는 코드 변경사항으로 설명됩니다. - 서비스 워커로 이전 — 서비스 워커는 확장 프로그램의 백그라운드 또는 이벤트 페이지를 대체하여 성능을 저하시킬 수 있는 백그라운드 코드가 기본 스레드에서 벗어나도록 합니다. 또한 이러한 변경을 위해서는 DOM, 창 및 특정 확장 API 호출을 화면 밖 문서로 이동해야 합니다.
- API 호출 업데이트: 일부 API 호출을 이에 상응하는 최신 API 호출로 대체해야 합니다.
- 차단 웹 요청 리스너 대체: Manifest V2에서 네트워크 요청을 차단하거나 수정하면 성능이 크게 저하되고 민감한 사용자 데이터에 과도하게 액세스해야 할 수 있습니다. Declarative Net Request API를 사용하면 확장 프로그램이 성능을 저해하지 않으면서 더 적은 권한으로 웹 콘텐츠를 차단하거나 수정할 수 있습니다.
- 확장 프로그램 보안 개선: Manifest V3는 여러 가지 방법으로 확장 프로그램 보안을 개선합니다. 향상된 콘텐츠 보안 정책 외에도 원격 호스팅 코드 및 임의의 문자열 실행에 대한 지원이 삭제됩니다.
- 확장 프로그램 게시 - 이 섹션에서는 Manifest V3 확장 프로그램이 예상대로 작동하도록 먼저 제한된 잠재고객을 대상으로 테스트하여 단계적 출시를 실행하는 방법을 설명합니다.
확장 프로그램 매니페스트 변환기도 있습니다. 모든 기능을 사용할 수는 없지만 시작하는 데 도움이 될 것입니다. 변환기의 README에는 도구에서 변경되는 항목에 대한 설명이 나와 있습니다.
현재 기능 모음 유지
예기치 않은 문제나 버그가 발생할 가능성을 줄이려면 이전 시 새로운 기능을 추가하지 않는 것이 좋습니다. 예를 들어 새 권한이 필요한 기능을 추가하면 권한 경고가 트리거되어 사용자가 새 권한을 수락할 때까지 확장 프로그램이 사용 중지됩니다. 경고를 표시하지 않고 권한을 추가하는 다른 방법을 알아보려면 권한 경고 권장사항을 참고하세요.
Manifest V3는 일반적으로 Chrome 88 이상에서 지원됩니다. API 호출을 업데이트할 때 버전 88이 될 때까지 대체 기능이 Chrome에 포함되지 않았을 수 있습니다. API 참조 페이지에는 개별 API 구성원에 대한 지원 정보가 나와 있습니다. 이러한 기능 중 하나가 필요한 경우 매니페스트 파일에서 최소 Chrome 버전을 지정할 수 있습니다.
새로운 확장 프로그램 플랫폼 기능
Manifest V3 출시 이후 Google은 계속해서 새로운 기능을 추가해 왔으며, 이 중 대부분은 Manifest V2와 Manifest V3에서 모두 사용할 수 있습니다. 전환 시 반드시 사용해야 하는 것은 아닙니다. 그러나 이전 기능이 이전 기능을 대체하면 대체되는 기능보다 대체 기능을 선호하고 대체된 기능이 결국 지원 중단되어 삭제될 것으로 예상해야 합니다.