loop-uh
d5a4715771
Some checks failed
Windows project source guards / test (push) Has been cancelled
56 lines
3.8 KiB
Markdown
56 lines
3.8 KiB
Markdown
# Карта исходников
|
||
|
||
Раскладка Windows и Android выполнена 2026-09-05. Это структурный перенос:
|
||
он не меняет маршрутизацию, формат данных или статус готовности нового WG/AWG
|
||
runtime. Старых модулей-переадресаций в корне нет.
|
||
|
||
## Windows
|
||
|
||
```text
|
||
xray_fluent/
|
||
├── __init__.py, constants.py общая идентичность и константы
|
||
├── application/ контроллер, сессии, переключения, сценарии
|
||
├── engines/
|
||
│ ├── singbox/ routing/DNS/TUN и native-протоколы
|
||
│ ├── xray/ VLESS transport
|
||
│ ├── hysteria/ Hysteria transport и runtime contract
|
||
│ ├── amnezia/ WG/AWG sidecar lifecycle
|
||
│ └── zapret/ запуск и параметры Zapret
|
||
├── profiles/ модели, хранение, пути, метаданные/пресеты
|
||
├── importer/ ключи, подписки, QR и адаптеры форматов
|
||
├── diagnostics/ исходные ошибки, журнал, экспорт, метрики
|
||
├── network/ HTTP, readiness, ping, speed и network workers
|
||
├── platform/windows/ системный прокси, процессы, адаптеры, автозапуск
|
||
├── updates/ проверка и установка обновлений
|
||
└── ui/ окна, страницы и виджеты
|
||
runtime/amnezia/ отдельный Go-модуль официального WG/AWG реле
|
||
```
|
||
|
||
Точка координации — `application/controller.py`. Исходные ошибки и их каталог —
|
||
`diagnostics/runtime_errors.py` и `diagnostics/runtime-errors.json`.
|
||
Они упаковываются вместе; экспорт не зависит от прежнего расположения файлов.
|
||
Разрешение ресурсов разработки и путь автозапуска остаются от корня проекта.
|
||
|
||
## Android
|
||
|
||
Внутри `app/src/main/java/io/github/zapretkvn/android`:
|
||
|
||
- `vpn/`: VPN service/controller/state/recovery и системная Quick Settings service.
|
||
- `engines/singbox/`, `engines/hysteria/`: Kotlin-интеграция и контракты ядер.
|
||
- `network/`, `network/probes/`: underlying network, DNS, health, latency.
|
||
- `platform/`: Android TUN/socket adapter и системная VPN policy.
|
||
- `apps/`: обнаружение, выбор приложений и per-app scope.
|
||
- `diagnostics/`: журнал исходных ошибок, метрики и безопасный экспорт.
|
||
- `profiles/`, `importer/`, `config/`, `routing/`, `updates/`, `ui/`:
|
||
существующие функциональные пакеты сохранены.
|
||
|
||
Встроенные Go-адаптеры Android Xray/Amnezia находятся в воспроизводимых
|
||
`core-patches`, а не в пустых Kotlin-пакетах. Новых Gradle-модулей не добавлено.
|
||
Имена Android VPN-сервиса/плитки, applicationId и пути данных не изменены.
|
||
|
||
## Проверка структуры
|
||
|
||
Windows: `python3 -m unittest discover -s tests`.
|
||
Android: `scripts/verify-project.sh`, `:app:testDebugUnitTest`,
|
||
`:app:assembleDebugAndroidTest`. Сборка instrumentation APK не означает,
|
||
что тесты были выполнены на устройстве. Выпуск приложений — отдельная операция.
|