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