בתיקייה הזו נמצאת האפליקציה השלמה. שישה קבצים, כולם חייבים להישאר יחד באותה תיקייה.
| קובץ | תפקיד |
|---|---|
index.html |
האפליקציה עצמה |
manifest.webmanifest |
מגדיר שם, צבעים ואייקון |
sw.js |
מאפשר עבודה גם בלי חיבור לאינטרנט |
icon-192.png, icon-512.png, icon-maskable.png |
האייקון |
apple-touch-icon.png |
האייקון באייפון ובאייפד |
כדי שאפשר יהיה להתקין את האפליקציה, הקבצים צריכים להיות בכתובת אינטרנט. שתי דרכים חינמיות:
- להיכנס ל־
app.netlify.com/drop - לגרור את התיקייה כולה אל תוך החלון
- תוך שניות מתקבלת כתובת קבועה, למשל
rambam-library.netlify.app
- ליצור מאגר חדש ולהעלות את כל הקבצים
- Settings ← Pages ← Source:
main, תיקייה/root - הכתובת מתקבלת אחרי כדקה
חשוב: ההתקנה עובדת רק בכתובת https. שתי האפשרויות למעלה נותנות את זה אוטומטית.
במחשב (Chrome או Edge): נכנסים לכתובת, ובשורת הכתובת מופיע אייקון התקנה קטן. לוחצים עליו, והאפליקציה נפתחת בחלון נפרד עם אייקון בשולחן העבודה. אפשר גם דרך הכפתור "התקנת האפליקציה" בתחתית הדף.
באנדרואיד: נכנסים בכרום ← תפריט שלוש הנקודות ← "הוספה למסך הבית".
באייפון ובאייפד: נכנסים בספארי (חובה ספארי) ← כפתור השיתוף ← "הוספה למסך הבית".
אחרי ההתקנה האפליקציה נפתחת כמו כל אפליקציה אחרת, בלי שורת כתובת, ועובדת גם כשאין אינטרנט.
הנתונים נשמרים על המכשיר שבו עובדים, לא בענן. כלומר:
- המחשב בספרייה והטלפון של הספרנית הם שתי רשימות נפרדות
- כדי לעבור בין מכשירים, משתמשים בכפתורים "שמירת גיבוי לקובץ" ו"שחזור מגיבוי"
מומלץ ללחוץ על "שמירת גיבוי לקובץ" בסוף כל שבוע ולשמור את הקובץ בגוגל דרייב או במייל.
אם בעתיד תרצו שכמה מחשבים יראו את אותם הנתונים בזמן אמת — או שתלמידים יוכלו לחפש ספרים מהבית — זה שינוי גדול יותר שדורש שרת. אפשר לעשות את זה, וכדאי לדבר על כך בנפרד.
אחרי העלאת גרסה חדשה, יש לשנות בקובץ sw.js את השורה הראשונה:
const CACHE = "rambam-library-v2"; // v1 ← v2בלי השינוי הזה, מכשירים שכבר התקינו ימשיכו להציג את הגרסה הישנה.