🇬🇧 English

ניתן להתקין את NavAid כ־PWA ב־iOS, Android ושולחן עבודה. לאחר טעינה מקוונת, ה־service worker מגיש את קבצי האפליקציה והנתונים שנשמרו. מאגר נקודות הניווט נקבע לפי השכבה (cvfr-route-graph.json, lsa-route-graph.json או heli-route-graph.json). ממנו היישום גוזר נקודות דיווח, גבהי קטעים ונקודות חילופי תדר.

כשהחיבור חוזר NavAid מתעדכן מיד ולא רק בבדיקה הבאה: אריחי מפה שנכשלו בלי חיבור נטענים מחדש, NOTAM / SIGMET / AIRMET ומזג האוויר נטענים שוב, והודעה אומרת החיבור חזר: המפה, הנוטאמים ומזג האוויר עודכנו. זה תלוי באות החיבור של הטלפון, כך שב-Wi-Fi בלי אינטרנט הוא יכול להגיע מוקדם; הבדיקה הקבועה כל 10 דקות ממשיכה.

מה "לא מקוון" כולל בדיוק. המתכנן עובד בלי רשת — התרשים שהורדתם, המסלול, יומן הניווט והדפים שכבר פתחתם. מה שדורש חיבור הוא כל מה שמישהו אחר מפרסם בזמן שאתם טסים: מזג אוויר, NOTAM, תעבורה, שכבות הלוויין ומפת הרחובות, ודפי שדה שלא נפתחו קודם. בעבר נכתב כאן פועל לגמרי ללא רשת אחרי הטעינה, וזה היה יותר ממה שהמוצר עושה.

המפה שאיתה טסים כבר אינה משהו שצריך לזכור להוריד. באתר החי NavAid שומרת את כל מפת ה-CVFR במכשיר אוטומטית — זומים 7–13, הגיליון כולו, לא רק החלק שבמקרה הסתכלתם עליו. בכל הפעלה היא בודקת מה כבר שמור ומורידה רק את החסר.

• היא ממתינה לחיבור מתאים. כש-offlineCvfrUnmeteredOnly פעיל (ברירת מחדל), ההורדה האוטומטית נמנעת ברשת סלולרית, בחיבור שמדווח 2G/3G, וכשמצב חיסכון בנתונים פעיל. הסטטוס אז מציג ממתין לחיבור.
• המסלול קודם. אריחים במרחק של כ-1.5 אריחים מהמסלול המתוכנן נמשכים לפני שאר הארץ, תוך שמירת הסדר מזום רחב לצר בתוך כל קבוצה. שינוי המסלול מסדר את התור מחדש סביב החדש — כך שהמסדרון שעומדים לטוס בו מושלם ראשון, גם אם ההורדה נקטעת.
• רק בייצור. תצוגות מקדימות של PR, staging והרצות מקומיות לעולם אינן מתחילות העברה גדולה; הן חולקות את אותו origin ומטמון, ותצוגה מקדימה אסור שתשנה את החבילה האמיתית של טייס. הכפתור הידני עדיין עובד שם.

בקטע מפות יש כפתור סטטוס מקוצר — CVFR לא מקוון: בודק… / מוכן ✓ / ⬇ הורדת CVFR — 62%. הוא פותח את חלון מפות לא מקוונות, שמציג כמה אריחים שמורים מול כמה נדרשים, סרגל התקדמות ושתי פעולות:

פעולה	מה היא עושה
⬇ הורדת אריחי CVFR חסרים	מושכת רק את מה שחסר, עכשיו, ללא תלות בסוג החיבור
מחיקת CVFR לא מקוון	מסירה את המפה השמורה מהמכשיר. התחזוקה האוטומטית מתחדשת בפתיחה הבאה

לחיצה על הכפתור המקוצר כשהכיסוי אינו שלם גם מתחילה את ההורדה, לא רק פותחת את החלון.

