گزینه های توزیع پسوند جایگزین

همه برنامه‌های افزودنی Chrome باید مستقیماً از فروشگاه وب Chrome یا با استفاده از مکانیسم‌های شرح داده شده در زیر توزیع شوند. رعایت نکردن یکی از این روش‌های توزیع به منزله نقض خط‌مشی برنامه افزودنی Chrome است و ممکن است باعث شود برنامه افزودنی و/یا نرم‌افزار توزیع‌کننده آن به‌عنوان نرم‌افزار ناخواسته پرچم‌گذاری شود.

معمولاً، کاربران برنامه‌های افزودنی را از فروشگاه وب Chrome نصب می‌کنند، اما گاهی اوقات ممکن است بخواهید یک برنامه افزودنی از طریق روش‌های دیگری نصب شود. در اینجا دو مورد معمول وجود دارد:

• یک برنامه افزودنی با نرم افزار دیگری مرتبط است و هر زمان که کاربر آن نرم افزار دیگر را نصب کرد، برنامه افزودنی باید نصب شود.
• یک سرپرست شبکه می‌خواهد همان برنامه‌های افزودنی را در سراسر سازمان خود نصب کند.

افزونه‌ای که از فروشگاه وب Chrome نصب نشده باشد، به عنوان افزونه خارجی شناخته می‌شود. برای توسعه‌دهندگانی که می‌خواهند یک برنامه افزودنی را به عنوان بخشی از فرآیند نصب برای نرم‌افزارهای دیگر توزیع کنند، یا برای مدیران شبکه که می‌خواهند یک برنامه افزودنی را در سراسر سازمان خود توزیع کنند، Google Chrome از روش‌های نصب برنامه افزودنی زیر پشتیبانی می‌کند:

• استفاده از فایل JSON ترجیحی (فقط برای Mac OS X و Linux)
• استفاده از رجیستری ویندوز (فقط برای ویندوز)

هر دو روش از نصب افزونه میزبانی شده در update_URL پشتیبانی می کنند. در Windows و Mac، update_URL باید به فروشگاه وب Chrome اشاره کند که برنامه افزودنی باید در آن میزبانی شود.

فایل تنظیمات برگزیده در لینوکس می تواند به سرور خود اشاره کند که در آن برنامه افزودنی را میزبانی می کنید . فایل ترجیحی JSON همچنین از نصب پسوند از یک فایل پسوند .crx در رایانه لینوکس کاربر پشتیبانی می کند.

قبل از شروع

ابتدا، برنامه افزودنی را در فروشگاه وب Chrome منتشر کنید یا یک فایل .crx را بسته بندی کنید و مطمئن شوید که با موفقیت نصب شده است.

در صورت نصب از URL به روز رسانی ، مطمئن شوید که برنامه افزودنی به درستی میزبانی شده است.

قبل از اینکه فایل تنظیمات برگزیده یا رجیستری را ویرایش کنید، موارد زیر را یادداشت کنید:

• مکان مورد نظر فایل .crx برنامه افزودنی یا نشانی اینترنتی به‌روزرسانی که از آن ارائه می‌شود
• نسخه برنامه افزودنی (از فایل مانیفست یا صفحه chrome://extensions )
• شناسه برنامه افزودنی (از صفحه chrome://extensions هنگامی که برنامه افزودنی بسته بندی شده را بارگیری کردید)

مثال‌های زیر فرض می‌کنند که نسخه 1.0 است و شناسه آن aaaaaaaaaabbbbbbbbbbcccccccccc است.

با استفاده از یک فایل ترجیحی

1. اگر از فایلی در لینوکس نصب می‌کنید، فایل پسوند .crx را در دسترس دستگاهی قرار دهید که می‌خواهید افزونه را روی آن نصب کنید. (آن را در یک فهرست محلی یا به اشتراک گذاری شبکه برای مثال \\server\share\extension.crx یا /home/share/extension.crx کپی کنید.)

2. یک فایل با نام زیر در یکی از پوشه های فهرست شده در زیر ایجاد کنید: aaaaaaaaaabbbbbbbbbbcccccccccc.json که در آن نام فایل (بدون پسوند) با شناسه پسوند شما مطابقت دارد. مکان بستگی به سیستم عامل دارد.

   Mac OS X:

   برای یک کاربر خاص: ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/ برای همه کاربران: /Library/Application Support/Google/Chrome/External Extensions/

   فایل پسوند خارجی برای همه کاربران تنها در صورتی خوانده می شود که هر دایرکتوری موجود در مسیر متعلق به root کاربر باشد، admin گروه یا wheel داشته باشد، و قابل نوشتن در جهان نباشد. مسیر نیز باید عاری از پیوندهای نمادین باشد. این محدودیت‌ها مانع از نصب برنامه‌های افزودنی برای همه کاربران توسط کاربر غیرمجاز می‌شود. برای جزئیات بیشتر به عیب یابی مراجعه کنید.

   لینوکس:

   /opt/google/chrome/extensions/

   /usr/share/google-chrome/extensions/

   توجه: در صورت لزوم از chmod استفاده کنید تا مطمئن شوید که فایل‌های aaaaaaaaaabbbbbbbbbbcccccccccc.json در جهان قابل خواندن هستند.

3. فقط لینوکس: اگر از فایلی نصب می‌کنید، مکان و نسخه افزونه را با فیلدهایی با نام‌های "external_crx" و "external_version" در فایل ایجاد شده در بالا مشخص کنید.

   • مثال:
   • json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
   • توجه: باید از هر \` character in the location. For example, \server\share\extension.crx "\\server\share\extension.crx" would be .
   • اگر از URL به‌روزرسانی نصب می‌کنید، URL به‌روزرسانی برنامه افزودنی را با نام فیلد "external_update_url" مشخص کنید.
   • نمونه نصب از فایل crx. محلی (فقط لینوکس):
   • json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
   • نمونه نصب از فروشگاه وب کروم (مک و لینوکس):
   • json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
   • اگر می‌خواهید برنامه افزودنی را فقط برای برخی از زبان‌های مرورگر نصب کنید، می‌توانید زبان‌های پشتیبانی شده را در نام فیلد "supported_locale" فهرست کنید. Locale ممکن است زبان والد مانند "en" را مشخص کند، در این حالت برنامه افزودنی برای همه زبان‌های زبان انگلیسی مانند "en-US"، "en-GB" و غیره نصب می‌شود. اگر زبان مرورگر دیگری انتخاب شود که توسط برنامه افزودنی پشتیبانی نمی‌شود. ، برنامه های افزودنی خارجی حذف نصب خواهند شد. اگر لیست "supported_locales" وجود نداشته باشد، برنامه افزودنی برای هر محلی نصب می شود.
   • مثال:
   • json { "external_update_url": "https://clients2.google.com/service/update2/crx", "supported_locales": [ "en", "fr", "de" ] }

4. فایل JSON را ذخیره کنید.

5. Google Chrome را راه اندازی کنید و به chrome://extensions بروید. باید افزونه را در لیست مشاهده کنید.

عیب یابی مشکلات مجوزهای سیستم عامل مک

در سیستم عامل مک، فایل‌های پسوند خارجی برای همه کاربران تنها در صورتی خوانده می‌شوند که مجوزهای سیستم فایل از تغییر آن توسط کاربران غیرمجاز جلوگیری کند. اگر هنگام راه‌اندازی Chrome، برنامه‌های افزودنی خارجی نصب شده را نمی‌بینید، ممکن است در فایل‌های برگزیده برنامه‌های افزودنی خارجی مشکل مجوز وجود داشته باشد. برای اینکه ببینید آیا این مشکل است، مراحل زیر را دنبال کنید:

1. برنامه کنسول را اجرا کنید. می توانید آن را در /Applications/Utilities/Console پیدا کنید.
2. اگر نماد سمت چپ کنسول عبارت "Show Log List" را نشان می دهد، روی آن نماد کلیک کنید. ستون دوم در سمت چپ ظاهر می شود.
3. روی "پیام های کنسول" در قسمت سمت چپ کلیک کنید.
4. جستجوی رشته امکان خواندن پسوندهای خارجی وجود ندارد . اگر مشکلی در خواندن فایل های پسوند خارجی وجود داشته باشد، یک پیام خطا مشاهده خواهید کرد. مستقیماً بالای آن به دنبال پیام خطای دیگری بگردید که باید مشکل را توضیح دهد. برای مثال، اگر خطای زیر را مشاهده کردید: «مسیر /کتابخانه/پشتیبانی برنامه/Google/Chrome متعلق به گروه اشتباهی است»، باید از chgrp یا گفتگوی دریافت اطلاعات Finder برای تغییر مالک گروه دایرکتوری به گروه Administrator استفاده کنید. .
5. پس از رفع مشکل، کروم را دوباره راه اندازی کنید. تست کنید که افزونه خارجی اکنون نصب شده است. ممکن است یک خطای مجوزها، کروم را از تشخیص خطای دوم باز دارد. اگر برنامه افزودنی خارجی نصب نشده بود، این مراحل را تکرار کنید تا زمانی که خطایی در برنامه کنسول مشاهده نکنید.

با استفاده از رجیستری ویندوز

1. کلید زیر را در رجیستری پیدا یا ایجاد کنید:
   • ویندوز 32 بیتی: HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
   • ویندوز 64 بیتی: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
2. یک کلید (پوشه) جدید در زیر کلید Extensions با همان نام شناسه پسوند خود ایجاد کنید (به عنوان مثال، aaaaaaaaaabbbbbbbbbbcccccccccc ).

3. در کلید برنامه افزودنی خود، یک ویژگی، "update_url" ایجاد کنید و آن را روی مقدار "https://clients2.google.com/service/update2/crx" تنظیم کنید (این به crx افزونه شما در فروشگاه وب Chrome اشاره می کند) :

   {
     "update_url": "https://clients2.google.com/service/update2/crx"
   }
   

4. مرورگر را راه اندازی کنید و به chrome://extensions بروید. باید افزونه را در لیست مشاهده کنید.

به روز رسانی و حذف نصب

Google Chrome هر بار که مرورگر شروع به کار می کند، ورودی های ابرداده را در تنظیمات برگزیده و رجیستری اسکن می کند و تغییرات لازم را در برنامه های افزودنی خارجی نصب شده انجام می دهد.

برای به روز رسانی برنامه افزودنی خود به نسخه جدید، فایل را به روز کنید و سپس نسخه را در تنظیمات برگزیده یا رجیستری به روز کنید.

برای حذف برنامه افزودنی خود (به عنوان مثال، اگر نرم افزار شما حذف شده است)، فایل ترجیحی خود (aaaaaaaaaabbbbbbbbcccccccccc.json) یا ابرداده را از رجیستری حذف کنید.

سوالات متداول

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

آیا روش اجازه دادن به "پیش نصب" همچنان توسط Google Chrome از M33 به بعد پشتیبانی می شود؟

بله، اما فقط به عنوان نصب از فروشگاه وب Chrome update_URL ، نه از مسیر فایل محلی.

آیا می توانم یک URL را به عنوان مسیری به پسوند خارجی مشخص کنم؟

بله، از فایل JSON ترجیحی برای Mac OS X و Linux استفاده کنید. رجیستری برای ویندوز برنامه افزودنی باید همانطور که در هاست توضیح داده شده است میزبانی شود. در فایل تنظیمات برگزیده، از ویژگی "external_update_url" استفاده کنید تا به مانیفست به‌روزرسانی اشاره کنید که دارای URL برای پسوند شما است. در رجیستری ویندوز، از ویژگی "update_url" استفاده کنید.

برخی از اشتباهات رایج هنگام نصب با فایل تنظیمات چیست؟

• عدم تعیین همان شناسه/نسخه فهرست شده در .crx
• فایل json. ( aaaaaaaaaabbbbbbbbbbcccccccccc.json ) در مکان اشتباهی قرار دارد یا شناسه مشخص شده با شناسه پسوند مطابقت ندارد.
• خطای نحوی در فایل JSON (فراموش کردن جدا کردن ورودی‌ها با کاما یا گذاشتن کامای انتهایی در جایی)
• ورودی فایل JSON به مسیر اشتباه .crx اشاره می کند (یا مسیر مشخص شده اما بدون نام فایل)
• اسلش‌های معکوس در مسیر UNC حذف نمی‌شوند (برای مثال، "\\server\share\file" اشتباه است؛ باید "\\\\server\\share\\extension" باشد)
• مشکلات مجوز در اشتراک شبکه

برخی از اشتباهات رایج هنگام نصب با رجیستری چیست؟

• عدم مشخص کردن همان شناسه/نسخه فهرست شده در فروشگاه وب Chrome
• کلید در مکان اشتباهی در رجیستری ایجاد شده است
• ورودی رجیستری به مسیر اشتباه فایل .crx در فروشگاه وب Chrome اشاره می کند
• مشکلات مجوز در اشتراک شبکه

چگونه می توانم باینری ها و برنامه های افزودنی بومی خود را در مرحله به روز کنم؟

قبلاً وقتی افزونه‌های خارج از فروشگاه پشتیبانی می‌شد، امکان داشت باینری‌های بومی و در مرحله قفل به‌روزرسانی افزونه وجود داشت. با این حال، برنامه‌های افزودنی میزبانی شده در فروشگاه وب Chrome از طریق مکانیسم به‌روزرسانی کروم که توسعه‌دهندگان آن را کنترل نمی‌کنند، به‌روزرسانی می‌شوند. توسعه‌دهندگان برنامه‌های افزودنی باید مراقب به‌روزرسانی افزونه‌هایی باشند که به باینری بومی وابسته هستند (مثلاً پسوندهای قدیمی با استفاده از NPAPI ).

اگر کاربر افزونه را حذف نصب کند چه؟

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

چگونه از لیست بلاک خارج شوم؟

اگر کاربر برنامه افزودنی شما را حذف نصب کرد، باید به این تصمیم احترام بگذارید. با این حال، اگر شما (توسعه‌دهنده) به‌طور تصادفی برنامه افزودنی خود را از طریق رابط کاربری حذف نصب کرده‌اید، می‌توانید با نصب برنامه افزودنی به‌طور معمول از طریق رابط کاربری و سپس حذف آن، برچسب فهرست مسدود را حذف کنید.