Skip to content

it 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 | 中文

Struttura dei file

Come è organizzato il repository di VD Google, così da poterti orientare nel codice sorgente.

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

Dove vivono le cose

  • I reader: cosa VD Google legge e come lo legge, vivono solo in VDGoogle/app/src/main/java/ru/vd171/vdgoogle/data/ (l'app) e VDGoogle/webui/webroot/scripts.js (la WebUI). I due si rispecchiano esattamente.
  • Le stringhe sono la fonte unica di ogni etichetta, in 21 lingue: l'app sotto res/values*/strings.xml, la WebUI sotto webroot/lang/. Un'etichetta non viene mai scritta due volte.
  • La documentazione vive in docs/. È la fonte autorevole per il wiki del progetto; il wiki è generato da essa (vedi tools/ e .github/scripts/gen_wiki.sh).
  • Lo strumento incluso (sqlite3) vive in assets/bin/ per l'app e bin/ per il modulo, ed è documentato in Binari inclusi.

Output della build

Le build di release producono l'APK e lo ZIP della WebUI. Gli artefatti di build non sono committati. Vedi il readme per come compilare.

Stato a runtime

Sul dispositivo, il modulo WebUI mantiene il suo stato sotto /data/adb/vdgoogle/:

  • scratch/: copie di breve durata di un database, prese da parte affinché una query non tocchi mai il file vivo. Ogni lettura elimina le proprie copie, e qualsiasi residuo di un'esecuzione interrotta viene ripulito la volta successiva che la WebUI si apre. Niente qui viene conservato.
  • actions.jsonl: il log locale delle azioni che cambiano lo stato (la cancellazione della cache di Google Wallet), una riga JSON ciascuna, limitato alle ultime 200 voci. Non lascia mai il dispositivo.

L'app mantiene invece le stesse copie scratch di breve durata nella propria cache privata, e scrive il suo log delle azioni all'interno della propria directory privata dei file.

Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.

Clone this wiki locally