מתחת לכרטיס ה-CVFR החלון מציג כל מפה אחרת שאפשר לשמור, ואפשר לשמור כמה שרוצים בבת אחת:

מפה	מה נשמר
ניווט · גובה נמוך · מסוקים	המפה כולה, באותם זומים כמו CVFR. ⬇ הורדה, ואז פס התקדמות, הורדת האריחים החסרים ומחיקה
נתיבי ATS	תמונה אחת, נשמרת במטמון של האפליקציה (בתוך האפליקציה בגרסאות App Store / APK)
OpenFlightMaps	האזור שעל המסך. בוחרים רמת פירוט — עד זום 8, 9, 10, 11 או 12 — כל אחת עם מספר האריחים והגודל המשוער; רמות מעל 80,000 אריחים מעומעמות. רוב אירופה נכנסת עד זום 10 בכ-1GB. שומרים כמה אזורים שרוצים, לכל אחד התקדמות ומחיקה משלו. מעומעם, עם הסיבה, מעל ישראל (אין נתונים) או לאזור שכבר נשמר ברמה הזו

ההורדות רצות במקביל. מחיקת חבילה אחת לעולם לא מסירה אריח שחבילה אחרת עדיין משתמשת בו, וניקוי CVFR משאיר את שאר החבילות. חבילות שבחרתם והורדתן נקטעה מושלמות בחיבור המתאים הבא, באותם תנאים כמו CVFR.

בחיבור בלבד: לוויין ו-OpenStreetMap. הספקים שלהן אינם מתירים הורדה לשימוש לא מקוון (מדיניות האריחים של OpenStreetMap אוסרת זאת במפורש), והחלון אומר זאת.

מפת העולם לא צריכה הורדה. קווי המתאר ושמות המדינות הם חלק מהאפליקציה ומצוירים תמיד מתחת לכל מפה — ראו שכבות מפה. בלי חיבור ובלי חבילה, המפה עדיין מראה איפה אתם.

האחסון נמצא במטמון הייעודי navaid-tiles-v1, שממולא על ידי offline-tiles.js מהמראה התומכת CORS. ה-service worker מגיש בקשת אריח תואמת מהמטמון תחילה כשהחבילה מכילה אותה, ופונה לרשת במקרה של miss. החבילה שורדת שדרוגי service worker ונמחקת רק דרך מחיקת CVFR לא מקוון או בכלי אחסון הדפדפן.

מפתח	ברירת מחדל
offlineAutoCvfr	true	שמירת מפת CVFR זמינה לא-מקוון
offlineCvfrUnmeteredOnly	true	עדכון רק בחיבור מתאים
offlineCvfrMinZoom	7	הזום הרחב ביותר שנשמר
offlineCvfrMaxZoom	13	הזום הקרוב ביותר שנשמר

מטמון האפליקציה נפרד: ניווט HTML הוא network-first עם fallback, ונכסים עם גרסה הם cache-first. ראו Service Worker.

המאגר תומך במעטפת פיתוח מרוחקת ובגרסת iOS ארוזה. לזמינות ב־App Store או ב־TestFlight יש לבדוק את הודעת ההפצה העדכנית של הפרויקט; תמיכה בבנייה אינה מעידה כשלעצמה על זמינות להפצה.

ב־Safari אפשר לבחור הוסף למסך הבית. יש להשאיר את האפליקציה בחזית עבור מיקום והתראות; אין להסתמך על מעקב ברקע או כשהמסך נעול ב־iOS.

לשאלות הפצה: [email protected].

עוד לפני שהגיעו גיליון הסגנון או קוד ה-JS, index.html כבר מצייר את סמל NavAid — נקודת יציאה, הקטע שמטפס ממנה, והמטוס שטס אותו — ומטוס שני, קטן יותר, טס סביבו הקפה. ההקפה היא מעגל אמיתי במישור נטוי מהמצלמה, ולכן הדפדפן מקצר אותה לאליפסה, מקטין את המטוס עם המרחק, ומסתיר אותו מאחורי הסמל בצד הרחוק של הפנייה.

