호환성 가이드
Manifest V2와 Manifest V3: Chrome 버전별로 설치할 수 있는 것
Chrome 87부터 156까지 버전 순서대로, 두 확장 프로그램 형식이 언제 작동하고 언제 실패하는지, 이전 버전을 다운로드하기 전에 무엇을 확인해야 하는지 살펴봅니다.
Manifest V2와 Manifest V3란
- Manifest V2
- 이전 Chrome 확장 프로그램 형식입니다. 상시 실행되는 백그라운드 페이지로 동작하며 네트워크 요청을 직접 가로채고 바꿀 수 있습니다. Chrome은 이 형식을 단계적으로 중단하고 있습니다.
- Manifest V3
- 현재 형식으로, Chrome 88부터 지원됩니다. 백그라운드는 필요할 때만 시작되는 service worker로 바뀌고, 네트워크 필터링은 선언형 규칙(declarativeNetRequest)을 사용하며 권한이 더 엄격합니다.
모든 확장 프로그램의 manifest.json에 어떤 형식인지 적혀 있습니다. 아래에서는 MV2, MV3로 줄여 씁니다.
Manifest V2 완전 종료
브라우저에 MV2 스위치나 정책이 더 이상 없으며 모든 방법이 거부됩니다. MV3에는 상한이 없어 88부터 테스트한 최신 156까지 정상 실행되었습니다. 남은 위험은 브라우저가 너무 오래된 경우뿐입니다.
156테스트한 최신 버전: MV2는 모두 거부, MV3는 실행.실측151명령줄 스위치가 모두 사라집니다.실측
MV2 설치 거부
일반 사용자는 더 이상 MV2를 쓸 수 없습니다. 설치가 거부되고 다시 사용 설정할 수도 없으며, 개발자 모드나 “압축해제된 확장 프로그램을 로드합니다”로도 우회할 수 없습니다. 기업 정책(138까지)과 명령줄 스위치(150까지)만 잠시 유지할 수 있습니다.
150명령줄 스위치가 작동하는 마지막 버전(추가 재사용 설정 필요).실측139기업 정책 ExtensionManifestV2Availability가 제거됩니다.실측137MV2가 기본적으로 거부되며 다시 사용 설정할 수 없습니다.실측
MV2 기본 사용 중지
MV2 확장 프로그램은 여전히 설치되지만 사용 중지된 상태로 들어옵니다(unsupportedManifestVersion). chrome://extensions에서 다시 사용 설정하면 정상적으로 실행됩니다. Google은 2024년 10월부터 단계적으로 배포했기 때문에 일부 사용자는 나중에 겪었습니다.
2024년 10월Google이 사용자 대상 단계적 배포를 시작합니다.Chrome 문서129코드 기본값이 MV2를 사용 중지하기 시작합니다.실측
두 형식이 공존하고 MV3 기능이 채워짐
MV2와 MV3 모두 정상 작동하는, 호환성이 가장 넓은 구간입니다. MV3의 새 API가 하나씩 추가되며, 이를 사용하면서 최소 버전을 선언하지 않은 확장 프로그램은 이전 브라우저에도 설치되지만 해당 기능은 작동하지 않습니다.
127–128MV2는 아직 실행됩니다. Chrome이 확장 프로그램 페이지에서 MV2 중단 예고를 표시하기 시작합니다.실측120userScripts 권한을 사용할 수 있습니다(사용자가 직접 사용 설정해야 함).Chrome 문서114sidePanel을 사용할 수 있습니다.실측109offscreen API를 사용할 수 있습니다. 이전 버전에서는 설치·실행은 되지만 호출이 실패합니다.실측2022년 1월Chrome 웹 스토어가 새 MV2 확장 프로그램을 더 이상 받지 않습니다(스토어 정책이며 브라우저 변경은 아님).스토어 정책96declarativeNetRequestWithHostAccess 권한을 사용할 수 있습니다.Chrome 문서92ES 모듈 백그라운드가 실행되기 시작합니다.실측
MV3가 안정 버전에 도입
Chrome 88부터 MV3 확장 프로그램을 설치하고 실행할 수 있습니다. 다만 ES 모듈("type": "module")로 작성된 백그라운드는 92 전까지 설치는 되어도 실행되지 않습니다.
88–91모듈 백그라운드는 목록에 service worker가 표시되지만 실제로는 시작되지 않습니다.실측88MV3 기본 지원: 설치, 사용 설정, 백그라운드 실행이 모두 정상.실측
MV2만 있던 시기
정식 형식은 Manifest V2뿐입니다. MV3 확장 프로그램은 안정 버전에서도 설치되고 사용 설정된 것처럼 보이지만 백그라운드 스크립트가 전혀 실행되지 않습니다. 가장 알아채기 어려운 실패입니다.
87안정 버전 87은 manifest_version 2까지만 인식하며, service_worker 백그라운드는 Dev 채널에서만 됩니다.소스 확인
Chrome 137부터 MV2는 설치가 거부되며 일반 사용자에게는 우회 방법이 없습니다.
Chrome 129–136은 MV2 확장 프로그램을 자동으로 사용 중지하지만 사용자가 다시 사용 설정할 수 있습니다.
MV3에는 Chrome 88 이상이 필요합니다. 그보다 오래된 브라우저에서는 설치되어도 실행되지 않습니다.
이전 버전을 다운로드하기 전에
- 매니페스트 버전 확인: Chrome 137 이상이면 MV3만 선택하세요.
- 최소 버전 확인: 그보다 낮으면 설치가 거부됩니다.
- 브라우저가 오래되었다면 호환되는 최신 버전을 고르거나 먼저 브라우저를 업데이트하세요.
테스트 방법과 한계
2026년 10월 18일 Linux에서 Chrome for Testing 113–156과 Chromium 87–112 스냅샷으로 테스트했으며, 테스트용 확장 프로그램과 실제 Google Translate 2.0.13 / 2.0.18, AdBlock으로 “설치”, “사용 설정”, “백그라운드 실제 실행”을 구분했습니다. CRX 설치 경로는 기업 정책 강제 설치로 확인했습니다. Chrome for Testing에는 Google의 단계적 배포가 없으므로 위의 버전은 코드가 적용되는 시점이며, 실제 사용자는 더 늦게 변화를 겪었을 수 있습니다. Windows, Mac, Edge 및 기타 Chromium 브라우저는 다루지 않았습니다. 150 이후 날짜는 Chrome의 4주 출시 주기로 추정했습니다.
Edge 등 기타 Chromium 브라우저는 자체 일정을 따르며 여기서는 테스트하지 않았습니다.