דילוג לתוכן
אומת

ניהול גרסאות

הגרסה של תוסף היא השוואת מחרוזות פשוטה בין מסמך הקטלוג למה שפרויקט התקין, אין התאמת טווחי 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.

עדכון קוד או npm לא חוזר לבדיקה

upload_plugin מתייחסת לכל עדכון שבו visibility כבר 'private', או ש-skip_publish_review מוגדר, כשינוי קוד פרטי: היא מעבירה הלאה את ה-visibility וה-publish_stat הקיימים של התוסף בלי לגעת בהם, ולא מגישה אותו מחדש לבדיקה בזירת המסחר. מעבר מפרטי לציבורי הוא תמיד רק publish_plugin, פעולה נפרדת ומפורשת; ראו פרסום.