Repository navigation
App Update
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 או משם תיקייה.
DifferentialUpdateEngine בונה staging ומאמת את התוצאה. otzaria_updater.exe מבצע את ההחלפה לאחר יציאת האפליקציה. השיגור חייב להיות מנותק מתנאי ה־Job Object של אוצריא; אחרת סגירת התוכנה עלולה להרוג גם את המעדכן.
תוכנית ההחלפה ונתוני ההתאוששות מאפשרים ניסיון השלמה או חזרה במקרה של עצירה. מפתח שמשנה את המסלול חייב לבדוק גם קובץ נעול, כשל שיגור, תהליך שלא יצא וקריסה באמצע ההחלפה.
המסלול בונה עותק של עץ ההתקנה, מחיל עליו את ההבדלים, משמר קישורים סימבוליים והרשאות הרצה, ומאמת את העץ לפני ההחלפה.
נדרשות גם הרשאות לתיקייה המכילה וכלי ההחלפה המתאים. נתוני משתמש בתוך עץ ההתקנה הם מגבלה מהותית, משום שהחלפת העץ אינה אמורה להחליף אותם. התקנות Linux המנוהלות ב־DEB/RPM ממשיכות להשתמש במסלול המתאים למנהל החבילות.
שחזור החלפת קובצי התוכנה אינו גיבוי נתונים אישיים. המסלול חייב לשמור את תיקיות המשתמש מחוץ לשינויים בקובצי ההתקנה.
swap_recovery.dart, swap_plan.dart והמעדכן החיצוני מתארים יחד את חוזה ההחלפה. אין לנקות staging או גיבוי החלפה רק משום שקיים קובץ הרצה: הוא עשוי להשתייך להתקנה חלקית.
Otzaria-Download-Assistant הוא כלי הכנת חבילות, ולא המעדכן שרץ בתוך האפליקציה. הוא קורא מניפסט רכיבים, בוחר חבילות למחשב היעד ומכין אותן, לרבות חלקים מפוצלים ואינדקס תואם כשזמין.
חוזה הבחירה ומידע ההפצה מתועדים ב־docs/download_assistant.md ובכלי tool/release/. הוספת רכיב דורשת לבדוק את המניפסט ואת כל המסייעים הרלוונטיים; אין להניח ששם קובץ לבדו מגדיר את אופן ההתקנה.
דף הבית · התחלת העבודה · שאלות נפוצות · פתרון תקלות
מדריך המשתמש נבדק מול גרסה 0.9.98.3+809; פרטי גרסאות ומועד הבדיקה בדף הבית.
התחלה מהירה
קריאה וחיפוש
אישי ותחזוקה
- כרטיסיות ושולחנות
- סימניות והערות
- ספרים אישיים
- מסדים אישיים
- גיבוי ושחזור
- הגדרות
- עדכונים
- תוספים
- כלים
- קישורים ישירים
תיעוד למפתחים
יסודות
נתונים
קריאה
חיפוש
מערכת
ממשק