커뮤니티 솔루션

ZimaOS 앱 스토어 업데이트 방식: 수동 유지 관리, 안정성, 풀 리퀘스트, 앱 스토어 v2

A November 2025 thread asking why some ZimaOS App Store applications lagged upstream versions. Zima-Giorgio said store versions were manually maintained, stability mattered, availability issues were prioritized, and the team regularly reviewed pull requests. Current App Store v2 adds version/update metadata and content-hash-driven client updates but does not itself guarantee a fixed release cadence.

ZimaOS App Store 업데이트는 “업스트림 업데이트 후 항상 7일 이내에 업데이트”와 같은 단순한 규칙에 따라 관리되지 않았습니다. 2025년 11월 소스 스레드에서 Zima-Giorgio는 앱 버전이 수동으로 관리된다고 밝혔습니다. 또한 안정성이 중요하므로 서비스 애플리케이션은 최신 업스트림 릴리스보다 의도적으로 늦게 업데이트될 수 있으며, 사용 불가를 초래하는 문제는 더 높은 우선순위를 받는다고 설명했습니다.

현재 App Store 2.0은 앱 카탈로그를 빌드하고 제공하는 방식을 변경하지만, 자동으로 보장된 유지 관리 주기를 만들어 주지는 않습니다. v2 프로토콜은 버전 메타데이터, 업데이트 시각, 릴리스 노트, 콘텐츠 해시, 클라이언트의 증분 업데이트를 지원하지만, 소스 앱 정의를 유지 관리하고 검증하려면 여전히 사람이 필요합니다.

IceWhale은 스토어 버전이 수동으로 관리된다고 밝혔습니다

공식 답변은 간단했습니다. App Store 소프트웨어 버전은 수동으로 관리되며, 서드파티 및 커뮤니티 스토어에서 더 최신 버전을 제공할 수도 있다는 내용이었습니다.

따라서 기본 카탈로그의 버전이 업스트림 애플리케이션 개발자가 게시한 최신 태그와 다를 수 있습니다.

최신 버전이 항상 가장 안전한 것은 아닙니다

Zima-Giorgio는 이후 서비스 유형 애플리케이션이 항상 최신 릴리스를 즉시 실행한다고 보장할 수는 없다고 명확히 설명했습니다. 안정성도 결정 요소입니다.

NAS에서는 서두른 데이터베이스 업그레이드나 메이저 버전 업그레이드가 업스트림보다 검증된 릴리스 하나 늦게 실행하는 것보다 더 큰 문제를 일으킬 수 있습니다.

사용 불가를 초래하는 문제는 더 높은 우선순위를 받습니다

IceWhale은 Immich를 예로 들었습니다. 이전 서버가 해당 모바일 앱과 더 이상 호환되지 않게 되자 App Store 패키지가 업데이트되었습니다.

이는 유용한 유지 관리 원칙을 보여 줍니다. 정상적인 사용을 막는 호환성 문제는 기능만 추가된 업스트림 릴리스보다 더 빠른 대응을 정당화할 수 있습니다.

풀 리퀘스트는 유지 관리 절차의 일부입니다

IceWhale은 팀이 PR 목록을 정기적으로 확인하고 필요에 따라 요청을 병합한다고 밝혔습니다. Giorgio는 사용자들에게 PR을 제출하거나 직접 스토어를 만들도록 권장했으며, 특히 Uptime Kuma 업데이트에 도움을 요청했습니다.

이러한 방식으로 App Store는 폐쇄적인 벤더 전용 카탈로그라기보다 부분적으로 협업형 카탈로그로 운영됩니다.

현재 App Store v2에는 더 명확한 빌드 및 업데이트 프로토콜이 적용됩니다

현재 IceWhale 개발자 문서에 따르면 생성된 v2 스토어에는 다음과 같은 필드가 포함됩니다.

  • version;
  • update_at;
  • release_note;
  • content_hash.

클라이언트의 업데이트 확인은 스토어 인덱스와 콘텐츠 해시를 기준으로 수행됩니다. 따라서 변경되지 않은 애플리케이션은 건너뛰고, 변경된 앱 메타데이터 또는 Compose 파일만 증분 방식으로 가져올 수 있습니다.

현재 App Store v2 빌드 및 업데이트 모델을 참조하세요.

버전 메타데이터가 유지 관리 SLA를 만드는 것은 아닙니다

이제 스토어에서 더 나은 버전 및 업데이트 정보를 제공할 수 있지만, 프로토콜은 모든 앱을 일정 기간 이내에 업데이트해야 한다고 규정하지 않습니다. 카탈로그 정책과 앱 검증은 여전히 사람의 작업입니다.

App Store 버전과 Docker 이미지 태그는 관련 있지만 동일하지는 않습니다

Compose 파일은 특정 이미지 태그를 고정할 수도 있고, latest와 같은 광범위한 태그를 사용할 수도 있으며, 서로 독립적인 여러 이미지를 포함하는 다중 서비스 스택을 참조할 수도 있습니다. 스토어에 표시되는 버전은 스택 내 모든 이미지가 동일한 버전 번호를 따른다는 보장이 아니라, 패키징된 앱 정의를 나타낼 수 있습니다.

정확한 업스트림 버전 관리가 중요하다면 Compose 정의를 확인하세요.

메이저 애플리케이션 업데이트에는 각별한 주의가 필요합니다

Nextcloud, Immich, 데이터베이스, 홈 오토메이션 플랫폼과 같은 애플리케이션에는 스키마 마이그레이션이나 호환성을 깨뜨리는 구성 변경이 포함될 수 있습니다. 유지 관리자가 마이그레이션 동작을 검증하는 동안 App Store 업데이트가 지연되는 것은 의도된 조치일 수 있습니다.

카탈로그보다 앞서 수동으로 업데이트하기 전에 애플리케이션 데이터를 백업하세요.

커뮤니티 스토어는 더 빠르게 움직일 수 있지만 위험도 다릅니다

서드파티 스토어는 더 최신 버전을 먼저 게시할 수 있지만, 검증 수준과 업데이트 주기, 롤백 품질은 해당 유지 관리자의 역량에 따라 달라집니다. “기본 스토어보다 최신”이라고 해서 자동으로 “더 잘 테스트된 버전”인 것은 아닙니다.

App Store 업데이트 FAQ

IceWhale은 매월 정해진 업데이트 주기를 약속했나요?

아니요. 소스에 따르면 버전은 수동으로 관리되며, 안정성과 가용성이 우선순위에 영향을 미칩니다.

사용자가 App Store 앱 업데이트를 도울 수 있나요?

예. IceWhale은 풀 리퀘스트와 서드파티 스토어를 명시적으로 권장했습니다.

App Store v2는 업데이트 메타데이터를 개선하나요?

예. 현재 v2 출력은 버전, 업데이트 시각, 릴리스 노트, 콘텐츠 해시 기반 업데이트 확인을 지원합니다.