ניהול גרסאות
הגרסה של תוסף היא השוואת מחרוזות פשוטה בין מסמך הקטלוג למה שפרויקט התקין, אין התאמת טווחי semver.
הגרסה של תוסף נמצאת בשני מקומות: doc.version במסמך הקטלוג (הגרסה האחרונה שהועלתה),
ו-app_plugins_purchased[plugin_name].version בכל פרויקט שהתקין אותו (הגרסה
שהפרויקט הזה באמת מחזיק). שום דבר לא שומר אותם מסונכרנים אוטומטית.
מאיפה הגרסה באה
upload_plugin קובעת את doc.version באופן שונה בהתאם למקום שבו החבילה נמצאת:
- מקור חבילה
npm: נקרא ישירות מהרישום עםgetPackageManifest(plugin_name), ולכן זה מה ש-npm versionהפיק כשהמחבר הריץ לאחרונהnpm publish. בכלpackage.jsonשל תוסף של Xuda עצמה יש סקריפטpubלזה:npm version patch --force && npm publish --access public. - מקור חבילה
xuda_hosted(בלי פרסום ב-npm, עותק העבודה נארז ומתארח על ידי הפלטפורמה עצמה):doc.versionהוא מה שנשלח בבקשה, או0.1.0אם לא נשלח דבר.
install_plugin מעתיקה את doc.version אל הרשומה app_plugins_purchased של הפרויקט ברגע
ההתקנה. upload_plugin מאוחרת יותר שמעלה את הגרסה במסמך הקטלוג אינה נוגעת
בפרויקטים שכבר התקינו גרסה קודמת, הם שומרים את הגרסה שהתקינו עד שמשהו
מתקין מעליה את החדשה.
איך התקנה מיושנת מוצגת
אין עדכון אוטומטי. מה שקיים הוא השוואה חזותית: תג הגרסה בכרטיס התוסף
משווה את app_plugins_purchased[plugin_name].version (מה שמותקן) מול
ה-version של מסמך הקטלוג (העדכנית ביותר), ומציג את המספר המותקן בירוק כשהם תואמים
ובענבר כשלא. שום דבר לא מכריח התקנה מחדש, בעלים (או מתקין)
שמריץ שוב install_plugin באותו פרויקט הוא מה שמושך פנימה את הגרסה החדשה, אותה קריאה
שמשמשת להתקנה הראשונה.
עדכון תוסף שבבעלותכם
הכפתור עדכון עם AI בדשבורד, שמוצג בכרטיס של תוסף לבעלים שלו, לא מעלה את
הגרסה בעצמו. הוא פותח את עוזר ה-AI כשהוא מוזן מראש עם metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } והנחיה שמציינת את התוסף
(updateWithAi() ב-Tab_plugins.vue), שמפעילה את בונה התוספים של ה-AI
(ai_module.create_plugin_via_ai, אותו מחולל ש-utils/create_plugin_via_ai.mjs קורא לו
ישירות) כדי לערוך את הקוד של התוסף ולהעלות אותו מחדש, ההעלאה הזו היא שמקדמת את doc.version.
upload_plugin מתייחסת לכל עדכון שבו visibility כבר 'private', או
ש-skip_publish_review מוגדר, כשינוי קוד פרטי: היא מעבירה הלאה את ה-visibility
וה-publish_stat הקיימים של התוסף בלי לגעת בהם, ולא מגישה אותו מחדש לבדיקה בזירת המסחר.
מעבר מפרטי לציבורי הוא תמיד רק publish_plugin, פעולה נפרדת ומפורשת;
ראו פרסום.