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

חיפוש ב-Marketplace

מחפשים ב-Ingot Store וב-Open VSX בבת אחת מתוך Ingot: רשימה אחת עם תג לכל מקור, ו-Install להרחבות ‎.vsix מהחיפוש או מקובץ.

Beta ‏ה-Marketplace הוא פיצ'ר אופציונלי, והוא כבוי עד שמפעילים אותו. הוא שואל בבת אחת את כל המקורות שהפעלתם, מציג כל הרחבה פעם אחת גם כשכמה מקורות מחזיקים אותה, ומתקין הרחבות ‎.vsix סטנדרטיות בלי לצאת מה-IDE.

הלשונית Marketplace ב-Ingot: חיפוש prettier עם תוצאות מ-Ingot Store,‏ Open VSX ו-Microsoft Marketplace, שורה אחת לכל הרחבה עם תג לכל מקורהלשונית Marketplace ב-Ingot: חיפוש prettier עם תוצאות מ-Ingot Store,‏ Open VSX ו-Microsoft Marketplace, שורה אחת לכל הרחבה עם תג לכל מקור
הלשונית Marketplace ב-Ingot: חיפוש prettier עם תוצאות מ-Ingot Store,‏ Open VSX ו-Microsoft Marketplace, שורה אחת לכל הרחבה עם תג לכל מקור

הפעלה

את ה-Marketplace אפשר למצוא בשלוש דרכים, כמו כל פיצ'ר אופציונלי:

  • הצעה בצ'אט. כשמבקשים הרחבה או פלאגין ("install a prettier extension",‏ "find a plugin for…",‏ "add this .vsix"), כרטיס קטן מעל תיבת הצ'אט מציע Enable Marketplace. הוא מפעיל את ה-Marketplace, פותח אותו ומחפש את מה שביקשתם. ‏**×** מסתיר את הכרטיס לתמיד.
  • הגדרות › Features › Marketplace (Beta). מתג הפעלה. כיבוי סוגר את הלשונית; שום דבר שהתקנתם לא מוסר.
  • הכפתור Marketplace בשורת המצב. לחיצה אחת מפעילה את ה-Marketplace ופותחת אותו.
כרטיס ההצעה של ה-Marketplace מעל תיבת הצ'אט של Ingot, עם Enable Marketplace וכפתור סגירהכרטיס ההצעה של ה-Marketplace מעל תיבת הצ'אט של Ingot, עם Enable Marketplace וכפתור סגירה
כרטיס ההצעה של ה-Marketplace מעל תיבת הצ'אט של Ingot, עם Enable Marketplace וכפתור סגירה
הלשונית Marketplace ב-Ingot, שנפתחה מהכפתור Marketplace בשורת המצבהלשונית Marketplace ב-Ingot, שנפתחה מהכפתור Marketplace בשורת המצב
הלשונית Marketplace ב-Ingot, שנפתחה מהכפתור Marketplace בשורת המצב
הגדרות Ingot, העמוד Features: ‏Suggest features in chat והמתג Marketplace (Beta)הגדרות Ingot, העמוד Features: ‏Suggest features in chat והמתג Marketplace (Beta)
הגדרות Ingot, העמוד Features: ‏Suggest features in chat והמתג Marketplace (Beta)

חיפוש

הלשונית Marketplace ריקה: תיבת החיפוש, Install from VSIX והמתגים של המקורות Ingot Store,‏ Open VSX ו-Microsoft Marketplaceהלשונית Marketplace ריקה: תיבת החיפוש, Install from VSIX והמתגים של המקורות Ingot Store,‏ Open VSX ו-Microsoft Marketplace
הלשונית Marketplace ריקה: תיבת החיפוש, Install from VSIX והמתגים של המקורות Ingot Store,‏ Open VSX ו-Microsoft Marketplace

מקלידים בתיבת החיפוש; התוצאות מגיעות תוך כדי הקלדה (Enter מחפש מיד). הצ'יפים מתחת לתיבה הם המקורות:

מקורמה יש בופעיל כברירת מחדל
Ingot Storeערכות נושא של Ingot, חבילות כללים, חבילות הרגלים ושרתי MCP ‏(Store)כן
Open VSXהמאגר הפתוח של הרחבות ‎.vsixכן
Microsoft Marketplaceחנות ההרחבות של Microsoft. ראו ה-Microsoft Marketplaceלא

לחיצה על צ'יפ מפעילה או מכבה את המקור. אחרי חיפוש כל צ'יפ מראה כמה תוצאות הוא החזיר, או failed עם הסיבה כשלא הצלחנו להגיע למקור; שאר המקורות ממשיכים להציג תוצאות.

  • שורה אחת לכל הרחבה. תוצאות עם אותו מזהה (publisher.name, בלי הבדל בין אותיות גדולות לקטנות) מכמה מקורות מתאחדות לשורה אחת, עם תג לכל מקור שמחזיק אותה. לחיצה על תג פותחת את עמוד ההרחבה באותו מקור.
  • סדר. התאמה מדויקת של מזהה או שם באה ראשונה, ואחריה תוצאות שמדורגות גבוה באחד המקורות.
  • כל שורה מציגה שם, מזהה, גרסה, מפרסם (עם סימון למפרסמים מאומתים), מספר התקנות ותיאור, ו-Installed 1.2.3 כשההרחבה כבר מותקנת.
  • מקלדת. ‏↓ מתיבת החיפוש נכנס לרשימה, ‏↑ ו-↓ זזים בין השורות, ו-Enter מפעיל את הכפתור של השורה.

התקנה והסרה

כפתור בשורהמתימה הוא עושה
Installהרחבות מ-Open VSX או מ-Microsoft Marketplace‏Ingot מוריד את ה-‎.vsix, בודק אותו ומתקין אותו כמו כל הרחבה אחרת. היא מוכנה מיד
Uninstallהרחבות שהתקנתםמסיר את ההרחבה
Add to Projectחבילות כללים מ-Ingot Storeכותב את קובץ החבילה (למשל .ingot/rules/code-style.md) לתיקיית הפרויקט הראשונה. קובץ שכבר קיים לא נדרס לעולם
Open in Storeפריטים אחרים מ-Ingot Store (ערכות נושא, שרתי MCP)פותח את עמוד הפריט בחנות, ושם מתקינים אותו

לפני ההתקנה Ingot בודק שההורדה היא באמת חבילת הרחבה: ב-extension/package.json שבתוכה צריך להיות אותו מזהה שלחצתם עליו, הקובץ צריך להיות קטן מ-200MB, וההורדות חייבות להשתמש ב-‎https:// (‏http:// רק ל-localhost). קובץ שלא עובר בדיקה לא מותקן לעולם, וההודעה מתחת לצ'יפים מסבירה למה. הרחבות שהיו מחליפות את מסגרת החלון של Ingot מציגות Blocked במקום Install; ראו הרחבות shell חסומות.

שורה ב-Marketplace אחרי Install: ‏Installed 1.2.0 ליד שם ההרחבה וכפתור Uninstall, עם הודעת התוצאה מעל הרשימהשורה ב-Marketplace אחרי Install: ‏Installed 1.2.0 ליד שם ההרחבה וכפתור Uninstall, עם הודעת התוצאה מעל הרשימה
שורה ב-Marketplace אחרי Install: ‏Installed 1.2.0 ליד שם ההרחבה וכפתור Uninstall, עם הודעת התוצאה מעל הרשימה

התקנה מקובץ ‎.vsix

‏Install from VSIX… ליד תיבת החיפוש (או Install Extension from VSIX… ב-Find Action) בוחר קובץ ‎.vsix מהמחשב, בודק אותו באותה דרך ומתקין אותו. זה שימושי להרחבות שהחברה שלכם בונה או מפיצה מחוץ למאגר.

ה-Microsoft Marketplace

תנאי השימוש של Visual Studio Marketplace של Microsoft מתירים להשתמש בהרחבות שלו רק עם מוצרים של Microsoft. ‏Ingot אינו מוצר של Microsoft, ולכן המקור הזה כבוי כברירת מחדל והפעלתו היא החלטה שלכם. ב-Open VSX יש את רוב אותן הרחבות.

