Cài đặt nâng cao

#Tất cả tệp tải xuống

Các tệp được phân phối từ Cloudflare R2, không phải GitHub Releases, và chỉ 10 phiên bản gần nhất được giữ lại. Trang tải xuống liệt kê tất cả các phiên bản đó.

Các bản phát hành đến 0.1.x được công bố dưới tên cũ, dạng MOVIE-ADE-<version>-…. Tên Ferret-… bắt đầu từ 0.2.0.

#Xác minh tệp tải về (SHA256SUMS có chữ ký)

Mỗi bản phát hành có tệp SHA256SUMS và chữ ký của nó SHA256SUMS.sig. Chữ ký được tạo bằng khóa phát hành của Ferret, khóa này được giữ tách biệt khỏi server tải xuống, nên một trình cài đặt bị thay đổi trên server tải xuống không thể đi kèm chữ ký hợp lệ. Khóa công khai không được lấy từ server tải xuống: hãy lấy nó từ repository (build/release-signing/allowed_signers (mở trong tab mới)) hoặc sao chép từ đây:

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

Dấu vân tay của nó là SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ. Các tệp tương tự cũng được đính kèm vào mỗi bản phát hành trên GitHub. Kiểm tra chữ ký bằng ssh-keygen (có sẵn trong macOS, Windows 10 trở lên và Linux), rồi so sánh hash của tệp bạn tải về với danh sách đã ký:

# the download server (currently the R2 public URL; it may move to a custom domain)
BASE=https://pub-588d93b3e875464f98d6cf98dc711a0c.r2.dev
VERSION=$(curl -s $BASE/latest.json | jq -r .version)
curl -sO $BASE/releases/$VERSION/SHA256SUMS
curl -sO $BASE/releases/$VERSION/SHA256SUMS.sig

# save the public key above as allowed_signers, then:
ssh-keygen -Y verify -f allowed_signers -I [email protected] -n ferret-release -s SHA256SUMS.sig < SHA256SUMS
# → Good "ferret-release" signature for [email protected] …

# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing
# Linux
sha256sum -c SHA256SUMS --ignore-missing

# Windows (PowerShell): compare with the line for your file in SHA256SUMS
Get-FileHash .\Ferret-<version>-win-x64.exe -Algorithm SHA256

Hãy dừng lại nếu ssh-keygen không in ra Good "ferret-release" signature hoặc hash không có trong danh sách. Kiểm tra cập nhật của Ferret cũng kiểm tra như vậy bằng khóa được tích hợp trong ứng dụng, và không đề xuất phiên bản có chữ ký không khớp. Trên macOS, bạn cũng có thể kiểm tra chữ ký Developer ID và notarization bằng spctl -a -vv /Applications/Ferret.app. Với các bản phát hành đến 0.3.0, hãy so sánh với các hash trong releases/<version>/manifest.json.

#Phiên bản macOS cũ

Với các phiên bản đến 0.2.0 build 2: nếu macOS báo không thể xác minh nhà phát triển, đóng hộp thoại, mở System Settings → Privacy & Security, bấm Open Anyway cạnh thông báo về Ferret, rồi xác nhận bằng Open. Nếu macOS báo ứng dụng "is damaged" (bị hỏng), hãy gỡ thuộc tính quarantine:

xattr -dr com.apple.quarantine /Applications/Ferret.app

#Build từ mã nguồn

Cần Node.js 20 trở lên (CI và môi trường phát triển cục bộ dùng 22), pnpm và git.

git clone https://github.com/JapanMarketing-Dev/ferret.git
cd ferret
pnpm install          # postinstall prepares node-pty for Electron
pnpm dev              # run in development mode

Để đóng gói trình cài đặt (đầu ra trong dist/release/, cấu hình trong electron-builder.config.cjs). Bản build Linux chỉ chạy được trên Linux.

pnpm dist:mac     # dmg (arm64, x64)
pnpm dist:win     # NSIS installers (x64, arm64)
pnpm dist:linux   # AppImage + deb (x64)

Các script build:<os>:dev chỉ tạo ứng dụng chưa đóng gói (--dir), nhanh hơn khi kiểm thử cục bộ.

Trên Windows, pnpm install dùng các binary dựng sẵn đi kèm node-pty thay vì build lại (việc đó sẽ cần Visual Studio C++ build tools). Đặt ADE_FORCE_NATIVE_REBUILD=1 để buộc build lại.

Nếu terminal báo không tải được node-pty, hãy chạy pnpm rebuild:native.

#Cập nhật

Ferret không tự động cập nhật. Ở chân trang, mở Cập nhật và bấm Kiểm tra cập nhật. Ứng dụng lấy latest.json từ server tải xuống (R2), so sánh phiên bản và kiểm tra chữ ký của SHA256SUMS cho phiên bản đó bằng khóa phát hành tích hợp trong ứng dụng. Khi có phiên bản mới hơn, bấm Tải xuống: Ferret tải trình cài đặt cho máy tính của bạn, kiểm tra SHA-256 của nó có khớp với SHA256SUMS đã ký không, lưu vào thư mục Downloads và hiển thị tệp ở đó. Trang tải xuống cũng kiểm tra như vậy ngay trong trình duyệt trước khi lưu tệp. Không có gì được kiểm tra cho đến khi bạn bấm, và không có gì được cài đặt tự động.