2 Commits

Author SHA1 Message Date
a441eb4ff2 Merge pull request 'refactor: docs' (#4) from feat-windows_dockerfile into main
Reviewed-on: #4
2025-12-16 19:24:06 +03:00
036a0e6d9a refactor: docs 2025-12-16 19:23:40 +03:00

View File

@@ -41,7 +41,7 @@
Вам потребуется поддерживаемая операционная система из списка ниже. Если галочки нет, то поддержка появится в будущем. Вам потребуется поддерживаемая операционная система из списка ниже. Если галочки нет, то поддержка появится в будущем.
- [x] Linux (Wayland) - [x] Linux (Wayland)
- [x] Linux (XORG) - [x] Linux (XORG)
- [ ] Windows 10/11 (не тестировалось, должно билдиться) - [x] Windows 10/11
- [ ] MacOS (не тестировалось, должно билдиться) - [ ] MacOS (не тестировалось, должно билдиться)
### ⬇️ Установка ### ⬇️ Установка
@@ -50,12 +50,23 @@
### ⚙️ Настройка ### ⚙️ Настройка
При первом запуске будет необходимо выполнить настройку приложения. В Linux файл конфигурации располагается здесь: При первом запуске будет необходимо выполнить настройку приложения. Расположение файла конфигурации зависит от системы:
`~/.config/auto-attendance/auto-attendance.toml`. Необходимо получить актуальный файл конфигурации, который будет работать с конкретным журналом посещений - В Linux:
- `~/.config/auto-attendance/auto-attendance.toml`
- В Windows:
- `C:\Users\user\AppData\Roaming\auto-attendance\auto-attendance.toml`
Необходимо получить актуальный файл конфигурации, который будет работать с конкретным журналом посещений. Ключевую роль играют следующие параметры:
```toml
qr_query_token = '' # Название query-параметра, содержащего уникальный токен ссылки
self_approve_url = '' # Полный URL ссылки QR-кода (без query-параметров)
```
## 🔨 Сборка ## 🔨 Сборка
### 🧩 Зависимости ### Make (Linux, MacOS)
#### 🧩 Зависимости
- git - git
- make - make
@@ -63,24 +74,7 @@
- opencv 4.12.0 - opencv 4.12.0
- go 1.25.4 - go 1.25.4
### Go #### Порядок сборки
Используйте следующую команду в терминале:
```bash
go install git.weirdcat.su/weirdcat/auto-attendance/cmd/qrminator-cli@main
```
Далее можно запускать командой:
```bash
qrminator-cli
```
Убедитесь, что вы добавили `~/.go/bin` в PATH. Например:
```bash
export PATH=$PATH:~/.go/bin
```
### Make
Склонируйте мой репозиторий: Склонируйте мой репозиторий:
```bash ```bash
@@ -99,10 +93,30 @@ make
# make build-linux # make build-linux
# make build-macos # make build-macos
# make build-windows
``` ```
Далее для запуска можете использовать команду `make run`. Далее для запуска можете использовать команду `make run`.
### Dockerfile (Windows)
На данный момент единственный проверенный и самый простой способ собрать приложение под Windows - использовать [специальный Dockerfile](https://git.weirdcat.su/weirdcat/auto-attendance/raw/branch/main/Dockerfile.windows-build). На Windows для этого можно использовать WSL с Docker.
#### Порядок сборки (Bash):
```bash
# Создаем директорию и переходим в нее
mkdir build && cd build
# Получаем содержимое Dockerfile
curl "https://git.weirdcat.su/weirdcat/auto-attendance/raw/branch/main/Dockerfile.windows-build" > Dockerfile
# Выполняем сборку
docker build -t autoattendance-build-windows .
# Копируем бинарник из образа в текущую папку
docker run --rm -v $(pwd):/output autoattendance-build-windows sh -c "cp /go/src/auto-attendance/bin/autoattendance.exe /output/"
```
Готовое приложение - файл `autoattendance.exe`.
# Поддержать разработчиков # Поддержать разработчиков
![Николай (Telegram)](https://t.me/thebreadcat) ![Николай (Telegram)](https://t.me/thebreadcat)