Repository navigation
Library Update
lib/library_update/ מתאם את עדכון seforim.db, נכסי הספרייה הנלווים ורענון המצב הפעיל. תכנון מסלול העדכון ומבנה ה־patches נשענים על חבילת seforim_library_updater; עטיפת אוצריא אחראית גם לממשק, מקום פנוי, חיבורי SQLite, ביטול ורענון האינדקס.
למשתמש: מדריך העדכונים. עדכון קובצי האפליקציה הוא מנגנון נפרד.
- התאוששות בעלייה: בדיקת עדכון קודם שנקטע לפני פתיחת הספרייה לשימוש רגיל.
-
בדיקת גרסה: קריאת הגרסה המקומית וקבלת תוכנית עדכון דרך
checkForUpdate. - בחירת מסלול: דלתא, הורדה מלאה או בחירה למשתמש כשהדלתא כבדה.
- הורדה ואימות: בדיקות מקום, המשך הורדה נתמכת ואימות קבצים.
- החלה או החלפת מסד: עבודה מתואמת עם שערי הגישה ל־SQLite.
- רענון: פתיחת הנתונים מחדש, ניקוי מטמונים, עדכון נכסים נלווים והעברת הצורך ברענון אינדקס.
גודל ההורדה אינו משקף בהכרח את משך ההחלה או את המקום הזמני. אין לקבע בתיעוד גודל ספרייה או הבטחה של ״כמה עשרות MB״ לכל דלתא.
applyDeltaPlan עובר על צעדי התוכנית. הוא יכול להשתמש ב־patch פרוס שכבר אומת, ובודק מקום לכל צעד. שלבי ההורדה, האימות וההחלה מעדכנים את ההתקדמות דרך callbacks.
הכתיבה הכבדה והאימות רצים ב־isolate ייעודי. DatabaseLibraryProvider.operationQueue מתאמת פעולות שמשנות את המסד. הטיפול בחיבור הפעיל ובמצב ה־journal נמצא בפונקציות ההחלה; אין להניח ש־WAL לבדו הופך כל קריאה בזמן החלפה לבטוחה.
בדיקת התאמה לאחר ההחלה יכולה לזהות סטייה בתוכן. חלק מהאימות עשוי להידחות לפי מידע המניפסט. יש להבחין בין ״לא ניתן להחיל״, ״הוחל אבל נמצאה סטייה״ ובין ״רענון runtime נכשל אחרי שהמסד כבר השתנה״.
applyFullDownload מוריד ומחלץ למסד חדש, מאמת אותו, ורק אז נכנס למסלול החלפת המסד הפעיל.
LibraryAccessGate סוגר את חיבורי הספרייה הנדרשים, מונע החלפה מקבילה ומאפשר לקוראים להמתין. ב־Windows קיימת בדיקת שחרור של קובץ המסד, משום שקובץ פתוח עלול למנוע rename.
פעולת ההחלפה רושמת נתוני התאוששות, מטפלת בקובצי הצד של SQLite, מסמנת את נקודת השינוי בפועל ופותחת את הספרייה מחדש. האחריות ל־rollback שייכת לפעולה המחליפה; השער אינו גיבוי של המסד.
LibraryUpdateBloc משתמש ב־_operationId כדי לא לתת לתוצאה מריצה ישנה לשנות מצב של ריצה חדשה.
יש לבדוק ביטול גם אחרי המתנה בתור ולפני סגירת חיבורים או יצירת גיבוי גדול. אחרי נקודת האל־חזור, ביטול אינו יכול להציג כאילו הספרייה לא השתנתה. בייחוד, החלפת מסד שהצליחה לפני כשל ברענון חייבת להשאיר מידע נכון על הגרסה ועל הצורך ברענון אינדקס.
אישור להורדה מלאה, דחייה שלה והמשך דלתא כבדה הם מצבים נפרדים. אין לדלג על אישור רק כדי לנסות מסלול אחר.
LibraryRuntimeRefreshService.refreshAfterDbUpdate מרענן את הקשרים הפעילים לספרייה. CompanionAssetsService מטפל בנכסים נלווים לפי זמינותם והגרסה הנדרשת.
ה־BLoC מעביר בין היתר מידע על ספרים ששונו ועל requiresFullIndexRefresh. שינוי תוכן מחייב שהחיפוש יראה את התוכן החדש; הצלחת הורדה אינה מוכיחה שהאינדקס כבר הושלם.
העלייה מתואמת ב־StartupWorkGate: ממתינים גם לסיום העדכון וגם לרענון שבא אחריו לפני החלטת האינדוקס הרלוונטית. ראה רצף האתחול.
״מה חדש בספרים״ מנוהל ב־changes_notes בנפרד מתוכן המסד, לרבות תורים של מידע שטרם פורסם או הוצג. אין להפוך היעדר יומן שינויים לכשל של עדכון הספרייה.
| מצב | המשמעות לתזמור |
|---|---|
| הגבלת בקשות מ־GitHub | יש להציג זמן/אפשרות ניסיון חוזר; זו אינה הוכחה למסד פגום |
| אין מקום או אין הרשאת כתיבה | יש לעצור לפני שינוי הנתונים |
| הורדה שנקטעה | שמירה או המשך לפי יכולת ההורדה |
| כשל התאמה או סטייה | מסלול תיקון/הורדה מלאה באישור, עם מצב אינדקס נכון |
| כשל אחרי החלפת המסד | לא לדווח שהכול בוטל; לרענן או להתאושש לפי מצב הדיסק |
דף הבית · התחלת העבודה · שאלות נפוצות · פתרון תקלות
מדריך המשתמש נבדק מול גרסה 0.9.98.3+809; פרטי גרסאות ומועד הבדיקה בדף הבית.
התחלה מהירה
קריאה וחיפוש
אישי ותחזוקה
- כרטיסיות ושולחנות
- סימניות והערות
- ספרים אישיים
- מסדים אישיים
- גיבוי ושחזור
- הגדרות
- עדכונים
- תוספים
- כלים
- קישורים ישירים
תיעוד למפתחים
יסודות
נתונים
קריאה
חיפוש
מערכת
ממשק