Repository navigation
Related Repos
אוצריא נשענת על מאגר האפליקציה, מאגר הספרייה, חבילות ושירותי הפצה. דף זה ממפה את הקשרים החשובים למפתח לפי pubspec.yaml ותיעוד המערכת בענף dev; הוא אינו רשימה מלאה של כל מאגר בארגון.
| פרויקט | מה הוא מספק | היכן הוא מתחבר לאפליקציה |
|---|---|---|
| Otzaria/otzaria | יישום Flutter, ממשק משתמש, אחסון ואינטגרציות | המאגר הראשי וה־Wiki הזה |
| Otzaria/SeforimLibrary | מסד הספרייה ונכסי הפצת הספרייה | הורדה ראשונית, עדכונים וחבילות הכוללות נתונים |
| Otzaria/otzaria_library_updater | חבילת seforim_library_updater
|
lib/library_update/ |
| Otzaria/otzaria_search_engine | מנוע חיפוש Rust עם ממשק Dart |
search/, indexing/ ותשתיות החיפוש הנוספות |
| Otzaria/otzaria_icons | אייקונים ייעודיים לאוצריא | ממשק האפליקציה ומיפוי אייקונים לתוספים |
| palmoni5/otzaria-ashurit | חבילת גופן ונכסים לתיקון קוראים |
otzaria_ashurit ב־pubspec |
| Otzaria/otzaria-plugin-validator | אימות ואריזת תוספים ב־CI | מסלול הפיתוח וההפצה של .otzplugin
|
| Otzaria/Otzaria_Website | מסלול החנות באתר otzaria.org | פרסום והתקנת תוספים וחוזה ה־SDK |
SeforimLibrary הוא היצרן של seforim.db ושל נכסי ההפצה המשויכים לגרסת ספרייה. מספר הספרים והנכסים עשוי להשתנות בין גרסאות; אין לקודד מספר קבוע בממשק או להניח שכל release מכיל אותו סט קבצים.
seforim_library_updater הוא לקוח Dart נפרד שאוצריא צורכת מתלות Git נעוצה. האפליקציה מחברת אליו גילוי גרסאות, הורדה, אימות והחלת עדכון, ומנהלת סביבו את מצב הקוראים והאינדקסים. הגרסה המדויקת של החבילה וה־ref נמצאים ב־pubspec.yaml וב־pubspec.lock.
עדכון דלתא תלוי בהתאמה בין מסד המקור, patch ומסד היעד. שינוי בפורמט או בכללי האימות דורש תיאום בין היצרן ללקוח; שינוי UI לבדו אינו מספיק. פירוט בעדכון הספרייה.
תשתית ההפצה משתמשת גם באינדקסים מוכנים. תהליכי ה־CI של אוצריא ו־SeforimLibrary מתאמים את בנייתם לפי סכמת מנוע החיפוש; אינדקס אינו קובץ שאפשר להעביר בין כל גרסאות המנוע בלי בדיקת התאמה.
otzaria_search_engine מופץ כחבילה ב־pub.dev. הליבה מבוססת Rust ו־Tantivy ומחוברת ל־Dart. הקוד, ה־bindings והבינארי הנייטיבי צריכים להיות תואמים.
באפליקציה הנוכחית נכסים נייטיביים נפתרים באמצעות build hooks: הורדת בינארי מתאים או בנייה ממקור כשאין בינארי עבור אותה גרסה. לפיכך שדרוג החבילה עשוי להשפיע גם על סביבת הבנייה, הבדיקות ותאימות האינדקס. אל תסתפק בכך ש־flutter pub get הצליח.
חבילת opentype_shaper היא תלות נפרדת לצורך עיצוב טקסט בייצוא. רשימת הגרסאות המלאה נמצאת ב־pubspec; אין צורך לשכפל כאן את כל חבילות pub.dev.
המארח באפליקציה, הוולידטור ב־CI ואתר החנות צריכים להסכים על המתודות, הרשאות ודרישות גרסה. מקור הנתונים המשותף הוא docs/plugin-sdk/spec.json, המחולל מקוד האפליקציה.
| מקום | עותק או פקודת סנכרון |
|---|---|
| האפליקציה | dart run tool/plugins/generate_plugin_spec.dart |
otzaria-plugin-validator |
src/spec.json, מתעדכן באמצעות npm run sync:spec
|
Otzaria_Website |
src/lib/pluginSdkSpec.js, מתעדכן באמצעות npm run sync:plugin-spec
|
יש לדחוף את שינוי המפרט למאגר אוצריא לפני שרענון הצרכנים מושך אותו. לכלי ה־JS יש עותק מצורף, ואחזור מהרשת יכול להרחיב את המשטח המוכר; אין עוד תלות בפרסור טבלאות Markdown כדי לדעת מהו API תקף.
המפרט מעביר נתונים וכללים מסוימים. שינוי באלגוריתם, למשל בדרך הנרמול של מפתח הגדרה חסום, עשוי לדרוש שינוי קוד גם בוולידטור ובאתר. כללי רשת מסוימים נשארים מחוץ למפרט. סדר העבודה המלא מופיע ב־SPEC.md.
המאגר משתמש בגרסאות נעוצות של כמה חבילות מתוחזקות. יש לבדוק את ההערות ב־pubspec לפני החלפתן בחבילה הרשמית.
| מאגר | תחום |
|---|---|
| Otzaria/pdfrx | צפייה ב־PDF |
| Otzaria/flutter_inappwebview | WebView ותוספים, עם רכיבי פלטפורמה תואמים |
| Otzaria/window_manager | חלונות שולחן עבודה |
| Otzaria/flutter_local_notifications | התאמות התראות ב־Windows |
| Otzaria/sentry-dart | דיווח ואבחון, כולל אתחול נייטיבי |
| Otzaria/dart_pdf | חבילת printing והדפסה |
| Otzaria/flutter_widget_from_html | רינדור HTML |
ה־ref הנעוץ, והסיבה לכל override, מתועדים ליד התלות. אין לראות ברשימה הזאת המלצה להשתמש תמיד בגרסה האחרונה של כל fork; האפליקציה נבדקת עם שילוב גרסאות מסוים.
packages/otzaria_context_menu מחזיקה תשתית תפריטים. packages/otzaria_report_contract מחזיקה חוזה דיווחים משותף. אלה חבילות מקומיות בתוך מאגר האפליקציה, וה־CI מריץ להן בדיקות נפרדות. שינוי בהן צריך להתחשב בצרכנים שלהן, גם כאשר הקובץ לא נמצא תחת lib/.
| הבעיה | נקודת התחלה |
|---|---|
| התנהגות מסך, פתיחת ספר או שמירת נתוני משתמש | מאגר האפליקציה |
| תוכן ספרייה או יצירת מסד ההפצה | מאגר הספרייה, או מסלול דיווח טעות מתוך התוכנה |
| תוצאת מנוע או מבנה אינדקס | האפליקציה ומנוע החיפוש, לפי מקום הכשל |
| API תוסף נדחה למרות שהמארח מכיר אותו | מפרט SDK ועותקי הוולידטור/חנות |
| כשל נייטיבי של PDF, WebView או חלון | האפליקציה והתלות הנעוצה המתאימה |
דף הבית · התחלת העבודה · שאלות נפוצות · פתרון תקלות
מדריך המשתמש נבדק מול גרסה 0.9.98.3+809; פרטי גרסאות ומועד הבדיקה בדף הבית.
התחלה מהירה
קריאה וחיפוש
אישי ותחזוקה
- כרטיסיות ושולחנות
- סימניות והערות
- ספרים אישיים
- מסדים אישיים
- גיבוי ושחזור
- הגדרות
- עדכונים
- תוספים
- כלים
- קישורים ישירים
תיעוד למפתחים
יסודות
נתונים
קריאה
חיפוש
מערכת
ממשק