Skip to content

pl FILE STRUCTURE

Jump to bottom
github-actions[bot] edited this page Nov 13, 2026 · 3 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Tiếng Việt | 中文

Struktura plików

Jak rozłożone jest repozytorium VD Google, abyś mógł się odnaleźć w kodzie źródłowym.

VD-Google/
├── README.md, README.<lang>.md       # the readme, in 21 languages
├── LICENSE                           # GNU AGPL-3.0-or-later
├── CHANGELOG.md                      # user-facing release notes
├── images/                           # screenshots used by the readme
├── docs/                             # this documentation (source of the wiki)
│   ├── USER-GUIDE.md, ARCHITECTURE.md, PRIVACY.md, BINARIES.md, FILE-STRUCTURE.md
│   └── <lang>/                       # the same docs in each language
├── tools/                            # maintenance scripts (wiki, docs nav)
├── .github/                          # CI and the wiki-sync workflow
│   ├── workflows/
│   └── scripts/gen_wiki.sh
└── VDGoogle/                         # the Gradle project
    ├── app/                          # the Android app
    │   └── src/main/
    │       ├── java/ru/vd171/vdgoogle/
    │       │   ├── data/             # the readers and their data models
    │       │   ├── ui/               # Compose screens and view model
    │       │   ├── root/             # the libsu RootService bridge
    │       │   └── util/             # export, formatting, action log
    │       ├── res/                  # layouts and the 21-language strings
    │       └── assets/bin/           # the bundled sqlite3 (see BINARIES.md)
    └── webui/                        # the WebUI module
        ├── module.prop, customize.sh, update.json
        ├── bin/                      # the bundled sqlite3, per ABI
        └── webroot/                  # the HTML/JS/CSS WebUI
            ├── index.html, scripts.js
            └── lang/                 # the 21-language strings for the WebUI

Gdzie co żyje

  • Czytniki: co VD Google czyta i jak to czyta, żyją wyłącznie w VDGoogle/app/src/main/java/ru/vd171/vdgoogle/data/ (aplikacja) i VDGoogle/webui/webroot/scripts.js (WebUI). Oba odzwierciedlają się nawzajem dokładnie.
  • Teksty są jedynym źródłem każdej etykiety, w 21 językach: aplikacja pod res/values*/strings.xml, WebUI pod webroot/lang/. Etykieta nigdy nie jest pisana dwa razy.
  • Dokumentacja żyje w docs/. Jest źródłem prawdy dla wiki projektu; wiki jest z niej generowane (zobacz tools/ i .github/scripts/gen_wiki.sh).
  • Wbudowane narzędzie (sqlite3) żyje w assets/bin/ dla aplikacji i bin/ dla modułu, i jest udokumentowane w Wbudowane pliki binarne.

Wynik kompilacji

Kompilacje release produkują APK i ZIP WebUI. Artefakty kompilacji nie są commitowane. Zobacz readme, aby dowiedzieć się, jak budować.

Stan czasu wykonania

Na urządzeniu moduł WebUI przechowuje swój stan pod /data/adb/vdgoogle/:

  • scratch/: krótkotrwałe kopie bazy danych, brane na bok, aby zapytanie nigdy nie dotykało żywego pliku. Każdy odczyt usuwa swoje własne kopie, a wszelkie pozostałości po przerwanym uruchomieniu są czyszczone przy następnym otwarciu WebUI. Nic tutaj nie jest przechowywane.
  • actions.jsonl: lokalny log działań zmieniających stan (wyczyszczenie pamięci podręcznej Google Wallet), po jednej linii JSON każde, ograniczony do ostatnich 200 wpisów. Nigdy nie opuszcza urządzenia.

Aplikacja przechowuje te same krótkotrwałe kopie scratch we własnej prywatnej pamięci podręcznej, a swój log działań zapisuje wewnątrz własnego prywatnego katalogu plików.

Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.

Clone this wiki locally