Add Kod: Sprawdzanie katalogu programu w APPDATA

2026-02-10 01:56:38 +01:00
Unverified
parent 03a75a4067
commit c576f2ae4a

@@ -0,0 +1,46 @@
# Sprawdzanie katalogu programu w APPDATA
Klasa `checkAppdata` odpowiedzialna jest za sprawdzenie poprawności i, w razie potrzeby, doprowadzenie go do stanu poprawności.
### Główna funkcja programu
1. Czy w folderze %appdata% istnieje folder programu (Generator CSV)?
Jeżeli nie istnieje, uruchamiana jest funkcja `__buildAppdata` (odpowiedzialna za zbudowanie całości katalogu programu).
2. Czy w folderze programu istnieje plik 'version' (przechowuje on numer buildu programu, w którym został zbudowany katalog programu)?
Jeżeli nie istnieje, uruchamiane jest okno dialogowe zapytania z pytaniem czy pozwolić na zresetowanie katalogu programu i kontynuować ładowanie programu
3. Czy numer buildu programu w pliku 'version' jest zgodny z numerem buildu zawartym w zmiennej `VAR.programVersionBuild`
Jeżeli nie, uruchamiane jest okno dialogowe zapytania z pytaniem czy pozwolić na zresetowanie katalogu programu i kontynuować ładowanie programu
Jeżeli tak, sprawdzane są poszczególne pliki i foldery które powinny być zawarte w folderze, i jeżeli któryś plik/folder nie znajduje się w folderze, wywołuje się funkcje mające na celu przywrócenie/utworzenie tych plików/folderów (odpowiednio: `__restoreCFG` dla plików konfiguracyjnych, `__createFormatPresetsDir` dla folderu przechowującego format presety)
### Budowanie katalogu programu (`__buildAppdata`)
Funkcja ta, jest odpowiedzialna za zbudowanie całości katalogu programu w folderze %appdata%.
1. Tworzenie katalogu 'Generator CSV'
2. Tworzenie pliku 'version' i zapisanie w nim numeru buildu.
3. Inicjacja funkcji `__restoreCFG` (w celu skopiowania pliku 'config.cfg' z głównego katalogu programu do katalogu 'Generator CSV' w folderze %appdata%).
4. Inicjacja funkcji `__restoreCFG`(w celu skopiowania pliku 'style.cfg' z głównego katalogu programu do katalogu 'Generator CSV' w folderze %appdata%).
5. Inicjacja funkcji `__createFormatPresetsDir` (w celu stworzenia folderu 'format-presets' przechowującego format presety)
### Resetowanie katalogu programu (`__resetAppdata`)
Funkcja ta, jest odpowiedzialna za przywrócenie katalogu programu w folderze %appdata% do stanu podstawowego oraz stworzenie kopii zapasowej starego katalogu.
1. W przypadku gdy w katalogu istnieje jeszcze starsza kopia zapasowa folderu, kopia ta jest usuwana.
2. Nazwa katalogu programu jest zmieniana na taką z dopiskiem '_old'.
3. Inicjacja funkcji `__buildAppdata` w celu zbudowania nowego katalogu programu
4. Skopiowanie katalogu 'Generator CSV_old' do nowego katalogu 'Generator CSV'
### Przywracanie plików konfiguracyjnych (`__restoreCFG`)
Funkcja ta, jest odpowiedzialna za skopiowanie pliku konfiguracyjnego (.cfg) o danej nazwie z głównego katalogu programu do katalogu programu w folderze %appdata%
### Tworzenie katalogu przechowującego format presety (`__createFormatPresetsDir`)
Funkcja ta, jest odpowiedzialna za utworzenie folderu 'format-presets', przechowującego format presety, w katalogu programu w folderze %appdata%