Add AppImage install and update bundle

This commit is contained in:
burnintuna 2026-07-21 02:48:15 +09:00
parent a1b941e8f5
commit 91590ec08d
5 changed files with 211 additions and 11 deletions

View file

@ -15,7 +15,38 @@ sudo pacman -S fuse2 gvfs gvfs-smb
- `gvfs`: FTP와 SFTP 접근
- `gvfs-smb`: SMB 공유 접근
## 2. 다운로드 검증
## 2. 권장 방법: 통합 번들로 설치 또는 업데이트
Release 페이지에서 `Comicviewer-0.1.0-x86_64.tar.gz`와 같은 최신 버전의
통합 번들을 다운로드합니다. 압축을 풀고 설치 스크립트를 실행합니다.
```sh
tar -xzf Comicviewer-0.1.0-x86_64.tar.gz
cd Comicviewer-0.1.0-x86_64
./install-or-update.sh
```
스크립트는 AppImage 체크섬을 검증하고 다음 작업을 수행합니다.
- AppImage를 `~/.local/opt/comicviewer/Comicviewer.AppImage`에 설치
- `~/.local/bin/comicviewer` 실행 링크 생성
- 애플리케이션 메뉴용 데스크톱 파일과 아이콘 설치
- 기존 버전이 있으면 검증된 새 AppImage로 원자적으로 교체
이후 재배포된 새 번들을 다운로드해 같은 명령을 실행하면 업데이트됩니다.
사용자 설정, 읽기 기록, 원격 ZIP 캐시는 그대로 유지됩니다.
제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다.
```sh
./install-or-update.sh --uninstall
```
이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를
모두 삭제합니다. 삭제한 데이터는 복구할 수 없으므로 필요한 설정은 제거 전에
별도로 백업합니다.
## 3. AppImage만 다운로드하는 방법
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
@ -31,7 +62,7 @@ sha256sum -c Comicviewer-0.1.0-x86_64.AppImage.sha256
`성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고
다시 다운로드합니다.
## 3. 실행
## 4. 직접 실행
AppImage에 실행 권한을 부여한 뒤 실행합니다.
@ -47,7 +78,7 @@ FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방
./Comicviewer-0.1.0-x86_64.AppImage --appimage-extract-and-run
```
## 4. 선택 사항: 사용자 계정에 설치
## 5. 선택 사항: 수동으로 사용자 계정에 설치
AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로 실행하려면 다음을
사용합니다.

View file

@ -39,15 +39,31 @@ LINUXDEPLOY="/path/to/appimage-tools/linuxdeploy-x86_64.AppImage" \
완성된 AppImage는 `dist/`에 생성됩니다. 배포 전에 직접 실행해 기본 화면이
열리는지 확인합니다.
## 4. 체크섬 생성
## 4. 통합 배포 번들 생성
아래 예시의 버전은 실제 릴리스 버전으로 변경합니다.
AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz` 번들을 한 번에
생성합니다.
```sh
version=0.1.0
./packaging/build-release-bundle.sh
```
스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다.
- `dist/Comicviewer-0.1.0-x86_64.AppImage.sha256`
- `dist/Comicviewer-0.1.0-x86_64.tar.gz`
- `dist/Comicviewer-0.1.0-x86_64.tar.gz.sha256`
통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘,
한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를
보존하므로 ZIP보다 Linux 배포에 적합합니다.
생성된 번들의 압축 목록과 체크섬을 확인합니다.
```sh
tar -tzf dist/Comicviewer-0.1.0-x86_64.tar.gz
cd dist
sha256sum "Comicviewer-${version}-x86_64.AppImage" \
> "Comicviewer-${version}-x86_64.AppImage.sha256"
sha256sum -c Comicviewer-0.1.0-x86_64.tar.gz.sha256
```
## 5. 소스 커밋과 태그
@ -71,6 +87,8 @@ git push origin v0.1.0
Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음
파일을 첨부합니다.
- `Comicviewer-0.1.0-x86_64.tar.gz`
- `Comicviewer-0.1.0-x86_64.tar.gz.sha256`
- `Comicviewer-0.1.0-x86_64.AppImage`
- `Comicviewer-0.1.0-x86_64.AppImage.sha256`
@ -80,9 +98,10 @@ Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안
지원 환경: CachyOS / Arch Linux x86_64
필수 패키지: fuse2, gvfs, gvfs-smb
실행:
chmod +x Comicviewer-0.1.0-x86_64.AppImage
./Comicviewer-0.1.0-x86_64.AppImage
권장 설치 또는 업데이트:
tar -xzf Comicviewer-0.1.0-x86_64.tar.gz
cd Comicviewer-0.1.0-x86_64
./install-or-update.sh
```
사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다.