Plugins
תוספים לסביבת העבודה ולאפליקציות שלכם.
לתוספים יש שש שיטות ציבוריות. הן מפרטות תוספים ומנהלות את התוספים שרצים עם פרויקט בשרתים של Xuda, הפס השני של דף התוספים. כל אחת פועלת עבור החשבון שמפתח ה-API שלו משתמשים בו.
הוספת תוסף לשרת של סביבת העבודה, בנייה שלו, הרצה שלו והגדרת המפתחות שלו נעשות בלוח הבקרה. כיום אין להן שיטה ציבורית, ו-install_plugin דוחה תוסף שרץ רק על שרת של סביבת עבודה.
שולחים בקשה לשיטה עם המפתח שלכם. זו מפרטת את הווידג'טים של זירת המסחר:
לתשובה תקינה יש code 1. לתשובה שנדחתה יש code שלילי, והיא אומרת מדוע ב-data.
למצוא תוספים
get_pluginsמפרטת את התוספים בזירת המסחר. היא מקבלתplugin_idאופציונלי (המזהה המלא, עם הקידומת@xuda.io/שלו) אוid(בלעדיה),category(סוג תוסף),limit(9999 אם לא צוין) ו-skipלדפדוף. התוספים הפרטיים שלכם מופיעים ברשימה עבורכם ועבור אף אחד אחר.get_plugins_categoriesמפרטת את סוגי התוספים. היא לא מקבלת שדות.get_app_pluginsמפרטת את התוספים שמותקנים באפליקציה. היא מקבלתapp_idו-plugin_type_filterאופציונלי.
להתקין ולהסיר תוסף של פרויקט
ההתקנה דורשת קודם הסכמה לתנאים של התוסף, כמו בלוח הבקרה.
- קוראים ל-
get_install_consentעםitem_kindשנקבע ל-pluginועםplugin_name. היא מחזירה את התנאים ו-content_hash. - קוראים ל-
install_pluginעםapp_id,plugin_nameו-consent, אובייקט עםaccepted, עם ה-content_hashשקיבלתם ועםlocale. בלי הסכמה תקפה ההתקנה נדחית ושום דבר לא נכתב.
install_plugin מקבלת גם consent_source (באיזה מסך ההסכמה התקבלה, לרשומת הביקורת בלבד), validate_free (כשהוא true, תוסף עם מחיר נדחה) ו-version (לעדכון, הגרסה שהוצעה לכם: גרסה שאינה האחרונה נדחית).
uninstall_plugin מקבלת app_id ו-plugin_name ומסירה את התוסף מהאפליקציה. היא לא שואלת שוב.
להעלות תוסף פרטי
upload_plugin שומרת חבילת תוסף. היא קוראת מהגוף את data.plugin_name ו-data.plugin_type (אחד מ-dbs, widget, graphics, library, platform, framework, util, ui), עם data.package_source (npm, ברירת המחדל, או xuda_hosted עם data.package_url) ו-data.visibility. קובעים את data.visibility ל-private כדי להשאיר אותו מחוץ לזירת המסחר.
העלאה פרטית דורשת את חברות Agency או את התוכנית Plugins Pro של סביבת העבודה. הצבת תוסף בזירת המסחר נשארת בחברות Agency. אפשר לעדכן רק תוסף שהחשבון שלכם העלה.