• המסך מוצג לפחות 2 שניות (bootLogoMinMs). כשהמטמון חם המפה מציירת כמה מאות אלפיות שנייה אחרי העמוד, והסמל היה חולף חצי-מצויר. זו רצפה, לא המתנה: מפה איטית עדיין מנקה את המסך ברגע שהיא מגיעה, ופסק זמן של 6 שניות מנקה אותו בכל מקרה.
• ברגע שהמפה מוכנה מאחוריו, המסך מפסיק לקלוט מגע, כך שהנגיעה הראשונה בהפעלה מהירה מגיעה לאפליקציה ולא למסך הטעינה.
• prefers-reduced-motion: reduce משאיר את הסמל ואת ההקפה ועוצר את התנועה.

אותו סמל נוצר לכל האייקונים שמהם מתקינים את האפליקציה — favicon, שני אייקוני ה-PWA (בתוך מעגל הבטיחות של maskable), אייקון המשגר של אנדרואיד בגרסאות ריבוע / עגול / adaptive בחמש צפיפויות, ומסכי הפתיחה — על ידי scripts/make-icons.mjs, מתיאור אחד, כך שהם אינם יכולים להתפצל זה מזה.

התקנה. ה־APK נמצא ב־GitHub Releases (android-v*). פותחים אותו ומאשרים התקנת אפליקציות לא מוכרות; APK חדש מותקן מעל הישן ושומר את המסלולים — אל תסירו קודם, זה מוחק אותם. עם Obtainium מקבלים הודעה על כל גרסה חדשה (ראו README).

עולה בלי רשת בכלל. מאז 1.9 כל האפליקציה בתוך ה־APK, יחד עם:

• מפת ה־CVFR ברמות 7–12 (כ־1,500 אריחים) — בהפעלה הראשונה הם גם מועתקים למאגר המפות הלא־מקוונות; רמה 13 עדיין בהורדה ב־Wi-Fi;
• ההגדרות של היום — עותק של ה־gist החי מרגע בניית ה־APK, כך שטלפון שמעולם לא היה מחובר עולה איתן (ואחריו העותק האחרון שהטלפון הוריד, ואז ה־gist החי, כל אחד גובר על קודמו).

היא מוגשת בכתובת https://navaid.supino.org בתוך הטלפון, כך שמסלולים, הקלטות והגדרות שנשמרו ב־APK הישן (שטען את האתר) הם אותם אלה. דפי הגישה נטענים מ־GitHub; ה־service worker הישן מוסר.

עדכונים בלי APK חדש. כל פריסה מפרסמת חבילת עדכון. האפליקציה מורידה אותה לבד ב־Wi-Fi ועוברת אליה בהפעלה הבאה — לעולם לא באמצע טיסה; חבילה שלא עולה מוחזרת לקודמת. עדכונים ממתינים עד שהאריחים המובנים הועתקו (העתקה שלא הושלמה, למשל זיכרון מלא, מפסיקה לעכב אותם). הגדרות ← גרסת האפליקציה מציגה את הגרסה ואומרת למה העדכון מחכה:

• מעודכנת (בדוק שוב);
• יש עדכון · 40 MB — יורד מעצמו ב-Wi-Fi, או … אחרי שהעתקת המפות תסתיים מיד אחרי APK חדש (הורד עכשיו לוקח אותו מיד — גם בחבילת גלישה, אחרי שאלה — עם פס התקדמות);
• מוריד… 45%, עם פס ההתקדמות ובלי כפתור — בין אם לחצתם הורד עכשיו ובין אם האפליקציה התחילה מעצמה ב-Wi-Fi; בקשה נוספת בינתיים מצטרפת להורדה הזו ולא מורידה את אותה חבילה פעמיים;
• העדכון מוכן: הפעלה מחדש תוצע כשהמיקום יפסיק להיות מוצג, או בהפעלה הבאה (הפעל מחדש עכשיו).

