Elftia 업데이트
Elftia에는 항상 최신 버전을 사용할 수 있도록 내장 자동 업데이트 메커니즘이 있습니다. 이 페이지에서는 업데이트가 작동하는 방식과 수동 업데이트 방법을 설명합니다.
자동 업데이트
Elftia는 자동 업데이트에 electron-updater를 사용합니다. 기본적으로 애플리케이션은 백그라운드에서 자동으로 업데이트를 확인합니다.
업데이트 흐름
- 업데이트 확인: Elftia가 시작될 때와 실행 중에 주기적으로 업데이트 서버에 새 버전을 조회합니다.
- 업데이트 다운로드: 새 버전이 발견되면 설치 프로그램이 백그라운드에서 자동으로 다운로드됩니다. 다운로드 중에도 애플리케이션을 계속 사용할 수 있습니다.
- 설치 알림: 다운로드가 완료되면 애플리케이션이 새 버전이 준비되었음을 알리는 업데이트 알림을 표시합니다.
- 재시작 및 설치: 알림에서 "Restart and Install"을 클릭하면 애플리케이션이 닫히고 업데이트를 설치한 뒤 자동으로 다시 시작됩니다.
업데이트 과정은 데이터에 영향을 주지 않습니다. 모든 채팅 기록, 구성, API Keys 및 기타 데이터는 업데이트 후에도 그대로 유지됩니다.
업데이트 채널
Elftia는 버전 문자열을 기준으로 업데이트 채널을 자동으로 결정합니다.
| Channel | Version Example | Description |
|---|---|---|
| latest | 1.0.0 | 안정 릴리스, 모든 사용자에게 권장 |
| beta | 1.1.0-beta.1 | 새 기능이 포함되어 있지만 문제가 있을 수 있는 Beta 버전 |
| alpha | 1.2.0-alpha.3 | 개발자와 테스터를 위한 초기 미리보기 |
기본적으로 latest 채널의 업데이트만 받습니다. 새 기능을 일찍 사용해보고 싶다면 beta 업데이트를 선택할 수 있습니다.
수동 업데이트 확인
사용 가능한 업데이트를 즉시 확인하려면 다음을 수행하세요.
- Settings → About을 엽니다.
- 현재 버전 번호와 업데이트 상태가 표시됩니다.
- Check for Updates 버튼을 클릭합니다.
- 시스템이 즉시 업데이트 서버에 조회합니다.
- 새 버전이 있으면 버전 번호와 업데이트 노트를 표시한 뒤 다운로드를 시작합니다.
- 이미 최신 상태이면 "Already on the latest version"을 표시합니다.
다운로드 진행률
업데이트 패키지를 다운로드하는 동안 About 페이지에서 다운로드 진행률을 볼 수 있습니다.
- 다운로드 백분율과 속도를 표시합니다.
- 다운로드는 정상 사용에 영향을 주지 않고 백그라운드에서 진행될 수 있습니다.
- 네트워크가 중단되면 연결이 복구될 때 다운로드가 자동으로 재시도됩니다.
재시작 및 설치
업데이트 다운로드가 완료되면 다음이 진행됩니다.
- 애플리케이션이 About 페이지에 알림 또는 "Restart and Install" 버튼을 표시합니다.
- 버튼을 클릭하면 Elftia가 다음을 수행합니다.
- 저장되지 않은 모든 상태 저장
- 애플리케이션 닫기
- 업데이트 설치 실행
- 자동으로 재시작
- 업데이트 설치에는 일반적으로 몇 초에서 1분 정도가 걸립니다.
나중에 재시작하도록 선택할 수 있습니다. 업데이트는 이미 다운로드되어 있으며, 다음에 애플리케이션을 정상적으로 닫고 다시 시작할 때 자동으로 설치됩니다.
Steam 버전 업데이트
Elftia의 Steam 버전을 사용하는 경우 업데이트 방식이 다릅니다.
| Comparison | Standard Edition | Steam Edition |
|---|---|---|
| 업데이트 확인 | 앱 내 자동 | Steam 클라이언트를 통해 자동 |
| 다운로드 방식 | 앱 내 백그라운드 다운로드 | Steam 다운로드 |
| 설치 방식 | 앱 재시작 | Steam 자동 설치 |
| 수동 트리거 | Settings → About → Check for Updates | Steam → 게임 우클릭 → Check for updates |
Steam 버전 업데이트는 Steam 클라이언트가 완전히 관리하므로 Elftia 내에서 별도로 할 일은 없습니다.
Portable 버전 수동 업데이트
Portable 버전을 사용하는 경우 자동 업데이트를 사용할 수 없을 수 있습니다. 수동 업데이트 단계는 다음과 같습니다.
- 공식 웹사이트 또는 GitHub Releases에서 최신 버전 설치 프로그램을 다운로드합니다.
- 현재 실행 중인 Elftia를 닫습니다.
- 새 버전을 설치합니다.
- Windows: 새 설치 프로그램을 실행합니다. 이전 버전이 자동으로 대체됩니다.
- macOS: Applications 폴더의 기존 .app을 새 .app으로 교체합니다.
- Linux: 기존 AppImage 파일을 교체합니다.
- 새 버전을 실행합니다.
데이터는 애플리케이션 설치 디렉터리가 아니라 사용자 데이터 디렉터리에 저장되므로, 수동 업데이트로 데이터가 손실되지 않습니다.
업데이트 실패 문제 해결
자동 업데이트가 실패하면 다음 단계를 시도하세요.
다운로드 실패
- 네트워크 문제: 인터넷 연결을 확인하세요. 프록시를 사용하는 경우 프록시 구성이 올바른지 확인하세요(프록시 사용 참조).
- 디스크 공간: 시스템에 업데이트 패키지를 위한 충분한 디스크 공간이 있는지 확인하세요(일반적으로 200-500 MB의 임시 공간).
- 방화벽: 방화벽이 Elftia의 업데이트 서버 접근을 차단하지 않는지 확인하세요.
설치 실패
- 권한 문제: Windows에서는 업데이트 설치에 관리자 권한이 필요할 수 있습니다. Elftia를 관리자 권한으로 실행해 보세요.
- 파일 잠금: 다른 프로그램이 Elftia 설치 디렉터리의 파일을 잠그고 있지 않은지 확인하세요.
- 수동 업데이트: 자동 설치가 반복해서 실패하면 최신 버전을 다운로드해 수동으로 설치하세요.
롤백
새 버전에 문제가 있는 경우:
- GitHub Releases에서 이전 안정 버전을 다운로드합니다.
- 현재 버전을 제거합니다.
- 이전 버전을 설치합니다.
- 데이터는 사용자 데이터 디렉터리에 저장되므로 보존됩니다.
드물게 새 버전에 데이터베이스 마이그레이션이 포함될 수 있습니다. 새 버전이 이미 마이그레이션을 실행한 뒤 이전 버전으로 롤백하면 호환성 문제가 발생할 수 있습니다. 업데이트 전에 Settings → System → Export Diagnostics를 통해 진단 정보를 백업으로 내보내는 것이 좋습니다.
버전 번호 형식
Elftia는 semantic versioning을 따릅니다.
major.minor.patch[-prerelease]
| Part | Meaning | Example |
|---|---|---|
| Major Version | 주요 변경 또는 호환되지 않는 업데이트 | 2.0.0 |
| Minor Version | 새 기능, 하위 호환 | 1.1.0 |
| Patch | 버그 수정 및 사소한 개선 | 1.0.1 |
| Prerelease | Beta 버전 | 1.1.0-beta.1 |