Prepare v0.1.3 AppImage fix
This commit is contained in:
parent
42b8a5b487
commit
41fc737e71
9 changed files with 87 additions and 154 deletions
|
|
@ -8,33 +8,31 @@ Comicviewer는 CachyOS와 Arch Linux에서 사용할 수 있는 만화 ZIP 뷰
|
|||
AppImage 실행과 원격 파일 접근에 필요한 패키지를 설치합니다.
|
||||
|
||||
```sh
|
||||
sudo pacman -S fuse2 gvfs gvfs-smb
|
||||
sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb
|
||||
```
|
||||
|
||||
- `fuse2`: AppImage 마운트 및 실행
|
||||
- `gtk4`, `dav1d`: 화면 표시와 이미지 디코딩
|
||||
- `gvfs`: FTP와 SFTP 접근
|
||||
- `gvfs-smb`: SMB 공유 접근
|
||||
|
||||
## 2. 권장 방법: 통합 번들로 설치 또는 업데이트
|
||||
|
||||
Release 페이지에서 `v0.1.2` 최신 Release를 열고 다음 파일을 모두 같은 폴더에
|
||||
다운로드합니다. 이 Git 서버에서는 대용량 파일 전송이 손상될 수 있어 통합
|
||||
번들을 8MiB 단위로 나누어 제공합니다.
|
||||
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
|
||||
|
||||
- `Comicviewer-0.1.2-x86_64-install.sh`
|
||||
- `Comicviewer-0.1.2-x86_64.tar.gz.sha256`
|
||||
- `Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256`
|
||||
- 이름이 `Comicviewer-0.1.2-x86_64.tar.gz.part-`로 시작하는 모든 파일
|
||||
- `Comicviewer-0.1.3-x86_64.tar.gz`
|
||||
- `Comicviewer-0.1.3-x86_64.tar.gz.sha256`
|
||||
|
||||
다운로드 폴더에서 설치 스크립트에 실행 권한을 부여하고 실행합니다.
|
||||
체크섬을 확인하고 압축을 푼 뒤 설치 스크립트를 실행합니다.
|
||||
|
||||
```sh
|
||||
chmod +x Comicviewer-0.1.2-x86_64-install.sh
|
||||
./Comicviewer-0.1.2-x86_64-install.sh
|
||||
sha256sum -c Comicviewer-0.1.3-x86_64.tar.gz.sha256
|
||||
tar -xzf Comicviewer-0.1.3-x86_64.tar.gz
|
||||
cd Comicviewer-0.1.3-x86_64
|
||||
./install-or-update.sh
|
||||
```
|
||||
|
||||
스크립트는 각 분할 파일과 조립한 통합 번들, AppImage의 체크섬을 차례로
|
||||
검증하고 다음 작업을 수행합니다.
|
||||
스크립트는 AppImage 체크섬을 검증하고 다음 작업을 수행합니다.
|
||||
|
||||
- AppImage를 `~/.local/opt/comicviewer/Comicviewer.AppImage`에 설치
|
||||
- `~/.local/bin/comicviewer` 실행 링크 생성
|
||||
|
|
@ -47,7 +45,7 @@ chmod +x Comicviewer-0.1.2-x86_64-install.sh
|
|||
제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다.
|
||||
|
||||
```sh
|
||||
./Comicviewer-0.1.2-x86_64-install.sh --uninstall
|
||||
./install-or-update.sh --uninstall
|
||||
```
|
||||
|
||||
이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를
|
||||
|
|
@ -58,13 +56,13 @@ chmod +x Comicviewer-0.1.2-x86_64-install.sh
|
|||
|
||||
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
|
||||
|
||||
- `Comicviewer-0.1.2-x86_64.AppImage`
|
||||
- `Comicviewer-0.1.2-x86_64.AppImage.sha256`
|
||||
- `Comicviewer-0.1.3-x86_64.AppImage`
|
||||
- `Comicviewer-0.1.3-x86_64.AppImage.sha256`
|
||||
|
||||
다운로드한 폴더에서 체크섬을 검증합니다.
|
||||
|
||||
```sh
|
||||
sha256sum -c Comicviewer-0.1.2-x86_64.AppImage.sha256
|
||||
sha256sum -c Comicviewer-0.1.3-x86_64.AppImage.sha256
|
||||
```
|
||||
|
||||
`성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고
|
||||
|
|
@ -75,15 +73,15 @@ sha256sum -c Comicviewer-0.1.2-x86_64.AppImage.sha256
|
|||
AppImage에 실행 권한을 부여한 뒤 실행합니다.
|
||||
|
||||
```sh
|
||||
chmod +x Comicviewer-0.1.2-x86_64.AppImage
|
||||
./Comicviewer-0.1.2-x86_64.AppImage
|
||||
chmod +x Comicviewer-0.1.3-x86_64.AppImage
|
||||
./Comicviewer-0.1.3-x86_64.AppImage
|
||||
```
|
||||
|
||||
FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수
|
||||
있습니다.
|
||||
|
||||
```sh
|
||||
./Comicviewer-0.1.2-x86_64.AppImage --appimage-extract-and-run
|
||||
./Comicviewer-0.1.3-x86_64.AppImage --appimage-extract-and-run
|
||||
```
|
||||
|
||||
## 5. 선택 사항: 수동으로 사용자 계정에 설치
|
||||
|
|
@ -93,7 +91,7 @@ AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로
|
|||
|
||||
```sh
|
||||
mkdir -p ~/.local/opt/comicviewer ~/.local/bin
|
||||
install -m 755 Comicviewer-0.1.2-x86_64.AppImage \
|
||||
install -m 755 Comicviewer-0.1.3-x86_64.AppImage \
|
||||
~/.local/opt/comicviewer/Comicviewer.AppImage
|
||||
ln -sfn ~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/bin/comicviewer
|
||||
```
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ Release 첨부 파일로 제공하는 방식을 권장합니다. 버전별 바
|
|||
절차를 사용합니다.
|
||||
|
||||
태그, 프로젝트 버전, AppImage, 통합 번들의 버전은 반드시 같아야 합니다.
|
||||
예를 들어 `v0.1.2` Release에는 이름에 `0.1.2`가 포함된 파일만 첨부합니다.
|
||||
예를 들어 `v0.1.3` Release에는 이름에 `0.1.3`이 포함된 파일만 첨부합니다.
|
||||
Git 태그만 푸시하면 첨부 파일은 자동으로 등록되지 않으므로, 마지막 단계에서
|
||||
Release를 만들고 파일 네 개를 직접 첨부해야 합니다.
|
||||
|
||||
|
|
@ -32,8 +32,9 @@ cargo test --all-features
|
|||
|
||||
## 3. AppImage 빌드
|
||||
|
||||
`linuxdeploy-x86_64.AppImage`와 `linuxdeploy-plugin-gtk.sh`가 있는 도구
|
||||
폴더를 지정합니다.
|
||||
`appimagetool`을 직접 지정하거나, appimagetool을 포함한
|
||||
`linuxdeploy-x86_64.AppImage`를 지정합니다. AppImage는 Arch/CachyOS 호스트의
|
||||
GTK4와 dav1d를 사용하며 시스템 라이브러리를 내부에 복사하지 않습니다.
|
||||
|
||||
```sh
|
||||
PATH="/path/to/appimage-tools:$PATH" \
|
||||
|
|
@ -55,12 +56,9 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
|
|||
|
||||
스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다.
|
||||
|
||||
- `dist/Comicviewer-0.1.2-x86_64.AppImage.sha256`
|
||||
- `dist/Comicviewer-0.1.2-x86_64.tar.gz`
|
||||
- `dist/Comicviewer-0.1.2-x86_64.tar.gz.sha256`
|
||||
- `dist/Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256`
|
||||
- `dist/Comicviewer-0.1.2-x86_64.tar.gz.part-*`
|
||||
- `dist/Comicviewer-0.1.2-x86_64-install.sh`
|
||||
- `dist/Comicviewer-0.1.3-x86_64.AppImage.sha256`
|
||||
- `dist/Comicviewer-0.1.3-x86_64.tar.gz`
|
||||
- `dist/Comicviewer-0.1.3-x86_64.tar.gz.sha256`
|
||||
|
||||
통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘,
|
||||
한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를
|
||||
|
|
@ -69,10 +67,9 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
|
|||
생성된 번들의 압축 목록과 체크섬을 확인합니다.
|
||||
|
||||
```sh
|
||||
tar -tzf dist/Comicviewer-0.1.2-x86_64.tar.gz
|
||||
tar -tzf dist/Comicviewer-0.1.3-x86_64.tar.gz
|
||||
cd dist
|
||||
sha256sum -c Comicviewer-0.1.2-x86_64.tar.gz.sha256
|
||||
sha256sum -c Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256
|
||||
sha256sum -c Comicviewer-0.1.3-x86_64.tar.gz.sha256
|
||||
```
|
||||
|
||||
## 5. 소스 커밋과 태그
|
||||
|
|
@ -82,10 +79,10 @@ sha256sum -c Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256
|
|||
|
||||
```sh
|
||||
git add Cargo.toml Cargo.lock data packaging README.md docs
|
||||
git commit -m "Prepare v0.1.2 release"
|
||||
git tag -a v0.1.2 -m "Comicviewer v0.1.2"
|
||||
git commit -m "Prepare v0.1.3 release"
|
||||
git tag -a v0.1.3 -m "Comicviewer v0.1.3"
|
||||
git push origin main
|
||||
git push origin v0.1.2
|
||||
git push origin v0.1.3
|
||||
```
|
||||
|
||||
이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새
|
||||
|
|
@ -96,25 +93,26 @@ git push origin v0.1.2
|
|||
Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음
|
||||
파일을 첨부합니다.
|
||||
|
||||
- `Comicviewer-0.1.2-x86_64-install.sh`
|
||||
- `Comicviewer-0.1.2-x86_64.tar.gz.sha256`
|
||||
- `Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256`
|
||||
- `Comicviewer-0.1.2-x86_64.tar.gz.part-*` 전체
|
||||
- `Comicviewer-0.1.3-x86_64.tar.gz`
|
||||
- `Comicviewer-0.1.3-x86_64.tar.gz.sha256`
|
||||
- `Comicviewer-0.1.3-x86_64.AppImage`
|
||||
- `Comicviewer-0.1.3-x86_64.AppImage.sha256`
|
||||
|
||||
이 서버에서는 대용량 단일 HTTP 다운로드가 손상될 수 있으므로 AppImage와
|
||||
통합 `tar.gz` 원본은 직접 첨부하지 않습니다. 각 분할 파일은 8MiB 이하이며,
|
||||
업로드 후 반드시 원격에서 다시 내려받아 체크섬을 확인합니다.
|
||||
호스트 라이브러리형 AppImage는 크기가 작지만, 업로드 후에도 반드시 원격에서
|
||||
다시 내려받아 체크섬과 실제 실행을 확인합니다.
|
||||
|
||||
Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안내합니다.
|
||||
|
||||
```text
|
||||
지원 환경: CachyOS / Arch Linux x86_64
|
||||
필수 패키지: fuse2, gvfs, gvfs-smb
|
||||
필수 패키지: fuse2, gtk4, dav1d, gvfs, gvfs-smb
|
||||
|
||||
권장 설치 또는 업데이트:
|
||||
첨부 파일을 모두 같은 폴더에 다운로드한 뒤 실행합니다.
|
||||
chmod +x Comicviewer-0.1.2-x86_64-install.sh
|
||||
./Comicviewer-0.1.2-x86_64-install.sh
|
||||
tar.gz와 tar.gz.sha256을 같은 폴더에 다운로드한 뒤 실행합니다.
|
||||
sha256sum -c Comicviewer-0.1.3-x86_64.tar.gz.sha256
|
||||
tar -xzf Comicviewer-0.1.3-x86_64.tar.gz
|
||||
cd Comicviewer-0.1.3-x86_64
|
||||
./install-or-update.sh
|
||||
```
|
||||
|
||||
사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue