به Manifest V3 مهاجرت کنید

راهنمای تبدیل افزونه های Manifest V2 به افزونه های Manifest V3.

این بخش به شما کمک می‌کند تا یک برنامه افزودنی را از Manifest V2 به Manifest V3، جدیدترین نسخه پلت‌فرم افزونه‌های Chrome ارتقا دهید. کار مهاجرت به طور کلی به دسته های زیر تقسیم می شود. برای کمک به پیگیری کار خود، چک لیستی را ارائه کرده ایم که محتویات این اسناد را خلاصه می کند. می‌توانید از طریق چک‌لیست به محتوا دسترسی داشته باشید یا در محتوا فرو بروید. هر دو مسیر با یک پسوند ارتقا یافته به پایان می رسند.

• مانیفست را به روز کنید — manifest.json باید مختص V3 باشد. تغییراتی که می تواند به تنهایی ایجاد شود در این بخش توضیح داده شده است. تغییرات آشکار مربوط به کد با تغییرات کدی که آنها پشتیبانی می کنند توصیف می شوند.
• مهاجرت به یک سرویس‌گر — یک کارگر خدمات پس‌زمینه یا صفحه رویداد برنامه افزودنی را جایگزین می‌کند تا اطمینان حاصل کند که کد پس‌زمینه از رشته اصلی خارج می‌شود، جایی که می‌تواند به عملکرد آسیب برساند. این تغییر همچنین مستلزم جابجایی DOM، پنجره و فراخوانی های API برنامه افزودنی خاص به اسناد خارج از صفحه است.
• به روز رسانی تماس های API — برخی از تماس های API باید با معادل های مدرن تری جایگزین شوند.
• جایگزین کردن مسدود کردن شنوندگان درخواست وب — مسدود کردن یا اصلاح درخواست های شبکه در Manifest V2 می تواند عم��کرد را به میزان قابل توجهی کاهش دهد و نیاز به دسترسی بیش از حد به داده های حساس کاربر داشته باشد. Declarative Net Request API به برنامه‌های افزودنی اجازه می‌دهد تا محتوای وب را با مجوزهای کمتر و بدون ایجاد مانع در عملکرد، مسدود یا اصلاح کنند.
• بهبود امنیت برنامه های افزودنی — Manifest V3 امنیت برنامه های افزودنی را از طرق مختلف بهبود می بخشد. علاوه بر خط‌مشی امنیت محتوای پیشرفته، پشتیبانی از کد میزبانی از راه دور و اجرای رشته‌های دلخواه حذف می‌شود.
• برنامه افزودنی خود را منتشر کنید — این بخش نحوه اجرای گام به گام را توضیح می دهد تا اطمینان حاصل شود که برنامه افزودنی Manifest V3 شما همانطور که انتظار می رود کار می کند و ابتدا آن را با یک مخاطب محدود آزمایش کنید.

ما همچنین یک Extension Manifest Converter داریم. همه کارها را برای شما انجام نمی دهد، اما شما را شروع می کند. README مبدل توضیح می دهد که ابزار چه تغییراتی می کند.

مجموعه فعلی ویژگی ها را حفظ کنید

برای کاهش احتمال مشکلات یا باگ‌های غیرمنتظره، توصیه می‌کنیم عملکرد جدیدی را ه��گام مهاجرت اضافه نکنید. به عنوان مثال، افزودن یک ویژگی که به مجوزهای جدید نیاز دارد ممکن است یک هشدار مجوز را ایجاد کند که ��ا زمانی که کاربر مجوزهای جدید را نپذیرد، برنامه افزودنی شما غیرفعال می شود. برای آشنایی با روش‌های دیگر برای افزودن مجوزها بدون نمایش هشدار، به بهترین شیوه‌های هشدار مجوز مراجعه کنید.

Manifest V3 معمولاً در Chrome 88 یا جدیدتر پشتیبانی می‌شود. هنگام به‌روزرسانی تماس‌های API، ممکن است متوجه شوید که ویژگی‌های جایگزین ممکن است تا بعد از نسخه 88 در Chrome وارد نشده باشند . صفحات مرجع API حاوی اطلاعات پشتیبانی برای تک تک اعضای API هستند. اگر متوجه شدید که به یکی از این ویژگی‌ها نیاز دارید، می‌توانید حداقل نسخه کروم را در فایل مانیفست مشخص کنید.

ویژگی های جدید پلت فرم افزونه

از زمان انتشار Manifest V3، ما به افزودن ویژگی‌های جدید ادامه داده‌ایم که بسیاری از آنها در Manifest V2 و Manifest V3 قابل استفاده هستند. هنگام تبدیل نیازی به استفاده از آنها ندارید. با این حال، هنگامی که آنها جایگزین ویژگی های قدیمی تر می شوند، باید آنها را به ویژگی هایی که جایگزین می کنند ترجیح دهید و انتظار داشته باشید که ویژگی های جایگزین شده در نهایت منسوخ شده و حذف شوند.