Skip to content

Building from source

mrrizkin edited this page Oct 15, 2026 · 1 revision

Building from source

Prasyarat

  • Qt 6.5 LTS atau lebih baru: Quick, QuickControls2, Sql, Concurrent
  • CMake ≥ 3.21, compiler C++20, Ninja, SQLite3

Opsional, tapi memengaruhi fitur

Paket Untuk apa Kalau tidak ada
qt6-imageformats WebP, TIFF, TGA, WBMP, ICNS Berkasnya tetap terindeks, thumbnail & viewer tampil placeholder
qt6-svg-plugins ikon SVG dari tema desktop Ikon jatuh ke glif teks
mpv + mpvqt pemutaran video via libmpv Build memakai Qt Multimedia (FFmpeg)
ffmpeg (libavformat/libavcodec/libswscale) poster frame video Tanpa poster, tapi tetap bisa diputar
ONNX Runtime grouping wajah (People) Halaman People hanya menjelaskan backend tidak ada

Di Arch/Artix:

sudo pacman -S --needed qt6-base qt6-declarative qt6-multimedia qt6-imageformats \
    cmake ninja gcc sqlite ffmpeg mpv mpvqt

Catatan: libmpv disediakan oleh paket mpv — tidak ada paket terpisah bernama libmpv di Arch. Di Debian, mpvqt dipaketkan sebagai libmpvqt-dev + libmpv-dev.

Build:

cmake -S . -B build -G Ninja
cmake --build build
./build/kin-galeri

Opsi CMake

Opsi Default Efek
KG_VIDEO_BACKEND auto auto / mpv / qtmultimedia. auto memilih mpv bila tersedia, lalu Qt Multimedia.
KG_ENABLE_MPV ON Pemutaran video via libmpv (butuh mpvqt).
KG_ENABLE_VIDEO_THUMBS ON Poster frame video via FFmpeg. Otomatis nonaktif bila dev lib FFmpeg tidak ada.
KG_ENABLE_MULTIMEDIA ON Pemutaran video via Qt Multimedia.
KG_ENABLE_ML OFF Backend wajah (People) via ONNX Runtime. Butuh KG_ORT_ROOT atau ONNX Runtime terpasang.
KG_ORT_ROOT – Path ke distribusi ONNX Runtime x64 yang sudah diekstrak (CPU build, ~17 MB).
KG_BUILD_TESTS OFF Build unit test (tests/, Qt Test + CTest).

Dua permintaan yang eksplisit sekarang menggagalkan configure kalau tidak bisa dipenuhi, bukan diam-diam jatuh ke alternatif: KG_ENABLE_ML=ON tanpa ONNX Runtime, dan KG_VIDEO_BACKEND=mpv tanpa mpvqt. Alasannya ada di Architecture.

Contoh: memaksa Qt Multimedia.

cmake -S . -B build -G Ninja -DKG_VIDEO_BACKEND=qtmultimedia

Contoh: mengaktifkan grouping wajah.

curl -L -o ort.tgz \
  https://github.com/microsoft/onnxruntime/releases/download/v1.20.1/onnxruntime-linux-x64-1.20.1.tgz
tar xzf ort.tgz

cmake -S . -B build -G Ninja \
  -DKG_ENABLE_ML=ON -DKG_ORT_ROOT="$PWD/onnxruntime-linux-x64-1.20.1"
cmake --build build

Model wajahnya tidak ikut dibundel: diunduh dari Settings → Smart atas permintaanmu (~37 MB), lalu disimpan di <data dir>/models/.

Unit test

Test memakai QTemporaryDir dan tidak menyentuh pustaka pengguna.

cmake -S . -B build-tests -G Ninja -DKG_BUILD_TESTS=ON
cmake --build build-tests
ctest --test-dir build-tests --output-on-failure

Gate yang dipakai proyek ini

./scripts/qml-lint.sh              # exit 0 == nol peringatan qmllint
python3 scripts/i18n-audit.py      # tiap qsTr() punya entri katalog
ctest --test-dir build-tests

scripts/qml-lint.sh sengaja bukan pemanggilan qmllint langsung: banyak distro memasang qmllint Qt 5 di /usr/bin yang membayangi Qt 6, dan script itu memilih biner Qt 6 serta menambahkan -W 0. Detailnya di CONTRIBUTING.md.

Versi

Skemanya v<tahun>.<minggu ISO>.<patch>, dengan patch direset setiap minggu. Versi di CMakeLists.txt yang menentukan --version, versi paket CPack, dan pkgver AUR — jadi itu satu-satunya tempat yang perlu diubah. scripts/next-version.sh mencetak tag berikutnya, dan rilis ditandai manual.

Clone this wiki locally