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

הריפואים של אוצריא

אוצריא נשענת על מאגר האפליקציה, מאגר הספרייה, חבילות ושירותי הפצה. דף זה ממפה את הקשרים החשובים למפתח לפי 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.

Fork-ים שנצרכים במפורש

המאגר משתמש בגרסאות נעוצות של כמה חבילות מתוחזקות. יש לבדוק את ההערות ב־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 או חלון האפליקציה והתלות הנעוצה המתאימה

דפים קשורים

מקורות בקוד

Clone this wiki locally