مرجع آشکار پسوند

هر پسوند دارای یک فایل مانیفست JSON است که اطلاعات اساسی در مورد پسوند را تعریف می کند. این پرونده همچنین تعریف می کند که چگونه می تواند تجربه را گسترش و تقویت کند. این مقاله به شما نشان می دهد که چگونه می توانید برای پسوند خود به Azure DevOps یک مانیفست ایجاد کنید.

جدیدترین مستندات ما در مورد توسعه پسوند را با استفاده از Azure DevOps Extension SDK بررسی کنید.

با ایجاد پرونده ای به نام vss-extension. json در ریشه پوشه پسوند خود شروع کنید. این پرونده حاوی ویژگی های مورد نیاز ، مانند شناسه پسوند و اهداف نصب آن است که در آن می تواند اجرا شود. همچنین مشارکت هایی را که توسط پسوند شما انجام می شود ، تعریف می کند.

مثال زیر از یک مانیفست معمولی را ببینید:

ویژگی های مورد نیاز

• Use version >= 0. 6. 3 از TFX-CLI اگر در حال انتشار برنامه نویسی هستید.
• If you're using Azure DevOps Extension Tasks extension to publish, ensure that its version is >= 1. 2. 8. ممکن است به دلیل تغییر دامنه اخیر ، به روزرسانی پسوند را تأیید کنید.
• دسته بندی هایی که قبلاً ذکر شد به طور بومی در Visual Studio Marketplace و Azure DevOps Server 2019 و بالاتر وجود دارد. برای پسوندهای هدفمند نسخه های قبلی TFS:
  • اگر مشتریان TFS پسوند خود را از طریق بازار ویژوال استودیو (گالری محلی) در زمینه متصل به دست می آورند ، سپس از دسته هایی که قبلاً بیان شده اند استفاده کنید.
  • اگر می خواهید پسوند را مستقیماً (یعنی از طریق بازار ویژوال استودیو) به اشتراک بگذارید با مشتری با استفاده از TFS
  • Microsoft. VisualStudio. Service (پسوندهایی که با Azure DevOps یا TFS کار می کند) ،
  • Microsoft. TeamFoundation. Server (پسوند که با TFS کار می کند) ،
  • Microsoft. VisualStudio. Service. Integration (ادغام هایی که با Azure DevOps یا TFS کار می کند) ،
  • Microsoft. TeamFoundation. Server. Integration (ادغام هایی که با TFS کار می کنند)

  نمونه هایی از ویژگی های مورد نیاز

  ویژگی های اختیاری

  ویژگی های زمان اجرا

  ویژگی	شرح	یادداشت
  دامنه	مجموعه ای از مجوزهای مجوز (رشته ها) لیست مجوزهای مورد نیاز توسط پسوند شما.	به عنوان مثال ، VSO. Work و vs. code_write نشان می دهد که پسوند شما فقط به دسترسی خواندنی به موارد کار نیاز دارد و دسترسی به کد منبع (و منبع مرتبط) را می خواند. Scopes هنگام نصب پسوند شما به کاربر ارائه می شود. برای اطلاعات بیشتر ، به لیست کامل Scopes مراجعه کنید.
  خواسته ها	مجموعه ای از مطالبات (رشته ها) که توانایی های مورد نیاز پسوند شما را نشان می دهد.	به عنوان مثال ، API-VVERION/3. 0 نشان می دهد که پسوند شما از API های نسخه 3. 0 استفاده می کند ، و بنابراین نمی توانید در محصولات قدیمی تر که از این نسخه پشتیبانی نمی کنند ، اجرا شود. برای اطلاعات بیشتر ، به لیست کامل خواسته ها مراجعه کنید.
  پایه	(اختیاری) URL پایه برای کلیه URL های نسبی مشخص شده توسط مشارکت های پسوند.	For example: https://myapp.com/>/اگر محتوای پسوند شما با پسوند شما بسته بندی شده باشد ، باید این ویژگی خالی باقی بماند.
  مشارکت	مجموعه ای از مشارکت در سیستم.
  نوع مشارکتی	مجموعه ای از انواع مشارکت تعریف شده توسط پسوند

  ویژگی های کشف

  این خصوصیات اختیاری به کاربران کمک می کند تا از پسوند شما کشف و یاد بگیرند:

   

  ویژگی	شرح	یادداشت
  شرح	چند جمله توصیف پسوندها. محدود به 200 کاراکتر.	توضیحات باید "زمین آسانسور" برنامه افزودنی شما باشد - چند خط برای توصیف پسوند شما در بازار و باعث می شود مردم بخواهند آن را نصب کنند. مثال زیر را ببینید
  نماد	فرهنگ لغت نمادهای نماینده پسوند.	کلیدهای معتبر: پیش فرض (128x128 پیکسل) از نوع BMP ، GIF ، EXIF ، JPG ، PNG و TIFF). کلیدهای دیگر مانند بزرگ (512x512 پیکسل) ممکن است در آینده پشتیبانی شوند. مقدار هر کلید مسیر پرونده نماد در پسوند است
  برچسب ها	مجموعه ای از برچسب های رشته ای برای کمک به کاربران در یافتن پسوند شما.	مثال: چابک ، مدیریت پروژه ، تایمر کار و غیره.
  عکس	مجموعه ای از تصاویر که نمی توانند در محتوای شما گنجانده شوند.	تصاویر در هنگام نمایش در محتوای شما با ارزش تر هستند و باید در آنجا مورد استفاده قرار گیرند تا به یک صفحه جزئیات بازار با کیفیت برای پسوند شما کمک کند. از تصاویر برای تصاویر مهم کمتری که در محتوای شما نشان داده نشده است استفاده کنید. هر تصویر باید 1366x768 پیکسل باشد. مسیر هر مورد ، مسیر پرونده در پسوند است.
  محتوا	فرهنگ لغت پرونده های محتوا که پسوند شما را به کاربران توصیف می کند.	هر برنامه افزودنی باید شامل محتوای جامد باشد. اینگونه است که شما به کاربران نشان می دهید که پسوند شما چه کاری می تواند انجام دهد. آن را غنی ، مصرفی کنید و در صورت لزوم تصاویر را درج کنید. یک فایل مرور. md را به عنوان قطعه محتوای پایه خود درج کنید. فرض بر این است که هر پرونده در قالب Markdown با طعم Github قرار دارد. مسیر هر مورد مسیر پرونده Markdown در پسوند است. کلیدهای معتبر: جزئیات. کلیدهای دیگر ممکن است در آینده پشتیبانی شوند.
  لینک	فرهنگ لغت پیوندهایی که به کاربران کمک می کند تا در مورد پسوند شما اطلاعات بیشتری کسب کنند ، پشتیبانی کنند و حرکت کنند.	کلیدهای معتبر: GetStarted - اولین مراحل ، نحوه تنظیم یا استفاده. یاد بگیرید - محتوای عمیق تر برای کمک به کاربران در درک بهتر برنامه یا خدمات شما. مجوز - توافق نامه مجوز کاربر نهایی. PrivacyPolicy - خط مشی رازداری برای پسوند. پشتیبانی - از یک پسوند کمک بگیرید و پشتیبانی کنید. مقدار هر کلید یک شی با یک قسمت URI است که URL مطلق پیوند است
  مخزن	فرهنگ لغت خواص توصیف مخزن کد منبع برای پسوند	کلیدهای معتبر: نوع - نوع مخزن. مثال: git. URI - URL مطلق مخزن.
  نشان	آرایه ای از پیوندها به نشان های ابرداده خارجی مانند Travisci ، Appveyor و غیره ، از سایت های تأیید شده نشان داده شده است	کلیدهای معتبر: HREF - هنگام انتخاب نشان ، کاربر را به سمت خود هدایت می کند. URI - URL مطلق تصویر نشان برای نمایش. توضیحات - توضیحات نشان ، که در شناور نمایش داده می شود.
  نام تجاری	فرهنگ لغت خواص مربوط به برند.	کلیدهای معتبر: رنگ - رنگ اصلی پسوند یا ناشر ؛می تواند یک HEX (#FF00FF) ، RGB (RGB (100،200،50)) یا نام های رنگی HTML (آبی) پشتیبانی شود. تم - تکمیل رنگ ؛از رنگ های Dark Dark Branding یا Light برای رنگهای سبک تر استفاده کنید.

  علامت گذاری عمومی را علامت گذاری کنید

  به طور پیش فرض ، تمام پسوندهای موجود در بازار Devops Azure خصوصی هستند. آنها فقط برای ناشر و حساب هایی که توسط ناشر به اشتراک گذاشته شده است قابل مشاهده است. اگر ناشر شما تأیید شده است ، می توانید با تنظیم پرچم عمومی در برنامه افزودنی خود ، پسوند خود را عمومی کنید:

  یک برنامه افزودنی را برای پیش نمایش علامت گذاری کنید

  اگر برنامه افزودنی شما برای کاربران در بازار آماده است ، اما هنوز در حال کار کردن چند اشکال یا اضافه کردن عملکرد هستید ، می توانید آن را به عنوان پیش نمایش علامت گذاری کنید:

  به عنوان پیش نمایش پرداخت شده ، یک برنامه افزودنی را علامت گذاری کنید

  اگر قصد فروش پسوند خود را در بازار دارید ، آن را به عنوان پیش نمایش پرداخت شده علامت گذاری کنید. پسوند مشخص شده به صورت رایگان قابل تغییر نیست.

  یک پسوند را به صورت پرداخت کنید

  اگر می خواهید برنامه افزودنی خود را در بازار بفروشید ، می توانید آن را با پرچم پرداخت شده و برچسب __byoLenced (با دو زیرزمین شروع کنید) علامت گذاری کنید:

  هر دو پرچم پرداخت شده و برچسب __byolenced باید برای نشان دادن یک پسوند به عنوان پرداخت شده در بازار ، حضور داشته باشند. Briting Own-Own-License (BYOL) به معنای ناشر پسوند مکانیزم صورتحساب و صدور مجوز برای پسوند است ، زیرا توسط مایکروسافت برای پسوندهای DevOps Azure تهیه نشده است. کلیه پسوندهای پرداخت شده برای تعریف سیاست حفظ حریم خصوصی ، سیاست پشتیبانی و توافق نامه مجوز کاربر نهایی لازم است. همچنین ، ناشران باید محتوا را برای برگه قیمت گذاری در بازار به شرح زیر تهیه کنند:

  برای نادیده گرفتن مجوزهای پرداخت شده ، باید بخش جدیدی را در برنامه افزودنی خود اضافه کنید. در آینده ، ما چک مجوز پرداخت شده را حذف خواهیم کرد و دیگر نیازی به نادیده گرفتن نداریم. در حال حاضر ، نمایشگاه های پسوند خود را مطابق انتظار اطمینان حاصل کنید. هر غلبه شامل "شناسه" و "رفتار" است."شناسه" باید با شناسه مشارکتهای تعریف شده در مانیفست مطابقت داشته باشد.

  اگر پسوند BYOL پرداخت شده شما یک دوره آزمایشی را ارائه می دهد (ما توصیه می کنیم) ، می توانید مدت زمان آزمایش را در روزها مشخص کنید:

  اگر می خواهید TFS را هدف قرار دهید ، اما مایل نیستید گزینه بارگیری را برای پسوند خود قرار دهید ، سپس برچسب __donotdowload (با دو زیرین شروع می شود) را به آشکار پسوند اضافه کنید. اگر در حال جابجایی از صورتحساب و مجوز قبلاً ارائه شده از مایکروسافت به مدل BYOL هستید ، با ما تماس بگیرید و ما مراحل مناسبی را برای شما فراهم خواهیم کرد.

  نمونه ای از خواص بیشتر

  مثال صفحه جزئیات

  • 1 - توضیحات
  • 2 - نماد
  • 3 - دسته بندی ها
  • 4 - تصاویر
  • 5 - محتوا (جزئیات)
  • 6 - پیوندها
  • 7 - مارک تجاری

  

  Q& A Marketplace - ملک CustomerQnasUpport

  تمام برنامه های افزودنی در بازار Visual Studio دارای یک بخش پرسش و پاسخ است که امکان مکالمات عمومی یک به یک بین کاربران پسوند و ناشران را فراهم می کند. ناشران می توانند بین Q& A Marketplace ، شماره های GitHub یا URL QUARE Q& A را انتخاب کنند. شما می توانید پرسش و پاسخ را در بازار با استفاده از ملک CustomerQNAsUpport در مانیفست غیرفعال کنید.

  تجربه پیش فرض (هیچ تغییری در تجلی لازم نیست)

  • برای برنامه های افزودنی با مخزن GitHub ، Marketplace کاربران را در بخش پرسش و پاسخ به موضوعات مربوط به GitHub هدایت می کند.
  • برای پسوندهای بدون مخزن GitHub ، Q& A Marketplace فعال است.

  برای یک تجربه متفاوت از یکی از گزینه های پیش فرض ، از ویژگی CustomerQNAsupport در مانیفست استفاده کنید.

  خواص

  خواص بخش پشتیبانی پرسش و پاسخ مشتری:

  • EnableMarketPlaceQNA - زمینه بولی ، تنظیم شده برای بازار یا پرسش و پاسخ سفارشی ؛برای غیرفعال کردن پرسش و پاسخ
  • URL - رشته ، URL برای پرسش و پاسخ سفارشی

  نمونه هایی که نشان دهنده استفاده از پرسش و پاسخ است

  مثال: پسوند با استفاده از پرسش و پاسخ سفارشی

  مثال: پسوند با مخزن GitHub اما استفاده از Q& A Marketplace به جای مشکلات GitHub

  مثال: غیرفعال کردن بخش پرسش و پاسخ

  دامنه

  پسوند شما می تواند یک یا چند دامنه را مشخص کند. Scopes کنترل می کند که از طریق پسوند شما می توان به منابع دسترسی پیدا کرد و چه عملیاتی را برای انجام آن با این منابع مجاز است. دامنه هایی که در مانیفست پسوند خود مشخص می کنید ، دامنه هایی است که بر روی نشانه های دسترسی به برنامه شما صادر شده است. برای اطلاعات بیشتر ، به Auth و Security مراجعه کنید.

  در صورت عدم مشخص شدن Scopes ، برنامه های افزودنی فقط به مشخصات کاربر و داده های پسوند دسترسی دارند.

  دامنه های پشتیبانی شده

  دسته بندی	محدوده	نام	شرح
  استخرهای عامل	vso. agentpools	استخرهای عامل (بخوانید)	توانایی مشاهده وظایف ، استخرها ، صف ها ، نمایندگان و در حال حاضر در حال اجرا یا اخیراً کار را برای نمایندگان اعطا می کند.
  vso. agentpools_manage	استخرهای عامل (بخوانید ، مدیریت کنید)	توانایی مدیریت استخرها ، صف ها و نمایندگان را اعطا می کند.
  VSO. Enverionment_Manage	محیط (بخوانید ، مدیریت کنید)	توانایی مدیریت استخرها ، صف ها ، عوامل و محیط را اعطا می کند.
  تجزیه و تحلیل	VSO. Analytics	تحلیلی (بخوانید)	توانایی پرس و جو از داده های تجزیه و تحلیل را اعطا می کند.
  گزارش حسابرسی	vso.auditlog	ورود به سیستم حسابرسی (بخوانید)	توانایی خواندن گزارش حسابرسی را به کاربران اعطا می کند.
  ساختن	vso. build	ساخت (بخوانید)	توانایی دسترسی به ساخت مصنوعات ، از جمله ساخت نتایج ، تعاریف و درخواست ها و امکان دریافت اعلان در مورد ایجاد رویدادها را از طریق قلاب های سرویس اعطا می کند.
  vSo. Build_Execute	ساخت (بخوانید و اجرا کنید)	توانایی دسترسی به ساخت مصنوعات ، از جمله ساخت نتایج ، تعاریف و درخواست ها و امکان صف ساخت ، به روزرسانی خواص ساخت و امکان دریافت اعلان در مورد ساخت رویدادها را از طریق قلاب های سرویس اعطا می کند.
  رمز	vso. code	کد (بخوانید)	توانایی خواندن کد منبع و ابرداده را در مورد تعهدات ، تغییرات ، شاخه ها و سایر مصنوعات کنترل نسخه اعطا می کند. همچنین امکان جستجوی کد و اطلاع رسانی در مورد رویدادهای کنترل نسخه از طریق قلاب های سرویس را اعطا می کند.
  vso. code_write	کد (بخوانید و بنویسید)	امکان خواندن ، به روزرسانی و حذف کد منبع ، دسترسی به ابرداده در مورد تعهدات ، تغییرات ، شاخه ها و سایر مصنوعات کنترل نسخه را اعطا می کند. همچنین امکان ایجاد و مدیریت درخواست های کشش و بررسی کد و دریافت اعلان در مورد رویدادهای کنترل نسخه از طریق قلاب های سرویس را اعطا می کند.
  vso. code_manage	کد (بخوانید ، بنویسید و مدیریت کنید)	امکان خواندن ، به روزرسانی و حذف کد منبع ، دسترسی به ابرداده در مورد تعهدات ، تغییرات ، شاخه ها و سایر مصنوعات کنترل نسخه را اعطا می کند. همچنین امکان ایجاد و مدیریت مخازن کد ، ایجاد و مدیریت درخواست های کشش و بررسی کد و دریافت اعلان در مورد رویدادهای کنترل نسخه از طریق قلاب های سرویس را اعطا می کند.
  vso. code_full	کد (کامل)	دسترسی کامل به کد منبع ، ابرداده در مورد تعهدات ، تغییرات ، شاخه ها و سایر مصنوعات کنترل نسخه را اعطا می کند. همچنین امکان ایجاد و مدیریت مخازن کد ، ایجاد و مدیریت درخواست های کشش و بررسی کد و دریافت اعلان در مورد رویدادهای کنترل نسخه از طریق قلاب های سرویس را اعطا می کند. همچنین شامل پشتیبانی محدودی برای API های مشتری OM است.
  vso. code_status	کد (وضعیت)	توانایی خواندن و نوشتن وضعیت درخواست را اعطا می کند.
  حق	vso. entitlements	حقوقی (بخوانید)	برای دریافت حق حساب ، فقط دسترسی به مجوزهای مجوز را فراهم می کند.
  VSO. MemberentItlementManagement	مدیریت عضویت (خواندن)	توانایی خواندن کاربران ، مجوزهای آنها و همچنین پروژه ها و برنامه های افزودنی را که می توانند به آنها دسترسی پیدا کنند ، اعطا می کند.
  vso. MemberentItlementManagement_write	مدیریت عضویت (نوشتن)	توانایی مدیریت کاربران ، مجوزهای آنها و همچنین پروژه ها و پسوندهایی را که می توانند به آنها دسترسی پیدا کنند ، اعطا می کند.
  الحاق	vso. extension	پسوندها (بخوانید)	توانایی خواندن پسوندهای نصب شده را اعطا می کند.
  vso. extension_manage	پسوند (بخوانید و مدیریت کنید)	امکان نصب ، حذف و انجام سایر اقدامات اداری را بر روی پسوندهای نصب شده اعطا می کند.
  vso. extension. data	داده های پسوند (بخوانید)	امکان خواندن داده ها (تنظیمات و اسناد) ذخیره شده توسط پسوندهای نصب شده را اعطا می کند.
  vso. extension. data_write	داده های پسوند (بخوانید و بنویسید)	امکان خواندن و نوشتن داده ها (تنظیمات و اسناد) ذخیره شده توسط پسوندهای نصب شده را اعطا می کند.
  نمودار و هویت	vso. graph	نمودار (بخوانید)	توانایی خواندن اطلاعات عضویت کاربر ، گروه ، دامنه و گروه را اعطا می کند.
  vso. graph_manage	نمودار (مدیریت)	توانایی خواندن اطلاعات عضویت کاربر ، گروه ، دامنه و گروهی و اضافه کردن کاربران ، گروه ها و مدیریت عضویت در گروه را اعطا می کند.
  VSO. IDENTITION	هویت (بخوانید)	توانایی خواندن هویت و گروه ها را اعطا می کند.
  VSO. IDENTITY_MANAGE	هویت (مدیریت)	توانایی خواندن ، نوشتن و مدیریت هویت و گروه ها را اعطا می کند.
  تست بار	vso. loadtest	آزمون بار (بخوانید)	توانایی خواندن آزمون بار ، نتایج آزمون و مصنوعات APM را به شما اعطا می کند.
  vso. loadtest_write	آزمون بار (بخوانید و بنویسید)	امکان ایجاد و به روزرسانی تست بار را اعطا می کند و ابرداده را از جمله نتایج آزمون و مصنوعات APM خوانده است.
  گروه ماشین	vso. machinegroup_manage	گروه استقرار (بخوانید ، مدیریت کنید)	امکان مدیریت گروه استقرار و استخرهای عامل را فراهم می کند.
  بازار	vso. gallery	بازار	کمک های مالی دسترسی به موارد و ناشران عمومی و خصوصی را می خوانند.
  vso. gallery_acquire	بازار (کسب)	کمک های مالی دسترسی و امکان دستیابی به موارد را می خوانند.
  VSO. Gallery_Publish	بازار (انتشار)	کمک های مالی دسترسی و امکان بارگذاری ، به روزرسانی و به اشتراک گذاری موارد را می خوانند.
  vso. gallery_manage	بازار (مدیریت)	کمک های مالی دسترسی و امکان انتشار و مدیریت موارد و ناشران را می خوانند.
  اطلاعیه	vso. Notification	اعلان ها (بخوانید)	دسترسی به اشتراک ها و ابرداده های رویداد ، از جمله مقادیر فیلد قابل فیلتر را فراهم می کند.
  vso. notification_write	اعلان ها (نوشتن)	دسترسی به اشتراک و نوشتن به اشتراک ها را فراهم می کند و دسترسی به ابرداده رویداد ، از جمله مقادیر فیلد قابل فیلتر را می خواند.
  vso. notification_manage	اعلان ها (مدیریت)	دسترسی به خواندن ، نوشتن و مدیریت به اشتراک ها را فراهم می کند و دسترسی به ابرداده رویداد ، از جمله مقادیر فیلد قابل فیلتر را می خواند.
  vso. notification_diagnostics	اعلان ها (تشخیص)	دسترسی به سیاهههای تشخیصی مربوط به اطلاع رسانی را فراهم می کند و امکان فعال کردن تشخیص برای اشتراک های فردی را فراهم می کند.
  بسته بندی	vso. packaging	بسته بندی (بخوانید)	توانایی خواندن فیدها و بسته ها را اعطا می کند.
  vso. packaging_write	بسته بندی (بخوانید و بنویسید)	توانایی ایجاد و خواندن فیدها و بسته ها را اعطا می کند.
  vso. packaging_manage	بسته بندی (بخوانید ، بنویسید و مدیریت کنید)	توانایی ایجاد ، خواندن ، به روزرسانی و حذف فید و بسته ها را اعطا می کند.
  پروژه و تیم	vso. project	پروژه و تیم (بخوانید)	توانایی خواندن پروژه ها و تیم ها را اعطا می کند.
  vso. project_write	پروژه و تیم (بخوانید و بنویسید)	توانایی خواندن و به روزرسانی پروژه ها و تیم ها را اعطا می کند.
  vso. project_manage	پروژه و تیم (بخوانید ، بنویسید و مدیریت کنید)	توانایی ایجاد ، خواندن ، به روزرسانی و حذف پروژه ها و تیم ها را اعطا می کند.
  رهایی	vso. release	انتشار (بخوانید)	توانایی خواندن آثار باستانی ، از جمله نسخه ها ، تعاریف انتشار و محیط انتشار را اعطا می کند.
  vso. release_execute	انتشار (بخوانید ، بنویسید و اجرا کنید)	توانایی خواندن و به روزرسانی مصنوعات انتشار ، از جمله نسخه ها ، تعاریف انتشار و محیط انتشار و امکان صف در نسخه جدید را اعطا می کند.
  vso. release_manage	انتشار (بخوانید ، بنویسید ، اجرا کنید و مدیریت کنید)	امکان خواندن ، به روزرسانی و حذف مصنوعات انتشار ، از جمله نسخه ها ، تعاریف انتشار و محیط انتشار و امکان صف و تأیید نسخه جدید را اعطا می کند.
  امنیت	VSO. Securance_Manage	امنیت (مدیریت)	توانایی خواندن ، نوشتن و مدیریت مجوزهای امنیتی را اعطا می کند.
  اتصالات خدماتی	vso. serviceendpoint	نقاط پایانی سرویس (بخوانید)	توانایی خواندن نقاط پایانی سرویس را اعطا می کند.
  vso. serviceendpoint_query	نقاط پایانی سرویس (خواندن و پرس و جو)	توانایی خواندن و پرس و جو در نقاط پایانی خدمات را اعطا می کند.
  vso. serviceendpoint_manage	نقاط پایانی سرویس (بخوانید ، پرس و جو و مدیریت)	توانایی خواندن ، پرس و جو و مدیریت نقاط پایانی خدمات را اعطا می کند.
  تنظیمات	vso. settings	تنظیمات (بخوانید)	توانایی خواندن تنظیمات را اعطا می کند.
  vso. settings_write	تنظیمات (بخوانید و بنویسید)	توانایی ایجاد و خواندن تنظیمات را اعطا می کند.
  نماد	vso. symbols	نمادها (بخوانید)	توانایی خواندن نمادها را اعطا می کند.
  vso. symbols_write	نمادها (بخوانید و بنویسید)	توانایی خواندن و نوشتن نمادها را اعطا می کند.
  vso. symbols_manage	نمادها (بخوانید ، بنویسید و مدیریت کنید)	توانایی خواندن ، نوشتن و مدیریت نمادها را اعطا می کند.
  گروه های وظیفه	vso. taskgroups_read	گروه های کار (بخوانید)	توانایی خواندن گروه های کار را اعطا می کند.
  vso. taskgroups_write	گروه های کار (بخوانید ، ایجاد کنید)	توانایی خواندن و ایجاد گروه های کار را اعطا می کند.
  vso. taskgroups_manage	گروه های کار (بخوانید ، ایجاد کنید و مدیریت کنید)	توانایی خواندن ، ایجاد و مدیریت گروه های کار را اعطا می کند.
  داشبورد تیمی	vso. dashboards	داشبورد تیم (بخوانید)	توانایی خواندن اطلاعات داشبورد تیم را اعطا می کند.
  vso. dashboards_manage	داشبورد تیم (مدیریت)	توانایی مدیریت اطلاعات داشبورد تیم را اعطا می کند.
  مدیریت آزمون	vso. test	مدیریت آزمون (بخوانید)	توانایی خواندن برنامه های آزمون ، موارد ، نتایج و سایر مصنوعات مربوط به مدیریت آزمون را اعطا می کند.
  vso. test_write	مدیریت آزمون (بخوانید و بنویسید)	توانایی خواندن ، ایجاد و به روزرسانی برنامه های آزمون ، موارد ، نتایج و سایر مصنوعات مربوط به مدیریت آزمون را اعطا می کند.
  توکن	vso. tokens	نشانه های مجوز واگذار شده	توانایی مدیریت نشانه های مجوزهای تفویض شده را به کاربران اعطا می کند.
  VSO. TokenAdministration	اداره اموال	توانایی مدیریت (مشاهده و ابطال) نشانه های موجود را به مدیران سازمان اعطا می کند.
  مشخصات کاربر	vso. profile	مشخصات کاربر (بخوانید)	توانایی خواندن پروفایل ، حساب ها ، مجموعه ها ، پروژه ها ، تیم ها و سایر آثار باستانی سازمانی سطح بالا را اعطا می کند.
  vso. profile_write	مشخصات کاربر (نوشتن)	توانایی نوشتن به نمایه خود را اعطا می کند.
  گروههای متغیر	vso. VaribleGroups_Read	گروه های متغیر (بخوانید)	توانایی خواندن گروههای متغیر را اعطا می کند.
  vso. VaribleGroups_Write	گروه های متغیر (بخوانید ، ایجاد کنید)	توانایی خواندن و ایجاد گروه های متغیر را اعطا می کند.
  vSo. ParibleGroups_Manage	گروه های متغیر (بخوانید ، ایجاد کنید و مدیریت کنید)	توانایی خواندن ، ایجاد و مدیریت گروه های متغیر را اعطا می کند.
  ویکی	vso. wiki	ویکی (بخوانید)	توانایی خواندن ویکی ها ، صفحات ویکی و پیوست های ویکی را اعطا می کند. همچنین توانایی جستجوی صفحات ویکی را اعطا می کند.
  vso. wiki_write	ویکی (بخوانید و بنویسید)	امکان خواندن ، ایجاد و به روزرسانی ویکی ها ، صفحات ویکی و پیوست های ویکی را اعطا می کند.
  موارد کار	vso. work	موارد کار (بخوانید)	توانایی خواندن موارد کار ، پرس و جو ، تابلوها ، مسیرهای منطقه و تکرارها و سایر موارد کار را ردیابی ابرداده مربوط می کند. همچنین امکان اجرای نمایش داده ها ، موارد جستجو و دریافت اعلان در مورد رویدادهای مورد کار را از طریق قلاب های سرویس اعطا می کند.
  vso. work_write	موارد کار (بخوانید و بنویسید)	توانایی خواندن ، ایجاد و به روزرسانی موارد کار و نمایش داده ها ، به روزرسانی ابرداده صفحه ، خواندن منطقه و مسیرهای تکراری را به سایر موارد کار انجام داده های مرتبط ، اجرای نمایش داده ها و دریافت اعلان در مورد رویدادهای مورد کار از طریق قلاب های خدمات اعطا می کند.
  vso. work_full	موارد کار (کامل)	دسترسی کامل به موارد کار ، نمایش داده شد ، باقیمانده ، برنامه ها و ابرداده ردیابی مورد کار را اعطا می کند. همچنین امکان دریافت اعلان در مورد رویدادهای مورد کار را از طریق قلاب های سرویس فراهم می کند.

  تغییر دامنه پسوند منتشر شده

  می توانید دامنه یک پسوند منتشر شده را تغییر دهید. مشتریانی که قبلاً برنامه افزودنی شما را نصب کرده بودند (و مجموعه قبلی Scopes را مجاز می کردند) در نسخه قبلی برنامه افزودنی باقی می مانند و باید قبل از به روزرسانی به جدیدترین نسخه ، اسکوپ های جدید را مجاز کنند.

  بخش مورد نیاز عملیات برنامه های پسوند به کاربر نشان می دهد که در صورت وجود ، پسوندهای نصب شده نیاز به مجوز دارند:

  

  سپس یک مدیر می تواند مجموعه جدیدی از Scopes را مرور و مجوز دهد:

  

  اهداف نصب

  همانطور که از نام آن پیداست ، اهداف نصب محصولات و خدماتی را که پسوند شما را می توان در آن قرار داد تعریف می کند. Microsoft. VisualStudio. Service متداول ترین هدف نصب است و نشان می دهد که این برنامه افزودنی را می توان در Azure DevOps نصب کرد.

  اهداف نصب برای یک پسوند یا ادغام از طریق قسمت اهداف در مانیفست مشخص شده است.

  شناسه های پشتیبانی شده برای پسوند:

  • Microsoft. VisualStudio. Service. Cloud: نصب در خدمات DevOps Azure
  • Microsoft. TeamFoundation. Server: نصب در TFS
  • Microsoft. VisualStudio. Service: در هر دو نصب می شود. میانبر برای Microsoft. VisualStudio. Service. Cloud و Microsoft. TeamFoundation. Server نسخه [14. 2 ،)

  شناسه های پشتیبانی شده برای ادغام:

  • Microsoft. VisualStudio. Service. Cloud. Integration: با خدمات DevOps Azure ادغام می شود
  • Microsoft. TeamFoundation. Server. Integration: با TFS ادغام می شود
  • Microsoft. VisualStudio. Service. Integration: با هر دو ادغام می شود. میانبر برای microsoft. visualstudio. service. cloud. integration و microsoft. teamfoundation. server. integration

  نمونه هایی از اهداف نصب

  مثال: پسوند که با Azure DevOps کار می کند

  مثال: پسوند که فقط با خدمات Azure DevOps کار می کند

  از اهداف نصب نیز می توان در مانیفست ادغام استفاده کرد. به عنوان مثال ، محصولات ، برنامه ها یا ابزارهایی که با آنها کار می کنند ، اما در Azure DevOps نصب نکنید.

  مثال: ادغام که با Azure DevOps کار می کند

  مثال: ادغام که فقط با TFS کار می کند

  نسخه های هدف نصب

  برخی از شناسه های هدف نصب ، مانند Microsoft. TeamFoundation. Server و Microsoft. TeamFoundation. Server. Integration ، از یک محدوده نسخه اختیاری پشتیبانی می کنند. این محدوده نسخه اختیاری بیشتر توضیح می دهد که پشتیبانی شده پسوند یا ادغام در آن پشتیبانی می شود.

  دامنه نسخه یا نسخه از طریق قسمت نسخه در شیء هدف نصب مشخص شده است. این مقدار می تواند باشد:

  • یک نسخه خاص ، به عنوان مثال: 15. 0 (فقط RTM 2017)
  • طیف وسیعی از نسخه های پشتیبانی شده ، به عنوان مثال: [14. 0) (RTM 2015 و بعد) ، [14. 3،15. 1] (بروزرسانی 2015 3 تا 2017 بروزرسانی 1). مقادیر دامنه با استفاده از:
    • [: حداقل نسخه فراگیر
    • ]: حداکثر نسخه شامل
    • (: حداقل نسخه اختصاصی
    • ): حداکثر نسخه اختصاصی

    شماره نسخه برای سرور Azure DevOps:

     

    رهایی	منتشر شده	نسخه
    2010	همه نسخه ها	10. 0
    2012	همه نسخه ها	11. 0
    2013	RTM و به روزرسانی ها	12. 0 ، 12. 1 ، 12. 2 ، 12. 3 ، 12. 4
    2015	RTM و به روزرسانی ها	14. 0 ، 14. 1 ، 14. 2 ، 14. 3
    2017	RTM و به روزرسانی ها	15. 0 ، 15. 1
    2018	RTM و به روزرسانی ها	16. 0
    2019	RTM و به روزرسانی ها	17. 0
    2020	RTM و به روزرسانی ها	18. 0

    نمونه هایی که نسخه ها را نشان می دهد

    مثال: پسوند که با Azure DevOps کار می کند

    میانبرها

    Microsoft. VisualStudio. Service میانبر برای DevOps Azure است.

    برابر است با:

    با استفاده از اهداف و خواسته های نصب

    اهداف و خواسته های نصب در کنار هم برای ارائه کاربران با نمای صحیح از محصولات/خدماتی که پسوند یا ادغام شما با آن سازگار است استفاده می شود. به عنوان مثال ، مشخص کردن هدف نصب Microsoft. VisualStudio. Service با تقاضای API-Version/3. 0 به معنای این است که این پسوند با Azure DevOps کار می کند.

    برای کسب اطلاعات بیشتر در مورد API های REST ، به مرجع API REST مراجعه کنید.

    مثال: پسوند که از API های نسخه 3. 0 استفاده می کند

    به اهداف نصب زیر حل می شود:

    1. Microsoft. VisualStudio. Service. Cloud
    2. Microsoft. TeamFoundation. Server ، نسخه: [15. 0 ،)

    مثال: ادغام که از API های نسخه 2. 0 استفاده می کند

    به اهداف نصب زیر حل می شود:

    1. Microsoft. VisualStudio. Service. Cloud. Integration
    2. Microsoft. TeamFoundation. Server. Integration ، نسخه: [14. 0 ،)

    خواسته ها

    تقاضا به شما امکان می دهد قابلیت ها و سایر ویژگی های مورد نیاز پسوند خود را مشخص کنید. می توانید از این خواسته ها استفاده کنید تا جایی که می توان پسوند خود را منتشر کرد یا نصب کرد ، محدود کنید.

    خواسته ها توسط بازار ویژوال استودیو مورد استفاده قرار می گیرند تا محصولات و محیط هایی را که پسوند شما با آن سازگار است ، لیست کند ، و این به مشتریان کمک می کند تا درک کنند که آیا پسوند شما با نسخه Azure DevOps کار می کند.

    مثال زیر را در مورد چگونگی مشخص شدن تقاضا در آشکار گسترش مشاهده کنید.

    در این مثال ، برنامه افزودنی نسخه 3. 0 API را می طلبد ، به این معنی که فقط می توان آن را در Azure DevOps نصب کرد. همچنین نیاز به پسوند ms. vss-dashboards-web (و سهم ویجت کاتالوگ آن) در مجموعه قبل از نصب پسوند شما نصب می شود (و فعال می شود).

    مطالبات پشتیبانی شده

    نوع	شرح	بررسی در انتشار؟	در نصب بررسی می شود؟
    محیط/ابر	نیاز به دویدن در یک محیط ابری دارد	آره	آره
    محیط/onprem	نیاز به دویدن در یک محیط در محل دارد	آره	آره
    api-version/	به یک نسخه خاص API نیاز دارد (حداقل)	No	آره
    افزونه/	نیاز به یک پسوند خاص نصب/فعال می کند	No	آره
    مشارکت/	نیاز به سهم خاصی در دسترس دارد	No	آره
    مشارکت TYPE/	نیاز به یک نوع مشارکت خاص در دسترس دارد	No	آره

    • از محیط/ابر و محیط/ONPREM استفاده کنید فقط در صورتی که پسوند شما دارای الزامات مربوط به توپولوژی باشد که نیاز به دویدن در آن محیط خاص دارد.
    • تقاضای پسوند ، مشارکت و مشارکت در زمان نصب ارزیابی می شود و مستلزم آن است که پسوند مشخص شده قبلاً در سازمان/مجموعه نصب و فعال شود.

    فایل ها

    بخش پرونده ها جایی است که شما به هر پرونده ای که می خواهید در پسوند خود وارد کنید ، اشاره می کنید. می توانید هر دو پوشه و پرونده های جداگانه را اضافه کنید:

    خواص

    ویژگی های بخش پرونده ها:

    • مسیر - مسیر به منبع روی دیسک ، که می تواند نسبت به فهرست ریشه شما باشد.
    • آدرس پذیر-(اختیاری) اگر می خواهید پرونده شما قابل دسترسی باشد ، روی درست تنظیم کنید. پیش فرض به غلط.
    • PackagePath - (اختیاری) مسیر به منبع درون بسته. پیش فرض به مسیر نسبی روی دیسک از فهرست ریشه شما.
    • ContentType - (اختیاری) نوع MIME پرونده. پیش فرض به بهترین حدس بر اساس تنظیمات پرونده و تنظیمات سیستم عامل.
    • Assettype - (اختیاری) مقدار ویژگی نوع ورود دارایی را در مانیفست VSIX مشخص کنید. همچنین می تواند مجموعه ای از رشته ها باشد ، در این صورت چندین ورودی دارایی برای این پرونده اضافه می شود. پیش فرض به بسته بندی.
    • LANG - (اختیاری) زبان این دارایی. پرونده های بومی شده بر اساس عنوان پذیرش زبان ارائه می شوند. برای نشان دادن این پرونده به زبان پیش فرض (یا بازگشت) ، خالی بگذارید. نسخه های بومی شده از همان پرونده باید دارای یک دارایی یکسان باشند.

    مشارکت

    هر ورودی مشارکت دارای خواص زیر است:

    • شناسه - شناسه مرجع (رشته) برای مشارکت. شناسه هر مشارکت باید در یک پسوند بی نظیر باشد. مراجعه به مشارکت ها و انواع زیر را در زیر مشاهده کنید.
    • نوع - شناسه مشارکت این سهم.
    • توضیحات - (اختیاری) رشته ای که سهم سهم را ارائه می دهد.
    • اهداف - مجموعه ای از شناسه های مشارکت که سهم را هدف قرار می دهد (کمک به). به مشارکتهای هدفمند مراجعه کنید.
    • Properties - (اختیاری) شیئی که شامل خواص سهم همانطور که در نوع مشارکت تعریف شده است.

    انواع مشارکت

    هر ورودی مشارکت دارای خواص زیر است:

    • شناسه - شناسه مرجع (رشته) برای نوع مشارکت. شناسه هر نوع مشارکت باید در یک پسوند بی نظیر باشد. مراجعه به مشارکت ها و انواع زیر را در زیر مشاهده کنید.
    • نام - نام دوستانه نوع مشارکت.
    • توضیحات - (اختیاری) رشته ای است که با جزئیات بیشتری توضیح می دهد که نوع سهم برای آن چیست.
    • خواص - (اختیاری) یک فرهنگ لغت که نام املاک را در توضیحات ملک ترسیم می کند. این خصوصیات خصوصیات مورد نیاز و اختیاری را که می توانند با استفاده از این نوع استفاده کنند ، توصیف می کنند.

    توضیحات ملک دارای خصوصیات زیر است:

    • توضیحات - (اختیاری) رشته ای که توصیف می کند این ویژگی برای آن استفاده می شود.
    • مورد نیاز - (اختیاری) یک مقدار بولی ، که در صورت واقعی نشان می دهد که این خاصیت برای همه کمک های این نوع مورد نیاز است.
    • نوع - نوع ارزشی که خاصیت می تواند داشته باشد. این ممکن است: string ، uri ، guid ، boolean ، عدد صحیح ، double ، dateTime ، Array یا Object باشد.

    مراجعه به مشارکت ها و انواع

    مشارکت ها و انواع مشارکت توسط شناسه های آنها ارجاع می شود. مشارکت انواع مرجع از طریق خاصیت نوع ، و سایر مشارکت ها را از طریق خاصیت اهداف ارجاع می دهد.

    • یک مرجع مشارکت کامل شامل شناسه ناشر ، شناسه پسوند و شناسه مشارکت/نوع است که توسط یک نقطه (.) از هم جدا می شود. به عنوان مثال ، ms. vss-web. hub شناسه کامل برای کمک به شناسه "هاب" در پسوند "VSS-WEB" منتشر شده توسط ناشر "MS" (مایکروسافت) است.
    • مراجع مشارکت نسبی ممکن است در یک مانیفست پسوند برای مراجعه به مشارکت به نوع مشارکت یا نوع مشارکت دیگری در همان پسوند استفاده شود. در این حالت ، ناشر و شناسه های پسوند گنجانده نشده اند ، و شناسه یک نقطه (.) است که توسط شناسه مشارکت و به دنبال آن است. به عنوان مثال ، ". hub" ممکن است در پسوند "VSS-WEB" که قبلاً به عنوان میانبر برای "ms. vss-web. hub" ذکر شد ، استفاده شود.

    کمک های هدفمند

    برخی از مشارکتها به عنوان ظروف عمل می کنند که می توانند توسط سایر کمک ها هدف قرار گیرند.

    • مشارکتهای هاب می توانند گروه های هاب را هدف قرار دهند. هنگامی که یک صفحه ارائه می شود ، UI وب تمام کمک های توپی را نشان می دهد که گروه هاب انتخاب شده را هدف قرار می دهد. گروه های هاب یک مجموعه گروه هاب را هدف قرار می دهند ، که مجموعه ای از گروه های هاب را تعریف می کند که در یک منطقه ناوبری معین ، به عنوان مثال ، صفحات سرپرست سطح پروژه ظاهر می شوند.
    • منوها را می توان با کمک انواع مختلف هدف قرار داد: عمل ، لینک لینک و ارائه دهنده عمل. اقدامات و عملکردهای لینک ، ورودی های منوی واحد را ارائه می دهند. یک ارائه دهنده Action می تواند چندین مورد منوی پویا را ارائه دهد. برای یک منوی معین ، موارد در تمام مشارکتها (از هر یک از این نوع) جمع می شوند که این سهم منوی خاص را هدف قرار می دهد.

    اضافه کردن یک نماد هاب

    برای اطلاعات در مورد اضافه کردن یک نماد به مرکز خود ، راهنمای نماد هاب را بررسی کنید.

    خدمات نشان پشتیبانی شده

    بازار فقط از نشان های خدمات قابل اعتماد زیر پشتیبانی می کند:

    • api. travis-ci.org/
    • badge. fury.io/
    • bedges. frapsoft.com/
    • badges. gitter. im/
    • bedges. greenkeeper.io/
    • cdn. travis-ci.org/
    • ci. appveyor.com/
    • CodeClimate.com/
    • codecov.io/
    • coveralls.io/
    • david-dm.org/
    • gemnasium.com/
    • img. shields.io/
    • isitmaintained.com/
    • Marketplace. VisualStudio.com/
    • snyk.io/
    • travis-ci.com/
    • travis-ci.org/
    • vsmarketplacebadge. apphb.com/
    • bithound.io/
    • deepscan.io/
    • githost.io/
    • gitlab.com/
    • opencollective. co/

    اگر می خواهید نشان دیگری را از یک سرویس دیگر نشان دهید ، با [email protected] تماس بگیرید.

    مثال

    پسوند زیر یک عمل به منوی تکمیل شده ساخت و توپی به گروه Hub Build کمک می کند: