GENERATOR PROGRAMÓW ŻUŻLOWYCH - PROGRAM NA WINDOWS Wersja: 11.321.0 ==================================================== NOWE W 11.321.0 --------------- - Informacja o programie na Windows jest teraz na stronie wejściowej generatora i na stronie WordPress [aplikacja_zuzelnews] (wtyczka i aplikacja 11.321.0). Linki z tych stron prowadzą do strony pobierania w tym samym języku, w którym jest strona. - Nowy adres .../windows/#pl - strona polska „na sztywno”: nie zmienia języka sama, a pobieranie i licznik działają jak zwykle. Użyj go, jeśli chcesz, żeby Twój link zawsze otwierał stronę po polsku, niezależnie od języka przeglądarki. - W folderze windows nadal 11 plików - wgraj wszystkie. Z 11.320.0 ---------- - Strona pobierania w 6 językach: polski, angielski, szwedzki, duński, czeski, niemiecki. Adres główny .../windows/ sam otwiera stronę w języku użytkownika (tak jak aplikacja: język wybrany w aplikacji, potem język przeglądarki; norweski -> duński, słowacki -> czeski, inne -> angielski). Na górze strony jest przełącznik języków. - Licznik pobrań: WordPress -> Katalog programów -> Statystyki odwiedzin -> ramka „Program na Windows” pokazuje, ile razy otwarto stronę pobierania (osobno Windows 10 / 11 i inne urządzenia), ile razy zaczęto pobieranie i w jakim języku była strona. Potrzebna wtyczka 11.320.0. Pobrań z linku prowadzącego wprost do pliku .exe nie da się policzyć - to jeszcze jeden powód, żeby linkować do strony. - Folder windows ma teraz 11 plików (doszły sv.html, da.html, cs.html, de.html) - wgraj wszystkie, razem z .htaccess. Z 11.319.0 - ŁATWIEJSZA INSTALACJA ---------------------------------- - Strona pobierania z instrukcją w trzech krokach. Pobieranie instalatora zaczyna się na niej samo. - Instalator nazywa się teraz Generator-programow-zuzlowych-instalator.exe (było: ...-Windows.exe). Stare dwa pliki z 11.318.0 usuń z serwera. - Po instalacji program pokazuje raz okienko „Program jest zainstalowany” (gdzie jest ikona, że aktualizuje się sam). - Instalator jak dotąd: jeden plik .exe, o nic nie pyta, nie wymaga uprawnień administratora, na końcu sam otwiera program. CO JEST W PACZCE ---------------- instalator/ <- CAŁĄ zawartość wgraj do folderu windows na serwerze index.html - strona pobierania (polski) en.html, sv.html, da.html, cs.html, de.html - strona pobierania w 5 językach ikona.png - ikona na stronie pobierania Generator-programow-zuzlowych-instalator.exe - instalator (ok. 117 MB) Generator-programow-zuzlowych-instalator.exe.blockmap - do pobierania samych zmian latest.yml - numer najnowszej wersji i skrót pliku .htaccess - plik ukryty! (patrz niżej) projekt/ - źródła programu (do przebudowania albo podpisania) LINK, KTÓRY UMIESZCZASZ NA STRONIE ---------------------------------- ZALECANY - strona pobierania: https://generator.zuzelnews.pl/windows/ Gotowy kod: Pobierz program na Windows Po kliknięciu otwiera się strona i po sekundzie samo zaczyna się pobieranie pliku .exe. Użytkownik od razu widzi, co zrobić dalej. Strona sama wybiera język użytkownika. Jeśli chcesz podać link do konkretnego języka (taka strona nie zmienia języka sama): https://generator.zuzelnews.pl/windows/#pl polski https://generator.zuzelnews.pl/windows/en.html angielski https://generator.zuzelnews.pl/windows/sv.html szwedzki https://generator.zuzelnews.pl/windows/da.html duński https://generator.zuzelnews.pl/windows/cs.html czeski https://generator.zuzelnews.pl/windows/de.html niemiecki BEZPOŚREDNI - sam plik: https://generator.zuzelnews.pl/windows/Generator-programow-zuzlowych-instalator.exe Pobieranie zaczyna się od razu po kliknięciu, bez żadnej strony. Nazwa pliku jest ta sama w każdej wersji - link się nie zmienia. Takie pobrania nie trafiają do licznika. Dlaczego zalecam pierwszy: - Windows przy uruchomieniu pliku pokazuje niebieskie okno z jednym widocznym przyciskiem „Nie uruchamiaj”. Kto nie wie, że trzeba kliknąć „Więcej informacji”, na tym kończy. Strona to pokazuje. - Na telefonie link bezpośredni pobierze 117 MB pliku, którego nie da się tam użyć. Strona pobierania na telefonie, Macu i starszym Windows niczego sama nie pobiera i proponuje generator w przeglądarce. CO ZOBACZY UŻYTKOWNIK --------------------- 1. Klika link. Otwiera się strona „Pobieranie się zaczęło”, plik zapisuje się w folderze Pobrane (albo tam, gdzie wskaże). 2. Przeglądarka może zapytać, czy zachować plik (Edge: trzy kropki przy pliku -> „Zachowaj” -> „Pokaż więcej” -> „Zachowaj mimo to”). Strona pokazuje podpowiedź dla jego przeglądarki. 3. Otwiera plik. Windows: „System Windows ochronił ten komputer” -> „Więcej informacji” -> „Uruchom mimo to” (rysunek na stronie). 4. Instalacja trwa chwilę i o nic nie pyta. Program otwiera się sam i pokazuje okienko „Program jest zainstalowany”. 5. Na pulpicie i w menu Start jest ikona „Generator programów żużlowych”. CZEGO NIE DA SIĘ USUNĄĆ BEZ PODPISU - WAŻNE ------------------------------------------- Kroki 2 i 3 (ostrzeżenie przeglądarki i niebieskie okno Windows) to najtrudniejsze miejsce dla mniej wprawnych osób. Strona prowadzi przez nie krok po kroku, ale ich nie usuwa. Wynikają z tego, że instalator nie jest podpisany i jest nowy. Według dokumentacji Microsoftu: - plik niepodpisany zaczyna „od zera” przy KAŻDEJ nowej wersji; - podpis certyfikatem nie usuwa ostrzeżenia od razu - zaufanie rośnie z liczbą pobrań (tygodnie); droższy certyfikat EV nie daje już pierwszeństwa; - ostrzeżeń nie ma przy aplikacjach z Microsoft Store (bezpłatnie, Microsoft podpisuje paczkę sam). Źródła: https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/smartscreen-reputation https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/code-signing-options Możliwości (do Twojej decyzji, sprawy W-1 i W-3 na liście): a) Microsoft Store - najprostsza instalacja dla użytkownika (jeden przycisk „Pobierz”, bez ostrzeżeń). Paczkę do sklepu buduje się na komputerze z Windows - stąd tego nie zrobię, przygotuję projekt i instrukcję. b) certyfikat podpisu kodu (np. Azure Artifact Signing, ok. 10 USD miesięcznie; dla firm z UE, Wielkiej Brytanii, USA i Kanady) - ostrzeżenia znikają stopniowo. c) zostaje jak jest - strona pobierania prowadzi przez ostrzeżenia. Jest też droga bez instalatora: w Edge i Chrome na komputerze stronę generator.zuzelnews.pl można zainstalować jak program przyciskiem w pasku adresu - bez pobierania pliku i bez ostrzeżeń. JAK WGRAĆ --------- 1. W katalogu głównym subdomeny generator.zuzelnews.pl załóż folder windows (jeśli go nie ma) i wgraj do niego CAŁĄ zawartość folderu instalator/ - jedenaście plików, także ukryty .htaccess. 2. Usuń z folderu stare pliki z 11.318.0: Generator-programow-zuzlowych-Windows.exe Generator-programow-zuzlowych-Windows.exe.blockmap 3. Wgraj też wtyczkę i aplikację 11.321.0. Wtyczka: bez niej licznik nie przyjmie zgłoszeń ze strony pobierania (strona działa normalnie, tylko liczby zostają na zerze). Aplikacja: od 11.319.0 folder windows nie przechodzi przez pamięć aplikacji w przeglądarce (inaczej instalator 117 MB zapisywałby się w niej drugi raz). 4. Sprawdź: https://generator.zuzelnews.pl/windows/latest.yml - krótki tekst z numerem wersji https://generator.zuzelnews.pl/windows/ - strona pobierania curl -sI https://generator.zuzelnews.pl/windows/Generator-programow-zuzlowych-instalator.exe | grep -i -e disposition -e cache-control -> Content-Disposition: attachment oraz Cache-Control: no-cache, must-revalidate curl -sI https://generator.zuzelnews.pl/windows/ | grep -i content-security -> JEDNA linia, zaczyna się od: Content-Security-Policy: default-src 'none' Jeśli któraś linia wygląda inaczej, plik .htaccess z folderu windows nie działa na Twoim serwerze - napisz mi. Strona i pobieranie działają także wtedy; po włączeniu B-2 pobieranie zaczynałby dopiero duży przycisk na stronie, nie zaczynałoby się samo. PRZY KAŻDEJ NOWEJ WERSJI ------------------------ Wgraj do folderu windows całą zawartość instalator/ z nowej paczki, nadpisując stare pliki (strona pobierania pokazuje numer wersji i rozmiar pliku, a .htaccess ma skrót skryptu tej strony - dlatego wszystkie pliki mają pochodzić z jednej paczki). Zainstalowane programy zaktualizują się same. PLIK .htaccess W FOLDERZE windows --------------------------------- - instalator, .blockmap i latest.yml bez pamięci podręcznej (nazwa pliku jest stała, więc nikt nie może dostać starej kopii); - plik .exe zawsze jako plik do pobrania; - strona pobierania ma własną, krótką politykę bezpieczeństwa treści; polityka aplikacji z folderu wyżej jest w tym folderze zdejmowana (sprawa B-2 dotyczy więc tylko aplikacji, nie tej strony); - jedyne połączenie strony z innym serwerem to licznik odwiedzin w WordPressie (https://zuzelnews.pl) - wysyła same nazwy zdarzeń, bez ciasteczek i bez identyfikatora. Sprawdzone na serwerze Apache 2.4. Na nginx plik jest ignorowany - odpowiedniki są w jego komentarzu. PIERWSZY TEST NA WINDOWS (ok. 20 minut) - NADAL PO TWOJEJ STRONIE ----------------------------------------------------------------- Instalator i tę stronę sprawdziłem bez Windows (nie mam do niego dostępu): program działał pod Linuksem, stronę i pobieranie testowałem w przeglądarce Chromium udającej Edge, Chrome i Firefoksa. Zanim podasz link kibicom, przejdź to sam na zwykłym komputerze: 1. W Edge otwórz https://generator.zuzelnews.pl/windows/ - pobieranie zaczyna się samo. Porównaj napisy z podpowiedzią na stronie („Zachowaj”, „Pokaż więcej”, „Zachowaj mimo to”) - jeśli Edge nazywa je inaczej, napisz mi, poprawię stronę. 2. To samo w Chrome („Zachowaj”). 3. Uruchom plik. Niebieskie okno: „Więcej informacji” -> „Uruchom mimo to”. Porównaj z rysunkiem na stronie. 4. Instalacja sama uruchamia program; pojawia się okienko „Program jest zainstalowany”; na pulpicie jest ikona. 5. Otwiera się ekran startowy (32 kafelki), po polsku. 6. Polska -> PGE Ekstraliga: wpisz nazwisko, włącz tryb na żywo, kliknij PDF -> okno „Zapisz jako” -> plik otwiera się poprawnie. 7. Zamknij program i uruchom z ikony - nazwisko jest na miejscu, okienko powitalne już się nie pokazuje. 8. „Skanuj kod” - Windows pyta o kamerę albo od razu ją włącza. 9. Ustawienia -> Aplikacje: jest „Generator programów żużlowych 11.321.0”; odinstalowanie działa. 10. Jeśli masz zainstalowaną starszą wersję: po wgraniu plików powinna w ciągu kilku minut pokazać okno „Pobrano nową wersję”. 11. Licznik: po kroku 1 zajrzyj do WordPressa -> Statystyki odwiedzin -> „Program na Windows”. Powinno być 1 otwarcie strony na Windows i 1 rozpoczęte pobieranie (po kroku 2 - po 2). 12. Języki: napisy niebieskiego okna Windows po niemiecku i czesku potwierdziłem w źródłach, po szwedzku i duńsku - nie udało się. Podpowiedzi o przeglądarkach w tych czterech językach opisują czynność („wybierz zachowanie pliku”), bez nazw przycisków. Jeśli znasz kogoś z Windows po szwedzku albo duńsku, poproś o rzut oka. JAK DZIAŁAJĄ AKTUALIZACJE ------------------------- - Program 10 sekund po starcie, a potem co 6 godzin, pobiera plik latest.yml. Jeśli jest tam nowsza wersja, pobiera ją w tle i pokazuje okno „Pobrano nową wersję”: „Uruchom ponownie teraz” albo „Później” (wtedy instaluje się przy zamknięciu programu). Aktualizacja nie powinna pokazywać ostrzeżeń Windows (plik pobiera sam program, nie przeglądarka) - do potwierdzenia w teście, punkt 10. - Pierwsza aktualizacja po instalacji pobiera cały plik (117 MB), kolejne - tylko zmienione fragmenty (tak działa biblioteka electron-updater 6.8.11 przy stałej nazwie pliku; na Windows tego nie sprawdziłem). - Bez internetu program działa normalnie; aktualizację sprawdzi przy następnej okazji. - Program przyjmuje aktualizację tylko wtedy, gdy skrót pliku zgadza się z latest.yml (SHA-512). CO PROGRAM ROBI INACZEJ NIŻ STRONA ---------------------------------- - Ma wszystkie pliki aplikacji w sobie - działa bez internetu od pierwszego uruchomienia. Internet: Katalog programów, reklamy, licznik odwiedzin (pozycja „Aplikacja na Windows”), aktualizacje. - Programy zawodów zapisuje w swoich danych na komputerze: %APPDATA%\Generator programów żużlowych osobno od przeglądarki. Program zapisany na stronie przenosi się jak między telefonami: „Kod QR” -> „Skanuj kod” (kamera komputera). - Instaluje się dla bieżącego użytkownika: %LOCALAPPDATA%\Programs\ + skrót na pulpicie i w menu Start. - PDF i PNG: okno „Zapisz jako” (domyślnie folder Pobrane). - Bez powiadomień push, bez Google Analytics, bez strony wejściowej. - Odinstalowanie: Ustawienia -> Aplikacje. Zapisane programy zostają w %APPDATA% (wrócą po ponownej instalacji); żeby je usunąć, skasuj ten folder. PRZEBUDOWANIE (dla programisty) ------------------------------- Wymagany Node.js 20 lub nowszy i Python 3 z biblioteką Pillow. cd projekt npm ci python przygotuj.py ŚCIEŻKA_DO_PLIKÓW_APLIKACJI (odświeża www/, csp.json, ikonę, wersję) npm run dist (na Windows) python strona.py (strona pobierania i .htaccess w wynik/) Na Linuksie bez wine: NODE_OPTIONS="--require ./bez_wine.js" npx electron-builder --win --x64 Wynik: folder wynik/ (instalator, .blockmap, latest.yml, sześć stron .html, ikona.png, .htaccess). Kontrola bez uruchamiania: python sprawdz_instalator.py Strona pobierania: strona/szablon.html (układ i style), strona/teksty.json (napisy w 6 językach), strona/skrypt.js (jedyny skrypt: wybór języka, rozpoznanie Windows, start pobierania, licznik; po jego zmianie strona.py sam wstawia nowy skrót do .htaccess). Nowy język: wpis w JEZYKI w strona.py, słownik w teksty.json i kod języka na liście J w skrypt.js. Adres aktualizacji: package.json -> build.publish.url. Podpis: certyfikat w zmiennych CSC_LINK / CSC_KEY_PASSWORD (electron-builder podpisze program, deinstalator i instalator), potem win.verifyUpdateCodeSignature można usunąć z package.json. Powłoka: Electron 45.4.1, electron-builder 26.18.0, electron-updater 6.8.11.