mirror of
https://github.com/s-frick/effigenix.git
synced 2026-03-28 15:29:34 +01:00
82 lines
2 KiB
Markdown
82 lines
2 KiB
Markdown
# Effigenix Scanner
|
||
|
||
Tauri v2 Mobile App mit QR/Barcode-Scanner für Lager- und Produktionsworkflows.
|
||
|
||
## Voraussetzungen
|
||
|
||
- Nix DevShell aktiv (`nix develop`)
|
||
- Backend läuft unter `http://localhost:8080`
|
||
|
||
## Desktop-Entwicklung
|
||
|
||
```bash
|
||
just dev-scanner
|
||
```
|
||
|
||
## Android-Gerät
|
||
|
||
### 1. USB-Debugging aktivieren
|
||
|
||
Auf dem Android-Gerät unter **Einstellungen > Entwickleroptionen > USB-Debugging** aktivieren.
|
||
Gerät per USB anschließen und Verbindung prüfen:
|
||
|
||
```bash
|
||
adb devices
|
||
```
|
||
|
||
### 2. NixOS-Firewall öffnen
|
||
|
||
Die DevShell kann Ports 1420 (Vite) und 1421 (HMR) automatisch in der NixOS-Firewall freischalten.
|
||
Dazu die Shell mit gesetzter Env-Variable betreten:
|
||
|
||
```bash
|
||
EFFIGENIX_OPEN_FW=1 nix develop
|
||
```
|
||
|
||
Oder manuell:
|
||
|
||
```bash
|
||
sudo iptables -I nixos-fw 3 -p tcp --dport 1420 -j ACCEPT
|
||
sudo iptables -I nixos-fw 3 -p tcp --dport 1421 -j ACCEPT
|
||
```
|
||
|
||
Prüfen ob die Regeln aktiv sind:
|
||
|
||
```bash
|
||
sudo iptables -L nixos-fw -n | grep -E '1420|1421'
|
||
```
|
||
|
||
### 3. App starten
|
||
|
||
```bash
|
||
TAURI_DEV_HOST=<LAN-IP> VITE_API_URL=http://<LAN-IP>:8080 just dev-scanner-android
|
||
```
|
||
|
||
Beispiel:
|
||
|
||
```bash
|
||
TAURI_DEV_HOST=192.168.0.166 VITE_API_URL=http://192.168.0.166:8080 just dev-scanner-android
|
||
```
|
||
|
||
- `TAURI_DEV_HOST` – teilt dem Android-Gerät mit, wo der Vite-Dev-Server läuft
|
||
- `VITE_API_URL` – Backend-URL für API-Requests (Default: `http://localhost:8080`)
|
||
|
||
### Troubleshooting
|
||
|
||
| Problem | Lösung |
|
||
|---------|--------|
|
||
| `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | Alte App deinstallieren: `adb uninstall de.effigenix.scanner` |
|
||
| `error sending request for url` auf Port 1420 | Firewall-Ports nicht offen (siehe Schritt 2) |
|
||
| API-Requests schlagen fehl | `VITE_API_URL` auf LAN-IP setzen, Port 8080 in Firewall freigeben |
|
||
| Gerät nicht erkannt | `adb devices` prüfen, USB-Debugging aktiviert? |
|
||
|
||
## Tech Stack
|
||
|
||
| Tool | Zweck |
|
||
|------|-------|
|
||
| Tauri v2 | Native Mobile Shell |
|
||
| React 18 | UI Framework |
|
||
| Tailwind v4 | Styling |
|
||
| Vite 6 | Build/Dev Server |
|
||
| tauri-plugin-barcode-scanner | QR/Barcode-Scanning |
|
||
| tauri-plugin-http | HTTP-Requests (CORS-Bypass) |
|