Add AppImage installation and release guides
This commit is contained in:
parent
8d973f77dd
commit
a1b941e8f5
4 changed files with 181 additions and 0 deletions
88
docs/RELEASING.ko.md
Normal file
88
docs/RELEASING.ko.md
Normal file
|
|
@ -0,0 +1,88 @@
|
|||
# AppImage Release 배포 안내
|
||||
|
||||
지인에게 배포할 때는 AppImage를 Git 소스 이력에 추가하지 않고 Git 서버의
|
||||
Release 첨부 파일로 제공하는 방식을 권장합니다. 버전별 바이너리를 커밋하면
|
||||
저장소를 복제할 때 모든 과거 바이너리까지 내려받아 저장소가 빠르게 커집니다.
|
||||
|
||||
기존 `v0.1.0` AppImage 커밋은 배포 기록으로 유지하되, 다음 버전부터는 이
|
||||
절차를 사용합니다.
|
||||
|
||||
## 1. 버전 갱신
|
||||
|
||||
릴리스 전에 다음 위치의 버전이 일치하는지 확인합니다.
|
||||
|
||||
- `Cargo.toml`의 패키지 버전
|
||||
- `data/io.github.comicviewer.Comicviewer.metainfo.xml`의 릴리스 버전과 날짜
|
||||
- `packaging/build-appimage.sh`의 출력 파일 버전
|
||||
|
||||
## 2. 품질 검사
|
||||
|
||||
```sh
|
||||
cargo fmt --check
|
||||
cargo clippy --all-targets --all-features -- -D warnings
|
||||
cargo test --all-features
|
||||
```
|
||||
|
||||
모든 검사를 통과한 소스에서 AppImage를 빌드합니다.
|
||||
|
||||
## 3. AppImage 빌드
|
||||
|
||||
`linuxdeploy-x86_64.AppImage`와 `linuxdeploy-plugin-gtk.sh`가 있는 도구
|
||||
폴더를 지정합니다.
|
||||
|
||||
```sh
|
||||
PATH="/path/to/appimage-tools:$PATH" \
|
||||
LINUXDEPLOY="/path/to/appimage-tools/linuxdeploy-x86_64.AppImage" \
|
||||
./packaging/build-appimage.sh
|
||||
```
|
||||
|
||||
완성된 AppImage는 `dist/`에 생성됩니다. 배포 전에 직접 실행해 기본 화면이
|
||||
열리는지 확인합니다.
|
||||
|
||||
## 4. 체크섬 생성
|
||||
|
||||
아래 예시의 버전은 실제 릴리스 버전으로 변경합니다.
|
||||
|
||||
```sh
|
||||
version=0.1.0
|
||||
cd dist
|
||||
sha256sum "Comicviewer-${version}-x86_64.AppImage" \
|
||||
> "Comicviewer-${version}-x86_64.AppImage.sha256"
|
||||
```
|
||||
|
||||
## 5. 소스 커밋과 태그
|
||||
|
||||
버전 변경과 문서를 커밋한 뒤 주석 태그를 생성하고 푸시합니다. AppImage 자체는
|
||||
`git add -f`로 추가하지 않습니다.
|
||||
|
||||
```sh
|
||||
git add Cargo.toml Cargo.lock data packaging README.md docs
|
||||
git commit -m "Prepare v0.1.0 release"
|
||||
git tag -a v0.1.0 -m "Comicviewer v0.1.0"
|
||||
git push origin main
|
||||
git push origin v0.1.0
|
||||
```
|
||||
|
||||
이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새
|
||||
패치 버전을 만듭니다.
|
||||
|
||||
## 6. Git 서버 Release 생성
|
||||
|
||||
Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음
|
||||
파일을 첨부합니다.
|
||||
|
||||
- `Comicviewer-0.1.0-x86_64.AppImage`
|
||||
- `Comicviewer-0.1.0-x86_64.AppImage.sha256`
|
||||
|
||||
Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안내합니다.
|
||||
|
||||
```text
|
||||
지원 환경: 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
|
||||
```
|
||||
|
||||
사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다.
|
||||
Loading…
Add table
Add a link
Reference in a new issue