כשלוחצים על הצ'יפ Microsoft Marketplace, ‏Ingot מציג קודם את ההערה הזו בתוך הלשונית (בלי חלון קופץ). ‏Turn On Anyway מפעיל את המקור ומחפש שוב; ‏Keep Off משאיר אותו כבוי. כל עוד הוא פעיל, שורה מעל התוצאות מזכירה זאת, עם Turn Off. אפשר לשנות את זה גם ב-הגדרות › Plugins.

הערת התנאים של Microsoft Marketplace בלשונית Marketplace, עם Read the terms,‏ Turn On Anyway ו-Keep Offהערת התנאים של Microsoft Marketplace בלשונית Marketplace, עם Read the terms,‏ Turn On Anyway ו-Keep Off
הערת התנאים של Microsoft Marketplace בלשונית Marketplace, עם Read the terms,‏ Turn On Anyway ו-Keep Off

הגדרות

המתג נמצא ב-הגדרות › Features; המקורות ב-הגדרות › Plugins, ליד Open Marketplace (Beta)….

הגדרהברירת מחדלמה היא עושה
ingot.marketplace.enabledfalse‏Marketplace (Beta): מציג את הלשונית Marketplace ואת הכפתור שלה בשורת המצב
ingot.marketplace.sources.ingotStoretrue‏Search the Ingot Store: מחפש ב-Ingot Store
ingot.marketplace.sources.openVsxtrue‏Search Open VSX: מחפש ב-Open VSX
ingot.marketplace.sources.microsoftMarketplacefalse‏Search the Microsoft Marketplace. כבוי כברירת מחדל בגלל התנאים של Microsoft (ראו למעלה)
ingot.marketplace.openVsxUrlריק‏Open VSX URL: שרת Open VSX אחר, למשל של החברה שלכם. ריק פירושו https://open-vsx.org
הגדרות Ingot, העמוד Plugins: ‏Open Marketplace (Beta), שלושת מתגי המקורות ו-Open VSX URLהגדרות Ingot, העמוד Plugins: ‏Open Marketplace (Beta), שלושת מתגי המקורות ו-Open VSX URL
הגדרות Ingot, העמוד Plugins: ‏Open Marketplace (Beta), שלושת מתגי המקורות ו-Open VSX URL

ה-Ingot Store הוא החנות של שרת החשבונות שאליו אתם מחוברים. למראות ולבדיקות, משתני הסביבה INGOT_STORE_URL,‏ INGOT_MARKETPLACE_OPENVSX_URL ו-INGOT_VSCODE_MARKETPLACE_URL משנים את כתובות המקורות גם ב-IDE וגם ב-CLI.

מקלדת

פעולהFind Actionקיצור (macOS / Windows ו-Linux)
פתיחת ה-Marketplace (מפעיל אותו)Marketplace: Open Marketplace (Ingot Store, Open VSX)⌥⌘X / Ctrl+Alt+X
חיפוש הרחבהMarketplace: Search Extensions…⌥⌘M / Ctrl+Alt+M
התקנת קובץ ‎.vsixMarketplace: Install Extension from VSIX…⌥⌘V / Ctrl+Alt+V
הצגה או הסתרה של הלשוניתMarketplace: Show or Hide Marketplaceאין

מהטרמינל

‏ingot extensions (בקיצור: ingot ext) מריץ את אותו חיפוש ואותה התקנה מה-CLI:

npx @ingotide/cli extensions search prettier                       # Ingot Store + Open VSX, one list
npx @ingotide/cli extensions search prettier --microsoft-marketplace  # also the Microsoft Marketplace (see its terms)
npx @ingotide/cli extensions install rust-lang.rust-analyzer        # downloads the .vsix into Ingot's extensions folder
npx @ingotide/cli extensions install ./my-tool-1.0.0.vsix          # a local file
npx @ingotide/cli extensions inspect ./my-tool-1.0.0.vsix          # id, version and engine, without installing
npx @ingotide/cli extensions sources                               # each source, its URL and whether it is on

‏install שם את ה-‎.vsix בתיקיית ההרחבות של Ingot ‏(INGOT_EXTENSIONS_DIR, אחרת ~/.ingot/extensions); ‏Ingot מתקין אותו בפעם הבאה שהוא עולה.