מדריך | הצגת תמונת קבצי jar בסייר ווינדוס

[מחנה ידידים]

דרישות מקדימות

לפני שמתחילים, ודאו שיש לכם:

• Windows 10 או 11, בגרסת 64-bit (x64). זה לא יעבוד על מחשב עם Windows 32-bit או על מעבד ARM.

• .NET 8 Desktop Runtime מותקן (לא ה-Runtime הרגיל/Console — חייב בדיוק את גרסת ה-Desktop, כי ה-thumbnails משתמשים ב-GDI+).
  להורדה: https://dotnet.microsoft.com/download/dotnet/8.0 ⭠ תחת "Run desktop apps" בוחרים .NET Desktop Runtime 8.0.x — Windows x64.

לבדיקה אם כבר מותקן, ב-PowerShell:

powershell  dotnet --list-runtimes

צריכה להופיע שורה שמתחילה ב-Microsoft.WindowsDesktop.App 8.0.

• הרשאות משתמש רגילות מספיקות — לא צריך Administrator, ההתקנה נכתבה לעבוד per-user (HKCU).

ㅤ
ㅤ

התקנת JAR Shell Extension

שלב 1 — חילוץ הקובץ

1. הורד את קובץ ה-7z.
2. חשוב: קליק ימני על הקובץ ⭠ Extract All... (חלץ הכל) לתיקייה על הדיסק.
   אל תפתח קבצים ישירות מתוך ה-7z בלי לחלץ קודם — זה יגרום לשגיאות.
3. ודא שיש לך תיקייה עם שתי תיקיות משנה בפנים: build-output ו-installer.

שלב 2 — פתיחת PowerShell

1. בתוך התיקייה שחילצת, היכנס לתיקיית installer.
2. לחץ Shift + קליק ימני בתוך התיקייה (על שטח ריק) ובחר Open PowerShell window here (או "פתח כאן חלון PowerShell").
   • אם האפשרות לא מופיעה: פתח PowerShell רגיל, ואז הקלד cd ואחריו רווח, וגרור את תיקיית installer לתוך החלון, ולחץ Enter.

שלב 3 — התקנה

חשוב: כל פקודה בשורה נפרדת, עם Enter אחרי כל אחת — אל תדביק את שתיהן יחד.

פקודה ראשונה (מאפשרת הרצת סקריפטים בחלון הזה בלבד, לא משנה כלום קבוע במחשב):

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

פקודה שנייה (ההתקנה עצמה) — החלף את הנתיב בסוגריים בנתיב האמיתי של תיקיית build-output\JarMeta.ShellExtension אצלך:

.\Install.ps1 -NoCopy -Source "<נתיב לתיקיית build-output\JarMeta.ShellExtension>" -RestartExplorer

לדוגמה, אם התיקייה שחילצת נמצאת ב-Downloads\JarShellExt-Release:

.\Install.ps1 -NoCopy -Source "C:\Users\<שם-משתמש>\Downloads\JarShellExt-Release\build-output\JarMeta.ShellExtension" -RestartExplorer

שלב 4 — סיום

• אם בסוף מופיעה השורה Installed. — ההתקנה הצליחה. (אם באמצע מופיעה שגיאה אדומה על (default) — זה תקין ולא משפיע, אפשר להתעלם.)
• Explorer ייסגר וייפתח מחדש לבד.
• קבצי JAR שכבר נראו ב-Explorer לפני ההתקנה לא יתעדכנו אוטומטית. כדי לרענן: Disk Cleanup ⭠ סמן "Thumbnails" ⭠ Run. או פשוט לפתוח תיקייה עם קובץ JAR שעוד לא נראה שם.

אם יש בעיה

• "running scripts is disabled" ⭠ חזור לשלב 3, פקודה ראשונה.
• "Install.ps1 is not recognized" ⭠ כנראה לא נמצאים בתיקיית installer. הרץ cd לתיקייה הנכונה (ראה שלב 2).
• הסרה (אם רוצים לבטל): מתוך אותה תיקיית installer:

  .\Uninstall.ps1