היא בודקת שוב בכל פעם שמתחברים ל-Wi-Fi — גם מיד אחרי ההפעלה, לפני טיסה — וכשהאפליקציה חוזרת למסך אחרי 30 דקות, לא רק פעם אחת בהפעלה; השורה מתרעננת בכל שינוי רשת, כך שהיא אומרת את מה שנכון עכשיו. APK חדש נדרש רק לשינויים נייטיב.

היא שואלת. כשעדכון הורד, האפליקציה שואלת פעם אחת לכל גרסה: עדכון מוכן — הפעל מחדש עכשיו / אחר כך. הפעל מחדש עכשיו עובר לגרסה החדשה בשתיים-שלוש שניות ושומר את המסלול וההגדרות; אחר כך משאיר אותו להפעלה הבאה. מגרסה 1.23, APK חדש מוכרז באותה דרך, פעם אחת: NavAid 1.24 זמינה — הורד / אחר כך; הורד פותח את דף הגרסה, הדפדפן מוריד אותה, ומתקין האנדרואיד מתקין אותה מעל האפליקציה (כפתור פתח שלו הוא ההפעלה מחדש). אף אחת מהשאלות לא נשאלת בזמן הקלטה, הצגת מיקום או חיבור לסימולטור — היא ממתינה עד שזה נגמר.

גודל גופן. גודל הגופן של הטלפון (הגדרות ← תצוגה) מגדיל את כל הטקסט באפליקציה באותה מידה; כפתורי שמור / המסלולים שלי נערמים אחד בכל שורה כשהמילים כבר לא נכנסות.

GPS ברקע וכניסה מקורית ל־Drive הם חלק מה־APK.

העריכה מקומית כברירת מחדל, אך מידע נשלח כאשר המשתמש מפעיל תכונה: מסלולים והגדרות מורשות ל־Google Drive, prompt/context לספק AI שנבחר, פרטי תכנית טיסה לשירות ההגשה ובקשות לנתוני תעופה/מזג אוויר חיים. בקשות רגילות לנכסי האפליקציה ולמפות חיצוניות מתבצעות לפי הצורך. בנוסף, בזמן הפעלה מתבצעת אוטומטית בקשה לקובץ הגדרות tuning קטן ב־GitHub Gist, אלא אם הכתובת כוללת ?nogist או ?gist=0; הבקשה אינה שולחת מסלול או פרופיל. אתר הייצור הציבורי טוען Google Analytics; אפליקציות נייטיב, staging, תצוגות מקדימות והרצה מקומית מוחרגים. ראו מדיניות הפרטיות. מפתחות API וכתובות יעד נשארים במכשיר. קובצי BYOP ציבוריים ומוגשים ממרחב docs/byop/ היציב.

מעטפת הפיתוח טוענת את האתר החי. ה־APK (למעלה) וגרסת ההפצה ל־iOS אורזים את האפליקציה במכשיר ומושכת מהרשת נתונים וחבילות עדכון מאומתות. קיומו של קוד האריזה במאגר אינו מעיד על זמינות ב־App Store או ב־TestFlight.

שתי השלכות שכדאי להכיר:

• תרשימים לא מקוונים נשמרים שם אחרת. ה-Cache API אינו זמין במקור של האפליקציה עצמה, ולכן אריחי ה-CVFR שהורדו נשמרים בתיקיית האפליקציה דרך תוסף הקבצים, והמפה והזכוכית המגדלת קוראות משם. אותו תרשים, אותה הורדה, בלי service worker.
• עדכוני ווב. הגרסה הארוזה בודקת אם יש חבילת ווב חדשה, מאמתת אותה, ומכינה אותה להפעלה הקרה הבאה — לא באמצע טיסה ולא ברשת סלולרית. חבילה שלא עולה מוחזרת לזו שכן עלתה, ובסוף לזו ש-Apple בדקה. שינויים נייטיביים — תוספים, הרשאות, שדרוג SDK — עדיין דורשים שחרור.