add install guide for linux
All checks were successful
Deploy on Master Change / deploy (push) Successful in 40s

This commit is contained in:
Your Name
2026-07-02 13:35:53 +07:00
parent 2ad899d787
commit 4b8f4d288a

86
client/INSTALL_LINUX.md Normal file
View File

@@ -0,0 +1,86 @@
# Hướng dẫn Cài đặt & Chạy ứng dụng Simple Care trên Linux
Tài liệu này hướng dẫn cách cài đặt công cụ lập trình, cài đặt thư viện chạy và tiến hành biên dịch ứng dụng Simple Care trên môi trường Linux.
---
## 1. Cho Nhà phát triển (Developer - Build ứng dụng)
### Bước 1: Cài đặt thư viện hệ thống
Cài đặt trình biên dịch C và các thư viện Webview (GTK/WebKit) tùy vào hệ điều hành đang dùng:
* **Ubuntu / Debian / Linux Mint:**
```bash
sudo apt update
sudo apt install -y build-essential libgtk-3-dev libwebkit2gtk-4.1-dev libx11-dev pkg-config zenity libcanberra-gtk3-module
```
* **Fedora / RHEL:**
```bash
sudo dnf groupinstall "Development Tools"
sudo dnf install -y gtk3-devel webkit2gtk4.1-devel libX11-devel pkgconf-pkg-config zenity
```
* **Arch Linux:**
```bash
sudo pacman -Syu --needed base-devel gtk3 webkit2gtk-4.1 libx11 pkgconf zenity
```
### Bước 2: Cài đặt Go & Node.js & Wails CLI
Nếu chưa cài đặt bộ công cụ biên dịch:
1. Tải và cài đặt **Go** (bản 1.23+): [golang.org](https://go.dev/dl/)
2. Tải và cài đặt **Node.js** (bản 18 hoặc 20 LTS): [nodejs.org](https://nodejs.org/)
3. Cài đặt **Wails CLI** thông qua Go:
```bash
go install github.com/wailsapp/wails/v2/cmd/wails@v2.12.0
```
4. Cài đặt công cụ mã hóa **Garble**:
```bash
go install mvdan.cc/garble@v0.13.0
```
### Bước 3: Tiến hành Biên dịch (Build)
Chạy script tự động phát hiện hệ điều hành để build bản bảo mật (obfuscated):
```bash
cd client
chmod +x build.sh
./build.sh
```
Sau khi build xong, file thực thi sẽ nằm tại: `client/build/bin/simple_care_v1.0`
---
## 2. Cho Người dùng cuối (End-user - Chỉ chạy ứng dụng)
Người dùng cuối **không cần** cài đặt Go, Node hay trình biên dịch C. Họ chỉ cần tệp thực thi `simple_care_v1.0` và cài đặt các thư viện đồ họa cơ bản của hệ thống:
* **Ubuntu / Debian / Linux Mint:**
```bash
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-0 zenity
```
* **Fedora / RHEL:**
```bash
sudo dnf install -y webkit2gtk4.1 zenity
```
* **Arch Linux:**
```bash
sudo pacman -Sy webkit2gtk-4.1 zenity
```
### Lệnh chạy ứng dụng:
Cấp quyền chạy cho file và khởi chạy:
```bash
chmod +x simple_care_v1.0
./simple_care_v1.0
```
---
## 3. Lệnh dọn dẹp bộ nhớ đệm (Clean cache)
Nếu thư mục `client/build/` xuất hiện nhiều thư mục đệm tạm thời (dạng số hexa `00` đến `ff`), bạn có thể dọn dẹp bằng lệnh sau:
```bash
find build -mindepth 1 -maxdepth 1 -type d -name "[0-9a-f][0-9a-f]" -exec rm -rf {} +
```