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