Merge remote README with screenshots, add Office 2016 info

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
hariel1985
2026-04-13 23:36:05 +02:00
10 fájl változott, egészen pontosan 70 új sor hozzáadva és 181 régi sor törölve

251
README.md
Fájl megtekintése

@@ -1,213 +1,102 @@
# InstaSoft Office Tool # InstaSoft Office Tool
**Belső használatú Office telepítő varázsló az InstaSoft Informatikai Zrt. ügyfelei számára.** Microsoft Office telepítő, eltávolító és licenc-kezelő alkalmazás.
Microsoft Office 2019 / 2021 / 2024 telepítés, eltávolítás és licenc-kezelés egyetlen alkalmazásból. Fejlesztő: **InstaSoft Informatikai Zrt.** | Microsoft Partner
--- ---
## Funkcionalitás ## Letöltés
### Office telepítés (varázsló) A legfrissebb verzió a **Releases** oldalon érhető el.
1. **Verzió választás** — Office 2024, 2021 vagy 2019 > Az alkalmazás futtatásához **.NET Framework 4.8** szükséges (Windows 10/11 rendszereken alapértelmezetten telepítve van).
2. **Kiadás választás** — Standard, Professional Plus, Otthoni és kisvállalati verzió > A program rendszergazdai jogosultságot kér induláskor.
3. **Beállítások** — architektúra (64/32-bit), nyelv, alkalmazások kizárása
4. **Termékkulcs** — opcionális, ha megadja az ügyfél, automatikusan aktiválódik ### Telepítés
5. **Összegzés** — generált ODT XML megtekintése és mentése
6. **Meglévő Office ellenőrzés** — telepítés előtt felkínálja a régi verzió eltávolítását Az alkalmazás digitálisan aláírva az **InstaSoft Informatikai Zrt.** nevében (Microsoft Azure Trusted Signing).
7. **Telepítés** — ODT automatikus letöltése és futtatása
8. **Telepítés után** — aktiválás lehetőség + Word/Excel/PowerPoint/Outlook indítás Első futtatáskor a Windows SmartScreen figyelmeztetést jeleníthet meg, mivel az alkalmazás új és még kevesen töltötték le. Ez nem jelent biztonsági kockázatot — az aláírás igazolja a fejlesztő személyazonosságát.
**1. A böngésző letöltés után figyelmeztethet.** Kattintson a **három pontra (⋯)**, majd a **"Megtartás"** gombra.
![Letöltés megtartása](screenshots/SmartScreen00.png)
**2. Indításkor megjelenik a SmartScreen ablak.** Kattintson a **"További információ"** linkre.
![SmartScreen figyelmeztetés](screenshots/SmartScreen01.png)
**3. Ellenőrizze a gyártó nevét**, majd kattintson a **"Futtatás mindenképpen"** gombra.
![Futtatás mindenképpen](screenshots/SmartScreen02.png)
---
## Funkciók
### Office telepítés
- Támogatott verziók: **Office 2024**, **Office 2021**, **Office 2019**, **Office 2016**
- Kiadások: **Standard**, **Professional Plus**, **Otthoni és kisvállalati verzió**
- Architektúra választás (64-bit / 32-bit)
- 22 telepítési nyelv
- Alkalmazások egyenkénti kiválasztása (Word, Excel, PowerPoint, Outlook, OneNote, Access, Publisher, Teams, Skype for Business)
- Opcionális termékkulcs megadás — automatikus aktiválás a telepítés végén
- Meglévő Office automatikus felismerése és eltávolítási lehetőség telepítés előtt
- A telepítés végén alkalmazások közvetlen indítása
> **Office 2016** telepítése ISO letöltéssel történik (a Microsoft CDN már nem szolgálja ki a 2016-os Click-to-Run fájlokat). A Standard kiadás 32-bit és 64-bit, a Professional Plus kiadás 64-bit változatban érhető el, magyar nyelven.
### Office eltávolítás ### Office eltávolítás
- Telepített Office verziók automatikus felismerése (Click-to-Run és MSI)
- Registry-ból detektálja a telepített Office verziókat (Click-to-Run + MSI) - Szelektív eltávolítás — minden termék külön kiválasztható
- Szelektív eltávolítás: minden termék külön kiválasztható - Opcionális licenc-adatbázis tisztítás
- Click-to-Run: ODT `setup.exe /configure remove.xml` (specifikus Product ID-vel)
- MSI: `msiexec /x {GUID} /qb`
- Opcionális licenc-adatbázis tisztítás (ospp.vbs /unpkey)
### Licenc-kezelés ### Licenc-kezelés
- Licenc állapot lekérdezése
- `ospp.vbs /dstatus` — licenc állapot lekérdezése - Termékkulcs megadása és aktiválás
- Minden talált kulcs külön kártyákon jelenik meg - Termékkulcsok egyenkénti vagy csoportos eltávolítása
- **Aktiválás** gomb: termékkulcs bekérési dialóg → `/inpkey``/act` - Beragadt licencek kezelése (ospp.vbs)
- **Eltávolítás** gomb: külön kulcsonként `/unpkey`
- Összes kulcs eltávolítása (2+ kulcs esetén)
--- ---
## Technikai részletek ## Rendszerkövetelmények
### Platform
| | | | | |
|---|---| |---|---|
| **Keretrendszer** | WPF .NET Framework 4.8 | | **Operációs rendszer** | Windows 7 SP1 / 8.1 / 10 / 11 |
| **Nyelv** | C# (SDK-style csproj) | | **Keretrendszer** | .NET Framework 4.8 |
| **Cél platform** | Windows 7 SP1+ (.NET 4.8 szükséges) | | **Jogosultság** | Rendszergazda (Administrator) |
| **Build** | `dotnet build -c Release` (.NET 8 SDK) | | **Internetkapcsolat** | Szükséges (Office letöltéséhez) |
| **Kimenet** | `bin\Release\net48\InstaSoftOfficeTool.exe` |
| **Méret** | ~25 KB (egyetlen exe, nem kell telepíteni) |
| **Jogosultság** | Administrator (UAC manifest) |
### Design
- **Fluent Design** világos téma (Windows 11 stílus)
- Segoe UI Variable font (fallback: Segoe UI)
- Lekerekített sarkok, kártyák árnyékkal, accent szín: `#0078D4`
- Saját ConfirmDialog és ProductKeyDialog (nem Windows MessageBox)
- 800x550 px fix ablakméret
### ODT (Office Deployment Tool)
- Automatikus letöltés: `https://officecdn.microsoft.com/pr/wsus/setup.exe`
- Letöltött fájl helye: `%TEMP%\InstaSoftODT\setup.exe`
- Ha már létezik és >1MB, újra nem tölti le
- XML generálás az `OdtXmlGenerator` osztályban
### Támogatott Office termékek
| Évjárat | Kiadás | Product ID | Channel |
|---------|--------|------------|---------|
| 2024 | Standard | Standard2024Volume | PerpetualVL2024 |
| 2024 | Professional Plus | ProPlus2024Volume | PerpetualVL2024 |
| 2024 | Otthoni és kisvállalati | HomeBusiness2024Retail | Current |
| 2021 | Standard | Standard2021Volume | PerpetualVL2021 |
| 2021 | Professional Plus | ProPlus2021Volume | PerpetualVL2021 |
| 2021 | Otthoni és kisvállalati | HomeBusiness2021Retail | Current |
| 2019 | Standard | Standard2019Volume | PerpetualVL2019 |
| 2019 | Professional Plus | ProPlus2019Volume | PerpetualVL2019 |
| 2019 | Otthoni és kisvállalati | HomeBusiness2019Retail | Current |
### Alkalmazás kizárási szabályok
| Alkalmazás | Elérhető kiadások | Alapértelmezett |
|---|---|---|
| Word, Excel, PowerPoint, Outlook, OneNote | Mind | Bekapcsolva |
| Access | Csak Professional Plus | Bekapcsolva |
| Publisher | Professional Plus, Standard | Bekapcsolva |
| Teams | Mind | Kikapcsolva |
| Skype for Business | Mind | Kikapcsolva |
### ospp.vbs keresés
A program az alábbi helyeken keresi az `ospp.vbs` fájlt:
1. `C:\Program Files\Microsoft Office\root\Office16\OSPP.VBS` (Click-to-Run)
2. `C:\Program Files (x86)\Microsoft Office\root\Office16\OSPP.VBS`
3. `C:\Program Files\Microsoft Office\Office16\ospp.vbs` (MSI)
4. `C:\Program Files (x86)\Microsoft Office\Office16\ospp.vbs`
5. Office15, Office14 változatok
6. Registry: `HKLM\SOFTWARE\Microsoft\Office\ClickToRun\Configuration\InstallationPath`
--- ---
## Projekt struktúra ## Képernyőképek
``` ### Főoldal
InstaSoftOfficeTool/ ![Főoldal](screenshots/01_welcome.png)
├── InstaSoftOfficeTool.csproj Projekt fájl (.NET Framework 4.8)
├── App.xaml / App.xaml.cs Alkalmazás belépési pont
├── MainWindow.xaml / .xaml.cs Fő ablak, navigáció, wizard logika
├── app.manifest UAC requireAdministrator
├── Models/
│ ├── OfficeVersion.cs Évjárat enum (2024, 2021, 2019)
│ ├── OfficeEdition.cs Kiadás adatok (ProductId, Channel)
│ ├── InstallConfig.cs Telepítési konfig + nyelvek + alkalmazások
│ └── InstalledOffice.cs Detektált Office info
├── Pages/
│ ├── WelcomePage.xaml Üdvözlő oldal (3 kártya-gomb)
│ ├── VersionPage.xaml Évjárat választás
│ ├── EditionPage.xaml Kiadás választás (dinamikus)
│ ├── ConfigPage.xaml Architektúra, nyelv, alkalmazások
│ ├── ProductKeyPage.xaml Termékkulcs bevitel (5x5 mező)
│ ├── SummaryPage.xaml Összegzés + XML preview
│ ├── PreInstallCheckPage.xaml Meglévő Office ellenőrzés/eltávolítás
│ ├── ProgressPage.xaml Telepítési folyamat + befejezés után aktiválás/indítás
│ ├── RemovePage.xaml Önálló Office eltávolítás
│ ├── TroubleshootPage.xaml Licenc-kezelés (dstatus, aktiválás, unpkey)
│ ├── ConfirmDialog.xaml Saját megerősítő dialóg (overlay)
│ └── ProductKeyDialog.xaml Termékkulcs bekérő dialóg (overlay)
├── Services/
│ ├── OdtXmlGenerator.cs ODT XML konfig generálás
│ ├── OdtDownloader.cs ODT letöltés (officecdn.microsoft.com)
│ ├── OfficeDetector.cs Telepített Office detektálás (registry)
│ ├── LicenseManager.cs ospp.vbs keresés és futtatás (/dstatus, /inpkey, /act, /unpkey)
│ └── ProcessRunner.cs Külső folyamat futtatás async
├── Styles/
│ ├── FluentTheme.xaml Színek, brushok, globális font
│ ├── ButtonStyles.xaml PrimaryButton, SecondaryButton, CardButton
│ └── ControlStyles.xaml ComboBox, TextBox, CheckBox, RadioButton, ProgressBar
└── Resources/
└── app.ico Alkalmazás ikon
```
--- ### Office telepítés — Verzió választás
![Verzió választás](screenshots/04_version.png)
## Build ### Office telepítés — Kiadás választás
![Kiadás választás](screenshots/05_edition.png)
### Előfeltétel ### Office telepítés — Beállítások
![Beállítások](screenshots/06_config.png)
- .NET 8 SDK (a `dotnet` parancshoz) ### Office eltávolítás
- Nincs szükség Visual Studio-ra ![Office eltávolítás](screenshots/03_remove.png)
### Fordítás ### Licenc-kezelés — Aktiválás
![Licenc-kezelés](screenshots/02_license_activate.png)
```bash
cd C:\Projects\InstaSoftOfficeTool
dotnet build -c Release
```
Kimenet: `bin\Release\net48\InstaSoftOfficeTool.exe`
### Fontos
- **Build előtt be kell zárni a futó programot** — az exe zárolt, amíg fut
- Csak az `.exe` kell a futtatáshoz, a `.pdb` és `.config` nem szükséges
---
## Terjesztés
### Kód aláírás
Az exe fájlt OV (Organization Validation) tanúsítvánnyal kell aláírni a SmartScreen figyelmeztetések elkerüléséhez.
```bash
signtool sign /f certificate.pfx /p PASSWORD /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 InstaSoftOfficeTool.exe
```
### Verziókezelés
Verziószám **3 helyen** kell frissíteni kiadáskor:
1. `InstaSoftOfficeTool.csproj``<Version>`, `<AssemblyVersion>`, `<FileVersion>`
2. `MainWindow.xaml` — jobb felső sarok `Text="v1.xx"`
3. Git tag: `git tag v1.xx && git push origin v1.xx`
--- ---
## Verziótörténet ## Verziótörténet
| Verzió | Dátum | Változások | A részletes verziótörténet a Releases oldalon érhető el.
|--------|-------|------------|
| v1.01 | 2026-03-31 | Első kiadás: wizard, eltávolítás, licenc-kezelés | ---
| v1.02 | 2026-03-31 | Licenc UI javítások, ospp.vbs root/Office16 path |
| v1.03 | 2026-03-31 | Fluent ComboBox/CheckBox/TextBox stílusok | **InstaSoft Informatikai Zrt.** | Budapest, Magyarország
| v1.04 | 2026-03-31 | Config layout (arch+nyelv egymás mellett), Skype default off |
| v1.05 | 2026-03-31 | Gomb szöveg kontraszt javítás (fehér kék alapon) |
| v1.06 | 2026-03-31 | Termékkulcs paste javítás (DataObject.Pasting) |
| v1.07 | 2026-03-31 | Pre-install Office ellenőrzés a telepítés előtt |
| v1.08 | 2026-03-31 | Saját Fluent megerősítő dialóg (MessageBox helyett) |
| v1.09 | 2026-04-01 | ODT CDN letöltés fix, szelektív C2R eltávolítás |
| v1.10 | 2026-04-02 | Aktiválás kulcs dialóggal, auto-refresh, Access korlátozás |
| v1.11 | 2026-04-02 | Teljes alkalmazás lista, kiadásfüggő elérhetőség |
| v1.13 | 2026-04-02 | Telepítés utáni aktiválás és app indítás |
| v1.14 | 2026-04-02 | Ablak méret visszaállítás Vissza gombnál |
| v1.16 | 2026-04-02 | Flat projekt struktúra |

BINáris
screenshots/01_welcome.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Méret: 70 KiB

BINáris
screenshots/03_remove.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 64 KiB

BINáris
screenshots/04_version.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 61 KiB

BINáris
screenshots/05_edition.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 71 KiB

BINáris
screenshots/06_config.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 53 KiB

BINáris
screenshots/SmartScreen00.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 14 KiB

BINáris
screenshots/SmartScreen01.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 59 KiB

BINáris
screenshots/SmartScreen02.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Méret: 78 KiB