diff --git a/.gitignore b/.gitignore index c3f9fe3..afa6e8e 100644 --- a/.gitignore +++ b/.gitignore @@ -6,3 +6,6 @@ /dist/*.AppImage.sha256 /dist/*.tar.gz /dist/*.tar.gz.sha256 +/dist/*.tar.gz.part-* +/dist/*.tar.gz.parts.sha256 +/dist/*-install.sh diff --git a/Cargo.lock b/Cargo.lock index 9f442c3..d073622 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -182,7 +182,7 @@ checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b" [[package]] name = "comicviewer" -version = "0.1.1" +version = "0.1.2" dependencies = [ "anyhow", "chrono", diff --git a/Cargo.toml b/Cargo.toml index 0605d41..c1e03b1 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "comicviewer" -version = "0.1.1" +version = "0.1.2" edition = "2024" description = "A comic archive viewer for local and remote locations" license = "GPL-3.0-or-later" diff --git a/data/io.github.comicviewer.Comicviewer.metainfo.xml b/data/io.github.comicviewer.Comicviewer.metainfo.xml index ed46230..3bf3ee3 100644 --- a/data/io.github.comicviewer.Comicviewer.metainfo.xml +++ b/data/io.github.comicviewer.Comicviewer.metainfo.xml @@ -26,6 +26,7 @@ + diff --git a/docs/INSTALL.ko.md b/docs/INSTALL.ko.md index 1481b47..6c5c840 100644 --- a/docs/INSTALL.ko.md +++ b/docs/INSTALL.ko.md @@ -17,16 +17,24 @@ sudo pacman -S fuse2 gvfs gvfs-smb ## 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 -tar -xzf Comicviewer-0.1.1-x86_64.tar.gz -cd Comicviewer-0.1.1-x86_64 -./install-or-update.sh +chmod +x Comicviewer-0.1.2-x86_64-install.sh +./Comicviewer-0.1.2-x86_64-install.sh ``` -스크립트는 AppImage 체크섬을 검증하고 다음 작업을 수행합니다. +스크립트는 각 분할 파일과 조립한 통합 번들, AppImage의 체크섬을 차례로 +검증하고 다음 작업을 수행합니다. - AppImage를 `~/.local/opt/comicviewer/Comicviewer.AppImage`에 설치 - `~/.local/bin/comicviewer` 실행 링크 생성 @@ -39,7 +47,7 @@ cd Comicviewer-0.1.1-x86_64 제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다. ```sh -./install-or-update.sh --uninstall +./Comicviewer-0.1.2-x86_64-install.sh --uninstall ``` 이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를 @@ -50,13 +58,13 @@ cd Comicviewer-0.1.1-x86_64 Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다. -- `Comicviewer-0.1.1-x86_64.AppImage` -- `Comicviewer-0.1.1-x86_64.AppImage.sha256` +- `Comicviewer-0.1.2-x86_64.AppImage` +- `Comicviewer-0.1.2-x86_64.AppImage.sha256` 다운로드한 폴더에서 체크섬을 검증합니다. ```sh -sha256sum -c Comicviewer-0.1.1-x86_64.AppImage.sha256 +sha256sum -c Comicviewer-0.1.2-x86_64.AppImage.sha256 ``` `성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고 @@ -67,15 +75,15 @@ sha256sum -c Comicviewer-0.1.1-x86_64.AppImage.sha256 AppImage에 실행 권한을 부여한 뒤 실행합니다. ```sh -chmod +x Comicviewer-0.1.1-x86_64.AppImage -./Comicviewer-0.1.1-x86_64.AppImage +chmod +x Comicviewer-0.1.2-x86_64.AppImage +./Comicviewer-0.1.2-x86_64.AppImage ``` FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수 있습니다. ```sh -./Comicviewer-0.1.1-x86_64.AppImage --appimage-extract-and-run +./Comicviewer-0.1.2-x86_64.AppImage --appimage-extract-and-run ``` ## 5. 선택 사항: 수동으로 사용자 계정에 설치 @@ -85,7 +93,7 @@ AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로 ```sh 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 ln -sfn ~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/bin/comicviewer ``` diff --git a/docs/RELEASING.ko.md b/docs/RELEASING.ko.md index ed50b13..46698cd 100644 --- a/docs/RELEASING.ko.md +++ b/docs/RELEASING.ko.md @@ -8,7 +8,7 @@ Release 첨부 파일로 제공하는 방식을 권장합니다. 버전별 바 절차를 사용합니다. 태그, 프로젝트 버전, AppImage, 통합 번들의 버전은 반드시 같아야 합니다. -예를 들어 `v0.1.1` Release에는 이름에 `0.1.1`이 포함된 파일만 첨부합니다. +예를 들어 `v0.1.2` Release에는 이름에 `0.1.2`가 포함된 파일만 첨부합니다. Git 태그만 푸시하면 첨부 파일은 자동으로 등록되지 않으므로, 마지막 단계에서 Release를 만들고 파일 네 개를 직접 첨부해야 합니다. @@ -55,9 +55,12 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz` 스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다. -- `dist/Comicviewer-0.1.1-x86_64.AppImage.sha256` -- `dist/Comicviewer-0.1.1-x86_64.tar.gz` -- `dist/Comicviewer-0.1.1-x86_64.tar.gz.sha256` +- `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` 통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘, 한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를 @@ -66,9 +69,10 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz` 생성된 번들의 압축 목록과 체크섬을 확인합니다. ```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 -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. 소스 커밋과 태그 @@ -78,10 +82,10 @@ sha256sum -c Comicviewer-0.1.1-x86_64.tar.gz.sha256 ```sh git add Cargo.toml Cargo.lock data packaging README.md docs -git commit -m "Prepare v0.1.1 release" -git tag -a v0.1.1 -m "Comicviewer v0.1.1" +git commit -m "Prepare v0.1.2 release" +git tag -a v0.1.2 -m "Comicviewer v0.1.2" 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를 생성하고 다음 파일을 첨부합니다. -- `Comicviewer-0.1.1-x86_64.tar.gz` -- `Comicviewer-0.1.1-x86_64.tar.gz.sha256` -- `Comicviewer-0.1.1-x86_64.AppImage` -- `Comicviewer-0.1.1-x86_64.AppImage.sha256` +- `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-*` 전체 + +이 서버에서는 대용량 단일 HTTP 다운로드가 손상될 수 있으므로 AppImage와 +통합 `tar.gz` 원본은 직접 첨부하지 않습니다. 각 분할 파일은 8MiB 이하이며, +업로드 후 반드시 원격에서 다시 내려받아 체크섬을 확인합니다. Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안내합니다. @@ -104,9 +112,9 @@ Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안 필수 패키지: fuse2, gvfs, gvfs-smb 권장 설치 또는 업데이트: -tar -xzf Comicviewer-0.1.1-x86_64.tar.gz -cd Comicviewer-0.1.1-x86_64 -./install-or-update.sh +첨부 파일을 모두 같은 폴더에 다운로드한 뒤 실행합니다. +chmod +x Comicviewer-0.1.2-x86_64-install.sh +./Comicviewer-0.1.2-x86_64-install.sh ``` 사용자에게는 [`INSTALL.ko.md`](INSTALL.ko.md) 문서를 함께 안내합니다. diff --git a/packaging/build-release-bundle.sh b/packaging/build-release-bundle.sh index 39b44bd..b676a1a 100755 --- a/packaging/build-release-bundle.sh +++ b/packaging/build-release-bundle.sh @@ -10,6 +10,8 @@ appimage="${root_dir}/dist/${appimage_name}" checksum="${appimage}.sha256" archive="${root_dir}/dist/${bundle_name}.tar.gz" archive_checksum="${archive}.sha256" +parts_checksum="${archive}.parts.sha256" +split_installer="${root_dir}/dist/${bundle_name}-install.sh" work_dir="$(mktemp -d)" bundle_dir="${work_dir}/${bundle_name}" 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" 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_checksum}" +printf 'Created %s and split parts\n' "${parts_checksum}" +printf 'Created %s\n' "${split_installer}" diff --git a/packaging/install-split-release.sh b/packaging/install-split-release.sh new file mode 100755 index 0000000..88fe2c6 --- /dev/null +++ b/packaging/install-split-release.sh @@ -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