Skip to content
palmoni5 edited this page Nov 5, 2026 · 3 revisions

עדכון האפליקציה

lib/update/ מעדכן את קובצי אוצריא עצמה. זהו מנגנון נפרד מעדכון הספרייה, מעדכון תוסף ומנתוני החיפוש החכם. למשתמש: מדריך העדכונים.

בדיקת גרסה ובחירת חבילה

MyUpdatWidget מנהל את הבדיקה, יומן השינויים, הכנת העדכון וההתקנה. הוא משתמש בסטטוסים תואמי updat ובמימושי התקנה לפי פלטפורמה.

  • fetchLatestAppRelease קורא את releases/latest של Otzaria/otzaria. זהו מקור העדכון היחיד; טיוטות וגרסאות prerelease נדחות, וריליס אחר אינו מועמד רק משום שמספרו גבוה יותר.
  • בדיקה חסומה כשהגדרות הרשת או העדכון אינן מאפשרות אותה. אין להריץ בדיקות לכל חלון כאילו הוא תהליך נפרד.
  • InitialSoftwareCheck מודיע למסלול העלייה אם יש עדכון תוכנה. הכרעה זו משפיעה על עדכון הספרייה והאינדוקס.
  • יומן השינויים מסונן לפי הגרסה המותקנת והגרסה הזמינה.
  • ב־Windows בחירת EXE או ZIP נקבעת לפי סוג ההתקנה; אין לבחור חבילת FULL, מסייע הורדה או חבילת patch כמתקין רגיל.
  • ב־Linux יש התאמה לפורמט החבילה ולארכיטקטורה; התקנה ניידת אינה מקבלת DEB/RPM שיתקינו עותק אחר במקום אחר.
  • ב־macOS משתמשים במסלול המתאים לחבילת האפליקציה. DMG להתקנה ידנית אינו זהה ל־ZIP של עדכון עצמי.

יש לשמור על מעטפת widgets יציבה גם כשעדכונים כבויים: שינוי צורת העץ יכול לאפס מסכים, כרטיסיות ומצב פנימי.

הורדה, הכנה והפעלה הם שלבים שונים

שלב משמעות
עדכון זמין נמצאה גרסה חדשה
מוריד / מכין נבנית חבילת ההתקנה המקומית
מוכן להתקנה ההכנה הסתיימה; אפשר להפעיל כעת, או דרך מסלול הסגירה המסודרת
סגור והתקן משוגרת פעולת ההתקנה וסגירת החלונות
ממתין לסגירת חלונות המעדכן כבר ממתין ליציאת התהליך

_installNow משגר התקנה עם relaunchApp: true ומבקש לסגור את כל חלונות אוצריא רק אם השיגור הצליח. במסלול סגירה מסודרת, AppWindowListener.prepareUpdateForClose קורא ל־_handleWindowClose: כאשר קיים מתקין או עדכון מצומצם מוכן, והמצב הוא readyToInstall או dismissed, הוא משגר עם relaunchApp: false. כך ניתן להתקין ברקע בלי לפתוח את אוצריא מחדש בניגוד לכוונת המשתמש שסגר אותה.

אין להציג ״הותקן״ לפני שההתקנה הסתיימה. סגירת חלון אחד אינה מבטיחה שההליך כולו יצא, והתקנה יכולה להיכשל. אם המעדכן החיצוני ויתר משום שהתהליך לא נסגר בזמן, יש להחזיר מצב שמאפשר ניסיון חוזר.

עדכון מצומצם

tryPrepareDifferentialUpdate מנסה להכין עדכון מצומצם לפני מסלול ההורדה הרגיל. כשהמסלול אינו מתאים או ההכנה נכשלת, הוא מחזיר שליטה למסלול הרגיל.

ההחלטה נשענת על חותם הגרסה המותקנת, התאמת פלטפורמה וארכיטקטורה, נכסי השחרור, הרשאות כתיבה וקיום כלי העזר. אין להסיק התאמה רק מ־PackageInfo או משם תיקייה.

Windows

DifferentialUpdateEngine בונה staging ומאמת את התוצאה. otzaria_updater.exe מבצע את ההחלפה לאחר יציאת האפליקציה. השיגור חייב להיות מנותק מתנאי ה־Job Object של אוצריא; אחרת סגירת התוכנה עלולה להרוג גם את המעדכן.

תוכנית ההחלפה ונתוני ההתאוששות מאפשרים ניסיון השלמה או חזרה במקרה של עצירה. מפתח שמשנה את המסלול חייב לבדוק גם קובץ נעול, כשל שיגור, תהליך שלא יצא וקריסה באמצע ההחלפה.

macOS ו־Linux נייד

המסלול בונה עותק של עץ ההתקנה, מחיל עליו את ההבדלים, משמר קישורים סימבוליים והרשאות הרצה, ומאמת את העץ לפני ההחלפה.

נדרשות גם הרשאות לתיקייה המכילה וכלי ההחלפה המתאים. נתוני משתמש בתוך עץ ההתקנה הם מגבלה מהותית, משום שהחלפת העץ אינה אמורה להחליף אותם. התקנות Linux המנוהלות ב־DEB/RPM ממשיכות להשתמש במסלול המתאים למנהל החבילות.

התאוששות ונתוני המשתמש

שחזור החלפת קובצי התוכנה אינו גיבוי נתונים אישיים. המסלול חייב לשמור את תיקיות המשתמש מחוץ לשינויים בקובצי ההתקנה.

swap_recovery.dart, swap_plan.dart והמעדכן החיצוני מתארים יחד את חוזה ההחלפה. אין לנקות staging או גיבוי החלפה רק משום שקיים קובץ הרצה: הוא עשוי להשתייך להתקנה חלקית.

מסייע ההורדה

Otzaria-Download-Assistant הוא כלי הכנת חבילות, ולא המעדכן שרץ בתוך האפליקציה. הוא קורא מניפסט רכיבים, בוחר חבילות למחשב היעד ומכין אותן, לרבות חלקים מפוצלים ואינדקס תואם כשזמין.

חוזה הבחירה ומידע ההפצה מתועדים ב־docs/download_assistant.md ובכלי tool/release/. הוספת רכיב דורשת לבדוק את המניפסט ואת כל המסייעים הרלוונטיים; אין להניח ששם קובץ לבדו מגדיר את אופן ההתקנה.

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

Clone this wiki locally