Prepare v0.1.2 split release

This commit is contained in:
burnintuna 2026-07-21 03:22:32 +09:00
parent cf23da4875
commit 44483316ad
8 changed files with 131 additions and 32 deletions

3
.gitignore vendored
View file

@ -6,3 +6,6 @@
/dist/*.AppImage.sha256 /dist/*.AppImage.sha256
/dist/*.tar.gz /dist/*.tar.gz
/dist/*.tar.gz.sha256 /dist/*.tar.gz.sha256
/dist/*.tar.gz.part-*
/dist/*.tar.gz.parts.sha256
/dist/*-install.sh

2
Cargo.lock generated
View file

@ -182,7 +182,7 @@ checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b"
[[package]] [[package]]
name = "comicviewer" name = "comicviewer"
version = "0.1.1" version = "0.1.2"
dependencies = [ dependencies = [
"anyhow", "anyhow",
"chrono", "chrono",

View file

@ -1,6 +1,6 @@
[package] [package]
name = "comicviewer" name = "comicviewer"
version = "0.1.1" version = "0.1.2"
edition = "2024" edition = "2024"
description = "A comic archive viewer for local and remote locations" description = "A comic archive viewer for local and remote locations"
license = "GPL-3.0-or-later" license = "GPL-3.0-or-later"

View file

@ -26,6 +26,7 @@
</provides> </provides>
<content_rating type="oars-1.1" /> <content_rating type="oars-1.1" />
<releases> <releases>
<release version="0.1.2" date="2026-07-21" />
<release version="0.1.1" date="2026-07-21" /> <release version="0.1.1" date="2026-07-21" />
<release version="0.1.0" date="2026-07-21" /> <release version="0.1.0" date="2026-07-21" />
</releases> </releases>

View file

@ -17,16 +17,24 @@ sudo pacman -S fuse2 gvfs gvfs-smb
## 2. 권장 방법: 통합 번들로 설치 또는 업데이트 ## 2. 권장 방법: 통합 번들로 설치 또는 업데이트
Release 페이지에서 `Comicviewer-0.1.1-x86_64.tar.gz`와 같은 최신 버전의 Release 페이지에서 `v0.1.2` 최신 Release를 열고 다음 파일을 모두 같은 폴더에
통합 번들을 다운로드합니다. 압축을 풀고 설치 스크립트를 실행합니다. 다운로드합니다. 이 Git 서버에서는 대용량 파일 전송이 손상될 수 있어 통합
번들을 8MiB 단위로 나누어 제공합니다.
- `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-`로 시작하는 모든 파일
다운로드 폴더에서 설치 스크립트에 실행 권한을 부여하고 실행합니다.
```sh ```sh
tar -xzf Comicviewer-0.1.1-x86_64.tar.gz chmod +x Comicviewer-0.1.2-x86_64-install.sh
cd Comicviewer-0.1.1-x86_64 ./Comicviewer-0.1.2-x86_64-install.sh
./install-or-update.sh
``` ```
스크립트는 AppImage 체크섬을 검증하고 다음 작업을 수행합니다. 스크립트는 각 분할 파일과 조립한 통합 번들, AppImage의 체크섬을 차례로
검증하고 다음 작업을 수행합니다.
- AppImage를 `~/.local/opt/comicviewer/Comicviewer.AppImage`에 설치 - AppImage를 `~/.local/opt/comicviewer/Comicviewer.AppImage`에 설치
- `~/.local/bin/comicviewer` 실행 링크 생성 - `~/.local/bin/comicviewer` 실행 링크 생성
@ -39,7 +47,7 @@ cd Comicviewer-0.1.1-x86_64
제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다. 제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다.
```sh ```sh
./install-or-update.sh --uninstall ./Comicviewer-0.1.2-x86_64-install.sh --uninstall
``` ```
이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를 이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를
@ -50,13 +58,13 @@ cd Comicviewer-0.1.1-x86_64
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다. Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
- `Comicviewer-0.1.1-x86_64.AppImage` - `Comicviewer-0.1.2-x86_64.AppImage`
- `Comicviewer-0.1.1-x86_64.AppImage.sha256` - `Comicviewer-0.1.2-x86_64.AppImage.sha256`
다운로드한 폴더에서 체크섬을 검증합니다. 다운로드한 폴더에서 체크섬을 검증합니다.
```sh ```sh
sha256sum -c Comicviewer-0.1.1-x86_64.AppImage.sha256 sha256sum -c Comicviewer-0.1.2-x86_64.AppImage.sha256
``` ```
`성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고 `성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고
@ -67,15 +75,15 @@ sha256sum -c Comicviewer-0.1.1-x86_64.AppImage.sha256
AppImage에 실행 권한을 부여한 뒤 실행합니다. AppImage에 실행 권한을 부여한 뒤 실행합니다.
```sh ```sh
chmod +x Comicviewer-0.1.1-x86_64.AppImage chmod +x Comicviewer-0.1.2-x86_64.AppImage
./Comicviewer-0.1.1-x86_64.AppImage ./Comicviewer-0.1.2-x86_64.AppImage
``` ```
FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수 FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수
있습니다. 있습니다.
```sh ```sh
./Comicviewer-0.1.1-x86_64.AppImage --appimage-extract-and-run ./Comicviewer-0.1.2-x86_64.AppImage --appimage-extract-and-run
``` ```
## 5. 선택 사항: 수동으로 사용자 계정에 설치 ## 5. 선택 사항: 수동으로 사용자 계정에 설치
@ -85,7 +93,7 @@ AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로
```sh ```sh
mkdir -p ~/.local/opt/comicviewer ~/.local/bin mkdir -p ~/.local/opt/comicviewer ~/.local/bin
install -m 755 Comicviewer-0.1.1-x86_64.AppImage \ install -m 755 Comicviewer-0.1.2-x86_64.AppImage \
~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/opt/comicviewer/Comicviewer.AppImage
ln -sfn ~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/bin/comicviewer ln -sfn ~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/bin/comicviewer
``` ```

View file

@ -8,7 +8,7 @@ Release 첨부 파일로 제공하는 방식을 권장합니다. 버전별 바
절차를 사용합니다. 절차를 사용합니다.
태그, 프로젝트 버전, AppImage, 통합 번들의 버전은 반드시 같아야 합니다. 태그, 프로젝트 버전, AppImage, 통합 번들의 버전은 반드시 같아야 합니다.
예를 들어 `v0.1.1` Release에는 이름에 `0.1.1`이 포함된 파일만 첨부합니다. 예를 들어 `v0.1.2` Release에는 이름에 `0.1.2`가 포함된 파일만 첨부합니다.
Git 태그만 푸시하면 첨부 파일은 자동으로 등록되지 않으므로, 마지막 단계에서 Git 태그만 푸시하면 첨부 파일은 자동으로 등록되지 않으므로, 마지막 단계에서
Release를 만들고 파일 네 개를 직접 첨부해야 합니다. Release를 만들고 파일 네 개를 직접 첨부해야 합니다.
@ -55,9 +55,12 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다. 스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다.
- `dist/Comicviewer-0.1.1-x86_64.AppImage.sha256` - `dist/Comicviewer-0.1.2-x86_64.AppImage.sha256`
- `dist/Comicviewer-0.1.1-x86_64.tar.gz` - `dist/Comicviewer-0.1.2-x86_64.tar.gz`
- `dist/Comicviewer-0.1.1-x86_64.tar.gz.sha256` - `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`
통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘, 통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘,
한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를 한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를
@ -66,9 +69,10 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
생성된 번들의 압축 목록과 체크섬을 확인합니다. 생성된 번들의 압축 목록과 체크섬을 확인합니다.
```sh ```sh
tar -tzf dist/Comicviewer-0.1.1-x86_64.tar.gz tar -tzf dist/Comicviewer-0.1.2-x86_64.tar.gz
cd dist cd dist
sha256sum -c Comicviewer-0.1.1-x86_64.tar.gz.sha256 sha256sum -c Comicviewer-0.1.2-x86_64.tar.gz.sha256
sha256sum -c Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256
``` ```
## 5. 소스 커밋과 태그 ## 5. 소스 커밋과 태그
@ -78,10 +82,10 @@ sha256sum -c Comicviewer-0.1.1-x86_64.tar.gz.sha256
```sh ```sh
git add Cargo.toml Cargo.lock data packaging README.md docs git add Cargo.toml Cargo.lock data packaging README.md docs
git commit -m "Prepare v0.1.1 release" git commit -m "Prepare v0.1.2 release"
git tag -a v0.1.1 -m "Comicviewer v0.1.1" git tag -a v0.1.2 -m "Comicviewer v0.1.2"
git push origin main git push origin main
git push origin v0.1.1 git push origin v0.1.2
``` ```
이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새 이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새
@ -92,10 +96,14 @@ git push origin v0.1.1
Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음 Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음
파일을 첨부합니다. 파일을 첨부합니다.
- `Comicviewer-0.1.1-x86_64.tar.gz` - `Comicviewer-0.1.2-x86_64-install.sh`
- `Comicviewer-0.1.1-x86_64.tar.gz.sha256` - `Comicviewer-0.1.2-x86_64.tar.gz.sha256`
- `Comicviewer-0.1.1-x86_64.AppImage` - `Comicviewer-0.1.2-x86_64.tar.gz.parts.sha256`
- `Comicviewer-0.1.1-x86_64.AppImage.sha256` - `Comicviewer-0.1.2-x86_64.tar.gz.part-*` 전체
이 서버에서는 대용량 단일 HTTP 다운로드가 손상될 수 있으므로 AppImage와
통합 `tar.gz` 원본은 직접 첨부하지 않습니다. 각 분할 파일은 8MiB 이하이며,
업로드 후 반드시 원격에서 다시 내려받아 체크섬을 확인합니다.
Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안내합니다. Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안내합니다.
@ -104,9 +112,9 @@ Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안
필수 패키지: fuse2, gvfs, gvfs-smb 필수 패키지: fuse2, gvfs, gvfs-smb
권장 설치 또는 업데이트: 권장 설치 또는 업데이트:
tar -xzf Comicviewer-0.1.1-x86_64.tar.gz 첨부 파일을 모두 같은 폴더에 다운로드한 뒤 실행합니다.
cd Comicviewer-0.1.1-x86_64 chmod +x Comicviewer-0.1.2-x86_64-install.sh
./install-or-update.sh ./Comicviewer-0.1.2-x86_64-install.sh
``` ```
사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다. 사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다.

View file

@ -10,6 +10,8 @@ appimage="${root_dir}/dist/${appimage_name}"
checksum="${appimage}.sha256" checksum="${appimage}.sha256"
archive="${root_dir}/dist/${bundle_name}.tar.gz" archive="${root_dir}/dist/${bundle_name}.tar.gz"
archive_checksum="${archive}.sha256" archive_checksum="${archive}.sha256"
parts_checksum="${archive}.parts.sha256"
split_installer="${root_dir}/dist/${bundle_name}-install.sh"
work_dir="$(mktemp -d)" work_dir="$(mktemp -d)"
bundle_dir="${work_dir}/${bundle_name}" bundle_dir="${work_dir}/${bundle_name}"
archive_mtime="${SOURCE_DATE_EPOCH:-$(git -C "${root_dir}" log -1 --format=%ct)}" archive_mtime="${SOURCE_DATE_EPOCH:-$(git -C "${root_dir}" log -1 --format=%ct)}"
@ -49,7 +51,14 @@ tar --sort=name --owner=0 --group=0 --numeric-owner --mtime="@${archive_mtime}"
( (
cd "${root_dir}/dist" cd "${root_dir}/dist"
sha256sum "$(basename "${archive}")" > "$(basename "${archive_checksum}")" sha256sum "$(basename "${archive}")" > "$(basename "${archive_checksum}")"
rm -f "$(basename "${archive}").part-"* "$(basename "${parts_checksum}")"
split --bytes=8M --numeric-suffixes=0 --suffix-length=2 \
"$(basename "${archive}")" "$(basename "${archive}").part-"
sha256sum "$(basename "${archive}").part-"* > "$(basename "${parts_checksum}")"
) )
install -m 0755 "${root_dir}/packaging/install-split-release.sh" "${split_installer}"
printf 'Created %s\n' "${archive}" printf 'Created %s\n' "${archive}"
printf 'Created %s\n' "${archive_checksum}" printf 'Created %s\n' "${archive_checksum}"
printf 'Created %s and split parts\n' "${parts_checksum}"
printf 'Created %s\n' "${split_installer}"

View file

@ -0,0 +1,70 @@
#!/usr/bin/env sh
set -eu
script_dir="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
temporary_archive=""
extract_dir=""
case "$#:${1:-}" in
0:) action="" ;;
1:--uninstall) action="--uninstall" ;;
*)
printf '사용법: %s [--uninstall]\n' "$(basename -- "$0")" >&2
exit 2
;;
esac
cleanup() {
[ -z "${temporary_archive}" ] || rm -f "${temporary_archive}"
[ -z "${extract_dir}" ] || rm -rf "${extract_dir}"
}
trap cleanup EXIT HUP INT TERM
set -- "${script_dir}"/Comicviewer-*-x86_64.tar.gz.parts.sha256
if [ "$#" -ne 1 ] || [ ! -f "$1" ]; then
printf '%s\n' "분할 파일 체크섬 목록 한 개를 찾을 수 없습니다." >&2
exit 1
fi
parts_checksum="$1"
archive_name="$(basename -- "${parts_checksum%.parts.sha256}")"
archive_checksum="${script_dir}/${archive_name}.sha256"
if [ ! -f "${archive_checksum}" ]; then
printf '필수 파일이 없습니다: %s\n' "$(basename -- "${archive_checksum}")" >&2
exit 1
fi
set -- "${script_dir}/${archive_name}.part-"*
if [ ! -f "$1" ]; then
printf '%s\n' "분할 번들 파일을 찾을 수 없습니다." >&2
exit 1
fi
(cd "${script_dir}" && sha256sum -c "$(basename -- "${parts_checksum}")")
temporary_archive="$(mktemp "${TMPDIR:-/tmp}/comicviewer-bundle.XXXXXX.tar.gz")"
cat "$@" > "${temporary_archive}"
IFS=' ' read -r expected_checksum _ < "${archive_checksum}"
actual_checksum="$(sha256sum "${temporary_archive}")"
actual_checksum="${actual_checksum%% *}"
if [ "${actual_checksum}" != "${expected_checksum}" ]; then
printf '%s\n' "조립한 통합 번들의 체크섬이 일치하지 않습니다." >&2
exit 1
fi
extract_dir="$(mktemp -d "${TMPDIR:-/tmp}/comicviewer-install.XXXXXX")"
tar -xzf "${temporary_archive}" -C "${extract_dir}"
bundle_dir="${extract_dir}/${archive_name%.tar.gz}"
if [ ! -x "${bundle_dir}/install-or-update.sh" ]; then
printf '%s\n' "통합 번들에서 설치 스크립트를 찾을 수 없습니다." >&2
exit 1
fi
if [ -n "${action}" ]; then
"${bundle_dir}/install-or-update.sh" "${action}"
else
"${bundle_dir}/install-or-update.sh"
fi