سناریو
فرض کنید در حال ایجاد یک پسوند SPFx هستید. این می تواند هر نوع پسوند SPFx باشد - سفارشی ساز برنامه، سفارشی ساز فیلد یا مجموعه فرمان. شما باید از ژنراتور yeoman برای ایجاد پروژه استفاده کنید و دارای ساختار پروژه مورد نیاز است. راه حل را بسته بندی کنید و برنامه را در کاتالوگ برنامه مستقر کنید و آن را در هر مجموعه سایت خاصی نصب کنید. به محض نصب برنامه، به طور پیش فرض برنامه افزودنی شما را فعال می کند و سفارشی سازی شما به طور پیش فرض شروع به اعمال می کند. فرض کنید از یک سفارشی ساز برنامه برای افزودن سرصفحه و پاورقی به صفحات مدرن استفاده کرده اید. اما شما نمی خواهید شروع به اعمال این سفارشی سازی در سایت کنید. ممکن است بخواهید به مدیران سایت گزینه ای برای فعال/غیرفعال کردن سفارشی ساز برنامه بدهید.
این به عنوان بخشی از راه حلی است که من برای ارائه یک رابط کاربری به مدیران سایت برای افزودن/تغییر/حذف سرصفحه و پاورقی در قسمت وب SPFx از طریق پسوند سفارشی ساز برنامه ایجاد کرده ام.
این مقاله بر نحوه غیرفعال کردن فعال سازی خودکار پسوند SPFx در هنگام نصب برنامه تمرکز خواهد کرد.
به پوشه .\config بروید.
بسته-solution.json را باز کنید.
شبیه زیر خواهد بود.
- {
- "$schema": "https://developer.microsoft.com/json-schemas/spfx-build/package-solution.schema.json",
- "solution": {
- "name": "SPFx Application Customizer Custom Header",
- "id": "G-U-I-D",
- "version": "1.0.0.0",
- "includeClientSideAssets": true,
- "isDomainIsolated": false,
- "features": [
- {
- "title": "Application Extension - Deployment of custom action.",
- "description": "Deploys a custom action with ClientSideComponentId association",
- "id": "G-U-I-D",
- "version": "1.0.0.0",
- "assets": {
- "elementManifests": [
- "elements.xml",
- "clientsideinstance.xml"
- ]
- }
- }
- ]
- },
- "paths": {
- "zippedPackage": "solution/SPFxAppCustomizerApp.sppkg"
- }
- }
اگر به دقت نگاه کنید، دارای گره ویژگی در XML بالا است. این یک ویژگی است که به طور پیش فرض پس از نصب برنامه فعال می شود. ما فقط می توانیم خود گره ویژگی ها را حذف کنیم. اولین نمونه آرایه را که میگوید «یک اقدام سفارشی با ارتباط ClientSideComponentId را اجرا میکند» حذف کنید، اگر چندین ویژگی به راهحل خود اضافه کنید، بیش از یک شی JSON در این آرایه وجود دارد.
پس از حذف، مانند زیر خواهد بود.
- {
- "$schema": "https://developer.microsoft.com/json-schemas/spfx-build/package-solution.schema.json",
- "solution": {
- "name": "SPFx Application Customizer Custom Header",
- "id": "G-U-I-D",
- "version": "1.0.0.0",
- "includeClientSideAssets": true,
- "isDomainIsolated": false
- },
- "paths": {
- "zippedPackage": "solution/SPFxAppCustomizerApp.sppkg"
- }
- }