מדריך ה-CLI
כל פקודה של xuda-cli, כל שדה של xuda.config.js, ומה סנכרון הענן יכול לעשות היום.
xuda-cli הוא שלוש פקודות, ועוד עזרה. אף אחת מהן לא מקבלת דגל: כל ארגומנט נוסף הוא שגיאה קשה, וכל הגדרה נמצאת ב-xuda.config.js.
פקודות
dev מריץ את האפליקציה בלי שום חיבור לענן: הוא עונה בעצמו על קומץ נקודות קצה מקומיות כדי שלאפליקציה יהיה כל מה שהיא צריכה, ובמצב המבודד הזה הוא גם מטפל מקומית בארבע פעולות הקריאה והכתיבה של טבלאות. כל דבר אחר מועבר למעלה כשמוגדר מפתח API, ונדחה עם הודעה ברורה כשלא.
xuda.config.js
רינדור בצד השרת
מגדירים ssr ל-first_page כדי לרנדר בשרת את תוכנית הכניסה ולהעביר ממנה ללקוח, או ל-full כדי לרנדר בשרת את האפליקציה ולהחיות אותה בצד הלקוח. משאירים none כדי לרנדר כולו בדפדפן.
מגדירים את המצב
עורכים את ssr ב-xuda.config.js.
מפעילים מחדש את dev
npm run dev צריך הפעלה מחדש אחרי שינוי של SSR.
מאשרים את המטען
ה-CLI מרנדר את תוכנית הכניסה למחרוזת בהקשר מבודד, מזריק את הסימון למעטפת, ומעביר ללקוח מטען רינדור להמשיך ממנו.
מפתחות API
פותחים מפתחים, ואז את הלשונית מפתחות API בדשבורד, ולוחצים על יצירת מפתח. נותנים שם למפתח, אפשר להגביל דומיינים מורשים, ובוחרים מצב גישה.
מפתח עם הגישה המתאימה יכול לקרוא היום ישירות דרך HTTP לשיטות הנתונים של האפליקציה: dbs_read, dbs_create, dbs_update ו-dbs_delete. ראו JavaScript Framework למבנה הבקשה.
סנכרון ענן
המטרה של sync היא למשוך את מסמכי הפרויקט בענן לקובצי מקור מקומיים ולדחוף שינויים מקומיים בחזרה. הוא מריץ בדיקת תנאי מקדים שמאשרת שארבע שיטות של הפלטפורמה ניתנות לקריאה לפני שהוא עושה משהו אחר:
get_app_system_api_methods, get_app_api_keys, get_project_docs, update_app_info_doc_to_db_couch.
שתיים מהן הן שיטות של סשן דשבורד שמעצם התכנון אף פעם לא מופיעות ברשימת הקטלוג שהבדיקה קוראת, ושתי האחרות כלל לא רשומות כשיטות פלטפורמה שניתן לקרוא להן, ולכן הבדיקה לא עוברת מול קטלוג השיטות הנוכחי. בנפרד, כל דבר שצריך api_key ב-CLI, כולל העברה למעלה ו-sync עצמו, טוען מהדיסק מודולי פלטפורמה שהתקנת npm שפורסמה של ה-CLI לא כוללת.
מתייחסים ל-dev כאל ערכת הכלים המקומית ומשתמשים ב-Studio כדי להכניס עבודת פרויקט לפרויקט בענן. שום דבר מזה לא משפיע על פיתוח מקומי: dev, רענון חי, SSR ותוספים עובדים בלי שום חיבור לענן.
כש-sync כן מריץ את הרצף המלא שלו, הוא: מוודא שהאפליקציה חושפת את שיטות ה-CPI הנדרשות, מוודא שמפתח ה-API הנוכחי יכול להשתמש בהן, מוריד מסמכים מרוחקים אל node_modules/.project_data/, יוצר קובצי מקור מקומיים חסרים מהמסמכים האלה (קבצים מקומיים קיימים אף פעם לא נדרסים), מקמפל מחדש מקור מקומי אל node_modules/.project_data/, ומעלה לענן מסמכים ששונו.
פתרון בעיות
תוכניות וגבולות
הפריימוורק עצמו חינמי: פיתוח מקומי בכל אחת משתי דרכי הכתיבה אף פעם לא קורא לשיטה שמוגבלת בתוכנית, חבילות ה-CLI מפורסמות בגלוי ב-npm, ומפתחות API חינמיים בלי קשר למצב הגישה. מה שתוכנית חשבון קונה הוא פריסה, שאינה זמינה בתוכנית Free וזמינה מ-Pro ומעלה.