diff --git a/Cargo.lock b/Cargo.lock
index e9fcd45..9f5aced 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -182,7 +182,7 @@ checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b"
[[package]]
name = "comicviewer"
-version = "0.1.3"
+version = "0.1.4"
dependencies = [
"anyhow",
"chrono",
diff --git a/Cargo.toml b/Cargo.toml
index fdc6f00..db68113 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "comicviewer"
-version = "0.1.3"
+version = "0.1.4"
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 000e0dc..73db2cf 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 389ae8b..54756d7 100644
--- a/docs/INSTALL.ko.md
+++ b/docs/INSTALL.ko.md
@@ -3,9 +3,10 @@
Comicviewer는 CachyOS와 Arch Linux에서 사용할 수 있는 만화 ZIP 뷰어입니다.
로컬 파일뿐 아니라 SMB, FTP, SFTP 서버의 폴더와 ZIP 파일도 열 수 있습니다.
-## 1. 필수 패키지 설치
+## 1. 필수 패키지
-AppImage 실행과 원격 파일 접근에 필요한 패키지를 설치합니다.
+통합 번들의 설치 스크립트가 다음 필수 패키지 중 누락된 항목을 자동으로
+설치합니다. 설치 과정에서 `sudo` 암호와 pacman 확인을 요청할 수 있습니다.
```sh
sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb
@@ -20,15 +21,15 @@ sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
-- `Comicviewer-0.1.3-x86_64.tar.gz`
-- `Comicviewer-0.1.3-x86_64.tar.gz.sha256`
+- `Comicviewer-0.1.4-x86_64.tar.gz`
+- `Comicviewer-0.1.4-x86_64.tar.gz.sha256`
체크섬을 확인하고 압축을 푼 뒤 설치 스크립트를 실행합니다.
```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
+sha256sum -c Comicviewer-0.1.4-x86_64.tar.gz.sha256
+tar -xzf Comicviewer-0.1.4-x86_64.tar.gz
+cd Comicviewer-0.1.4-x86_64
./install-or-update.sh
```
@@ -56,13 +57,13 @@ cd Comicviewer-0.1.3-x86_64
Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.
-- `Comicviewer-0.1.3-x86_64.AppImage`
-- `Comicviewer-0.1.3-x86_64.AppImage.sha256`
+- `Comicviewer-0.1.4-x86_64.AppImage`
+- `Comicviewer-0.1.4-x86_64.AppImage.sha256`
다운로드한 폴더에서 체크섬을 검증합니다.
```sh
-sha256sum -c Comicviewer-0.1.3-x86_64.AppImage.sha256
+sha256sum -c Comicviewer-0.1.4-x86_64.AppImage.sha256
```
`성공` 또는 `OK`가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고
@@ -73,15 +74,15 @@ sha256sum -c Comicviewer-0.1.3-x86_64.AppImage.sha256
AppImage에 실행 권한을 부여한 뒤 실행합니다.
```sh
-chmod +x Comicviewer-0.1.3-x86_64.AppImage
-./Comicviewer-0.1.3-x86_64.AppImage
+chmod +x Comicviewer-0.1.4-x86_64.AppImage
+./Comicviewer-0.1.4-x86_64.AppImage
```
FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수
있습니다.
```sh
-./Comicviewer-0.1.3-x86_64.AppImage --appimage-extract-and-run
+./Comicviewer-0.1.4-x86_64.AppImage --appimage-extract-and-run
```
## 5. 선택 사항: 수동으로 사용자 계정에 설치
@@ -91,7 +92,7 @@ AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로
```sh
mkdir -p ~/.local/opt/comicviewer ~/.local/bin
-install -m 755 Comicviewer-0.1.3-x86_64.AppImage \
+install -m 755 Comicviewer-0.1.4-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 ab9ff88..fd45977 100644
--- a/docs/RELEASING.ko.md
+++ b/docs/RELEASING.ko.md
@@ -8,7 +8,7 @@ Release 첨부 파일로 제공하는 방식을 권장합니다. 버전별 바
절차를 사용합니다.
태그, 프로젝트 버전, AppImage, 통합 번들의 버전은 반드시 같아야 합니다.
-예를 들어 `v0.1.3` Release에는 이름에 `0.1.3`이 포함된 파일만 첨부합니다.
+예를 들어 `v0.1.4` Release에는 이름에 `0.1.4`가 포함된 파일만 첨부합니다.
Git 태그만 푸시하면 첨부 파일은 자동으로 등록되지 않으므로, 마지막 단계에서
Release를 만들고 파일 네 개를 직접 첨부해야 합니다.
@@ -56,9 +56,9 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
스크립트는 `Cargo.toml`에서 버전을 읽고 다음 파일을 생성합니다.
-- `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`
+- `dist/Comicviewer-0.1.4-x86_64.AppImage.sha256`
+- `dist/Comicviewer-0.1.4-x86_64.tar.gz`
+- `dist/Comicviewer-0.1.4-x86_64.tar.gz.sha256`
통합 번들에는 AppImage, 체크섬, 설치·업데이트 스크립트, 데스크톱 파일, 아이콘,
한국어 설치 안내문이 포함됩니다. `tar.gz`는 실행 권한과 디렉터리 구조를
@@ -67,9 +67,9 @@ AppImage 빌드가 끝나면 다음 스크립트로 체크섬과 통합 `tar.gz`
생성된 번들의 압축 목록과 체크섬을 확인합니다.
```sh
-tar -tzf dist/Comicviewer-0.1.3-x86_64.tar.gz
+tar -tzf dist/Comicviewer-0.1.4-x86_64.tar.gz
cd dist
-sha256sum -c Comicviewer-0.1.3-x86_64.tar.gz.sha256
+sha256sum -c Comicviewer-0.1.4-x86_64.tar.gz.sha256
```
## 5. 소스 커밋과 태그
@@ -79,10 +79,10 @@ sha256sum -c Comicviewer-0.1.3-x86_64.tar.gz.sha256
```sh
git add Cargo.toml Cargo.lock data packaging README.md docs
-git commit -m "Prepare v0.1.3 release"
-git tag -a v0.1.3 -m "Comicviewer v0.1.3"
+git commit -m "Prepare v0.1.4 release"
+git tag -a v0.1.4 -m "Comicviewer v0.1.4"
git push origin main
-git push origin v0.1.3
+git push origin v0.1.4
```
이미 원격에 공개한 태그는 이동하거나 덮어쓰지 않습니다. 수정이 필요하면 새
@@ -93,10 +93,10 @@ git push origin v0.1.3
Git 서버의 Releases 화면에서 푸시한 태그를 선택해 Release를 생성하고 다음
파일을 첨부합니다.
-- `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`
+- `Comicviewer-0.1.4-x86_64.tar.gz`
+- `Comicviewer-0.1.4-x86_64.tar.gz.sha256`
+- `Comicviewer-0.1.4-x86_64.AppImage`
+- `Comicviewer-0.1.4-x86_64.AppImage.sha256`
호스트 라이브러리형 AppImage는 크기가 작지만, 업로드 후에도 반드시 원격에서
다시 내려받아 체크섬과 실제 실행을 확인합니다.
@@ -109,9 +109,9 @@ Release 설명에는 주요 변경 사항과 함께 다음 요구사항을 안
권장 설치 또는 업데이트:
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
+sha256sum -c Comicviewer-0.1.4-x86_64.tar.gz.sha256
+tar -xzf Comicviewer-0.1.4-x86_64.tar.gz
+cd Comicviewer-0.1.4-x86_64
./install-or-update.sh
```
diff --git a/packaging/install-or-update.sh b/packaging/install-or-update.sh
index 83e3215..5941bb3 100755
--- a/packaging/install-or-update.sh
+++ b/packaging/install-or-update.sh
@@ -29,6 +29,37 @@ refresh_desktop() {
fi
}
+install_dependencies() {
+ if [ "${COMICVIEWER_SKIP_DEPENDENCIES:-0}" = "1" ]; then
+ return
+ fi
+ if ! command -v pacman >/dev/null 2>&1; then
+ printf '%s\n' "필수 패키지 자동 설치는 Arch Linux와 CachyOS만 지원합니다." >&2
+ exit 1
+ fi
+
+ set --
+ for package in fuse2 gtk4 dav1d gvfs gvfs-smb; do
+ if ! pacman -Q "${package}" >/dev/null 2>&1; then
+ set -- "$@" "${package}"
+ fi
+ done
+ if [ "$#" -eq 0 ]; then
+ return
+ fi
+
+ printf '필수 패키지를 설치합니다: %s\n' "$*"
+ if [ "$(id -u)" -eq 0 ]; then
+ pacman -S --needed "$@"
+ else
+ if ! command -v sudo >/dev/null 2>&1; then
+ printf '%s\n' "필수 패키지를 설치하려면 sudo가 필요합니다." >&2
+ exit 1
+ fi
+ sudo pacman -S --needed "$@"
+ fi
+}
+
if [ "${1:-}" = "--uninstall" ]; then
rm -f "${launcher}" "${installed_desktop}" "${installed_icon}" \
"${installed_appimage}"
@@ -45,6 +76,8 @@ if [ "$#" -ne 0 ]; then
exit 2
fi
+install_dependencies
+
set -- "${script_dir}"/Comicviewer-*-x86_64.AppImage
if [ "$#" -ne 1 ] || [ ! -f "$1" ]; then
printf '%s\n' "번들에서 Comicviewer AppImage 한 개를 찾을 수 없습니다." >&2