이전 진행 상황을 추적하세요.
아래 체크리스트는 마이그레이션 작업을 추적하는 데 도움이 됩니다. 안내 링크와 함께 완료해야 하는 작업을 정의합니다. 이전 작업은 이전 요약에 설명된 대로 크게 다섯 가지 카테고리로 나뉩니다.
매니페스트 업데이트
manifest.json
파일은 Manifest V3와 Manifest V2에 약간 다른 형식이 필요합니다. 이 페이지에서는 manifest.json
파일에만 영향을 미치는 변경사항을 설명합니다. 그러나 스크립트와 페이지를 변경하려면 대부분 매니페스트를 변경해야 합니다. 이러한 변경은 변경이 필요한 마이그레이션 작업에 적용됩니다.
서비스 워커로 마이그레이션
백그라운드 코드가 기본 스레드에 남아 있도록 확장 프로그램의 백그라운드 또는 이벤트 페이지를 서비스 워커가 대체합니다. 이를 통해 필요한 경우에만 확장 프로그램을 실행하여 리소스를 절약할 수 있습니다.
시작하기 전에 백그라운드 스크립트와 확장 프로그램 서비스 워커의 차이점을 읽어보세요.
- 매니페스트의 '백그라운드' 필드 업데이트
- DOM 및 창 호출을 오프스크린 문서로 이동
- localStorage를 chrome.storage.local로 변환
- 동기식으로 리스너 등록
XMLHttpRequest()
호출을 전역fetch()
로 바꿉니다.- 상태 유지
- 타이머를 알람으로 변환하기
- 예외적인 경우 서비스 워커 활성 유지
API 호출 업데이트
일부 기능을 동등한 Manifest V3 기능으로 교체해야 합니다. 나머지는 완전히 삭제해야 합니다.
tabs.executeScript()
를scripting.executeScript()
로 바꿉니다.tabs.insertCSS()
및tabs.removeCSS()
를scripting.insertCSS()
및scripting.removeCSS()
로 바꿉니다.- 브라우저 작업 및 페이지 작업을 작업으로 대체
- Manifest V2 백그라운드 컨텍스트를 예상하는 함수 교체.
- 콜백을 프로미스로 바꾸기
- 지원되지 않는 API 대체
차단 웹 요청 리스너 교체
(Manifest V2에서처럼) 프로그래매틱 방식으로 네트워크 요청을 읽고 변경하는 대신 확장 프로그램은 특정 조건 집합이 충족될 때 실행할 작업을 설명하는 규칙을 지정합니다.
위의 항목을 완료한 후 몇 가지 일반적인 사용 사례를 검토해 보세요.
확장 프로그램 보안 강화
확장 프로그램의 보안 개선을 위해 변경이 필요합니다. 여기에는 더 이상 지원되지 않는 원격 호스팅 코드의 삭제가 포함됩니다.
Manifest V3 확장 프로그램 게시
매니페스트 버전 3으로 변환한 후에는 Chrome 웹 스토어에 확장 프로그램을 출시할 차례입니다. 변경사항에 따라 단계적으로 출시를 고려합니다. 이 접근 방식을 사용하면 확장 프로그램을 전체 사용자층에 출시하기 전에 먼저 제한된 잠재고객을 대상으로 확장 프로그램이 예상대로 작동하는지 확인할 수 있습니다.