
Open VSX에서 '확장 기능 버전 불일치 오류'가 발생했을 때의 대처법
요약
Open VSX를 사용하는 포크된 IDE에서 발생하는 확장 기능 버전 불일치 오류의 원인과 해결 방법을 설명합니다. IDE의 고유 버전과 VS Code 기준 버전 간의 차이를 product.json 파일의 ideVersion 수정을 통해 해결하는 절차를 다룹니다.
핵심 포인트
- Open VSX 확장 기능과 IDE 간의 버전 판정 버그 원인 분석
- product.json 파일 내 ideVersion 수정을 통한 근본적 해결
- OS별(Linux, Windows, Mac) product.json 파일 위치 안내
※본 기사는 생성형 AI의 도움을 받아 작성되었습니다.
서론
Google Antigravity 등 VS Code를 베이스로 포크(Fork)된 IDE를 이용하다 보면, 확장 기능(Extension)을 설치하려고 할 때 다음과 같은 오류를 마주할 수 있습니다.
"Extension is not compatible with Code X.X.X. Extension requires: ^1.XX.0."
이는 IDE 고유의 버전 표기(예: 1.23.2)와 Open VSX의 확장 기능 측에서 요구하는 본가 VS Code의 버전 기준(예: ^1.85.0)이 맞지 않아 발생하는 버전 판정 버그(사양의 차이)입니다.
본 기사에서는 이 오류를 근본적으로 해결하고, 확장 기능을 도입 및 활성화하기 위한 절차를 해설합니다.
product.json의 「ideVersion」을 수정하기
해결책: IDE의 코어 설정 파일인 product.json을 직접 편집하여 내부의 버전 차이를 해소합니다.
1. product.json의 위치 확인하기
- 사용 중인 환경에 따라 다음 경로에 있는
product.json을 찾습니다.
- Ubuntu / Linux:
/usr/share/antigravity/resources/app/product.json - Windows:
C:\Users\<사용자명>\AppData\Local\Programs\antigravity\resources\app\product.json - Mac:
/Applications/Antigravity.app/Contents/Resources/app/product.json
2. 설정 수정
파일을 관리자 권한의 텍스트 에디터로 엽니다.
상단에 있는 `
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기