Firefox 158 뒤 PWA 실행 오류, 무엇을 업데이트해야 할까?

디스크 경고처럼 보여도 먼저 호환성 수정판을 확인한다

PWAsForFirefox로 설치한 웹앱이 Firefox 158 업데이트 뒤 열리지 않고 “The installation seems to be incomplete.”를 표시한다면, PWAsForFirefox 2.20.1 이상이 적용됐는지 확인해야 한다. 프로젝트의 2.20.1 릴리스는 158에서 웹앱이 시작할 때 발생하는 충돌을 고쳤다고 명시한다. 10월 9일 나온 수정판으로, Firefox 158의 10월 13일 공개 전에 갱신하도록 안내한 버전이다.

이는 Firefox 자체의 일반적인 설치 오류와 구분되는 호환성 문제다. Mozilla의 158 릴리스 노트도 같은 오류를 알려진 문제로 적고 이 수정판을 안내한다. 오류 문구만 보고 웹앱 프로필부터 지울 필요는 없다.

Firefox와 확장, 네이티브 프로그램은 같은 업데이트가 아니다

PWAsForFirefox는 브라우저 확장 외에 PC에 설치하는 네이티브 프로그램과 앱 실행용 Firefox 런타임을 사용한다. 브라우저 업데이트를 끝냈다는 사실만으로 이 구성요소가 모두 최신이 되지는 않는다.

공식 업데이트 안내에 따르면 네이티브 프로그램은 자체 자동 갱신 기능이 없다. 설치 파일을 사용했다면 새 버전으로 갱신하고, 지원 패키지 관리자로 설치했다면 그 경로에서 업데이트해야 한다. 확장은 오래된 네이티브 프로그램을 감지하면 갱신 알림을 표시한다.

패키지 저장소가 수정판을 늦게 공급할 수도 있다. 10월 17일 Manjaro 포럼의 사용자 사례에서는 Firefox는 158로 올라갔지만 안정 브랜치의 firefoxpwa는 2.19.0인 상태에서 여러 웹앱이 모두 실패했다. 이 사례의 버전은 당시 보고값이며, 지금 설치할 버전은 사용하는 저장소에서 확인해야 한다.

갱신 후에도 오류가 남으면 재설치 다음 패치다

Mozilla가 제시한 후속 순서는 확장 설정의 Reinstall runtime → Patch profiles and runtime이다. 먼저 수정된 PWAsForFirefox를 갖춘 뒤 진행한다.

1. 확장과 네이티브 프로그램을 2.20.1 이상의 서로 맞는 버전으로 갱신한다.
2. 문제의 웹앱을 다시 실행해 같은 오류가 남는지 확인한다.
3. 계속 실패하면 확장 설정에서 Reinstall runtime을 실행한다.
4. 이어서 Patch profiles and runtime을 실행하고 웹앱을 다시 연다.

확장 사용 안내에서 런타임 재설치는 현재 앱용 런타임을 제거하고 Mozilla의 최신판을 내려받는 기능이다. 주 Firefox 브라우저나 기존 프로필·데이터를 지우지는 않는다. 다만 직접 넣은 커스텀 런타임은 교체되며, 자동 설치를 지원하지 않는 플랫폼은 수동 런타임 설치가 필요하다.

패치 메뉴는 현재 설치된 패치를 모든 프로필과 런타임에 적용한다. 이름이 비슷한 Update web apps는 앱 매니페스트를 읽고 운영체제에 앱을 다시 등록하는 기능이므로, 위 복구 순서의 패치 메뉴와 바꿔 누르면 안 된다.

일반 Firefox까지 안 열리면 다른 오류 경로다

이번 수정은 PWAsForFirefox를 통해 여는 데스크톱 웹앱에 해당한다. Android에서 홈 화면 추가 버튼이 안 보이거나, 웹사이트의 설치 배너가 나오지 않는 문제를 해결하는 업데이트는 아니다.

주 Firefox 브라우저 자체가 Windows에서 같은 설치 오류를 표시한다면 Mozilla의 일반 설치 오류 안내를 따라 설치 파일과 디스크 상태를 점검해야 한다. 앱용 런타임 문제인지 브라우저 전체의 시작 문제인지 구분하면 불필요한 프로필 삭제와 재설치를 줄일 수 있다.