# Сборка и запуск

## Development

```bash
uv sync
uv run pytest
uv run flet run app/main.py
```

`uv` уже был установлен в рабочем окружении. Flet current build creates a Flutter
shell and packages the Python app; the native Android bridge is registered as a local
Flet extension from `native/android/flet_vpn_bridge`.

## Backend

Generate a Fernet key and configure the operator token:

```bash
export VPNAPP_ADMIN_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"
export VPNAPP_SECRET_KEY="$(uv run --project backend python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')"
export VPNAPP_BASE_URL=http://127.0.0.1:8080
./scripts/run-backend.sh
```

Open `http://127.0.0.1:8080/admin`. The page is one self-contained HTML file with no
frontend build. It asks for the configured token, lists users/devices, creates/deletes
them and generates enrollment/subscription links. Deploy behind HTTPS and do not put
the admin token in a public URL.

## Android

The Flet shell can be built without native core artifacts; runtime connections then
return `UNSUPPORTED` honestly. A release build can enforce both artifacts:

```bash
./scripts/fetch-engine-artifacts.sh
REQUIRE_NATIVE_ARTIFACTS=1 ./scripts/build-android.sh
```

For a native-bridge/permissions smoke APK without cores, run
`./scripts/build-android.sh`. The script targets `arm64-v8a`.

Build prerequisites are current JDK/Android SDK/Flutter as required by Flet. Use a
device/emulator with API 26+ for LocalOnlyHotspot; API 33+ needs runtime
`NEARBY_WIFI_DEVICES`. Android VPN consent must be granted interactively by the user.

FreeTurn AAR:

```bash
git clone --depth 1 --branch <pinned-ref> https://github.com/samosvalishe/free-turn-proxy.git /tmp/free-turn-proxy
cd /tmp/free-turn-proxy
task build:android
cp dist/freeturn.aar /path/to/repo/native/android/libs/
```

For SignBox, use the exact artifact that exposes the API expected by
`native/android/flet_vpn_bridge/src/flutter/vpn_native_bridge/android/.../EngineAdapter.kt`. A generic sing-box
`libbox.aar` is not silently assumed to be the user's private SignBox fork. Record its
commit, build tags, ABIs, license and SHA-256 in `THIRD_PARTY_NOTICES.md`, then replace
the adapter with calls from that artifact and add a native integration test.

## Desktop

```bash
SIGNBOX_BIN=/absolute/path/to/sign-box ./scripts/build-desktop.sh linux
SIGNBOX_BIN=/absolute/path/to/sign-box.exe ./scripts/build-desktop.sh windows
```

Desktop SignBox proxy mode is process based. System proxy changes are not performed.