قبل از تغییرات بعدی همگام‌سازی نشانک، برنامه‌های افزودنی خود را به‌روزرسانی کنید

جیمز لی
James Lee

تاریخ انتشار: 17 ژوئن 2025

آگوست گذشته، تغییرات آتی را در مدل هویت کروم در پلتفرم‌های ویندوز، مک و لینوکس، به دنبال تغییراتی که قبلاً در iOS و Android راه‌اندازی شده‌اند، اعلام کردیم. هدف از این تغییرات هماهنگ کردن Chrome با انتظارات فعلی کاربر در مورد ورود به سیستم است. کاربران به طور فزاینده ای انتظار دارند فقط برای دسترسی به موارد خود، از جمله نشانک ها، وارد سیستم شوند و برای ایمن نگه داشتن آن از سیستم خارج شوند.

به عنوان بخشی از ارائه این به‌روزرسانی‌ها، ما تغییراتی را در نحوه ذخیره کردن نشانک‌ها در رایانه رومیزی Chrome ارائه می‌کنیم. برای مثال، نشانک‌هایی که به صورت محلی در یک دستگاه ذخیره می‌شوند، پس از ورود به سیستم، محلی باقی می‌مانند. کاربران می توانند به صورت اختیاری انتخاب کنند که چنین داده هایی را به صورت جداگانه یا انبوه در حساب Google خود آپلود کنند. برای اینکه برنامه‌های افزودنی از این موارد پشتیبانی کنند، داده‌های جدیدی را در API برنامه‌های افزودنی Chrome در معرض نمایش قرار می‌دهیم. اطلاعات زیر به هر نویسنده ای از برنامه های افزودنی Chrome که از chrome.bookmarks API استفاده می کنند مربوط می شود.

نمای کلی

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

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

تغییرات API دقیق

برای کاربرانی که ترکیبی از نشانک‌های همگام‌سازی و غیرهمگام‌سازی دارند، API نشانک‌ها ممکن است درختی مشابه شکل زیر در getTree API برگرداند:

  • id=A (نام: "نوار نشانک‌ها"، نوع پوشه: "نوار نشانک‌ها"، همگام‌سازی: درست)
  • id=B (نام: «سایر نشانک‌ها»، نوع پوشه: «دیگر»، همگام‌سازی: درست)
  • id=C (نام: «نوار نشانک‌ها»، نوع پوشه: «نوار نشانک‌ها»، همگام‌سازی: نادرست)
  • id=D (نام: «سایر نشانک‌ها»، نوع پوشه: «دیگر»، همگام‌سازی: نادرست)

برای اینکه توسعه دهندگان برنامه های افزودنی بین این پوشه های سطح بالا تمایز قائل شوند، دو ویژگی جدید به API اضافه شده است:

  • folderType : این به برنامه های افزودنی اجازه می دهد تا پوشه های "ویژه" مانند نوار نشانک ها را شناسایی کنند. توجه داشته باشید که name و id نباید برای این منظور استفاده شود ( name وابسته به محلی است و id ثابت نیست)
  • syncing : به برنامه‌های افزودنی اجازه می‌دهد بین قسمت‌های همگام‌سازی و غیرهمگام‌سازی درخت تمایز قائل شوند. اگر کاربر وارد سیستم شده باشد و همگام‌سازی را فعال کرده باشد، این قبل از تغییر مدل هویت true خواهد بود.

به روز رسانی برنامه های افزودنی

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

  • اگر برنامه افزودنی شما نتیجه کامل getTree را به کاربر نمایش می‌دهد تا از نمایش نسخه‌های با نام یکسان مثلاً نوار نشانک‌ها جلوگیری کند. ممکن است بخواهید پسوندی را به نام اضافه کنید، یا درمان رابط کاربری دیگری ارائه دهید.
  • اگر برنامه افزودنی شما تلاش می‌کند نوار نشانک‌ها، پوشه‌های دائمی دیگر یا تلفن همراه را با id یا name مطابقت دهد. این روش‌ها قبلاً پشتیبانی نمی‌شدند.
  • اگر برنامه افزودنی شما فرض کند که دقیقاً یا حداکثر یک نمونه از نوار نشانک‌ها، پوشه‌های دائمی دیگر یا تلفن همراه وجود دارد.

تست کردن

ویژگی‌های جدید folderType و syncing افزونه API در آخرین نسخه Chrome Canary (نسخه 138.0.7196.0 یا جدیدتر) مستند شده و در دسترس است.

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

  1. هر دو مورد زیر را در chrome://flags فعال کنید و کروم را مجددا راه اندازی کنید
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. یک نمایه Chrome جدید اضافه کنید (https://support.google.com/chrome/answer/2364824)
    • وارد سیستم نشوید: «ادامه بدون حساب» را انتخاب کنید.
  3. اگر صفحاتی را نشانک گذاری کنید، به فضای ذخیره سازی غیرهمگام سازی اضافه می شوند.
  4. اکنون وارد کروم شوید:
    • روی آن تصویر آواتار در بالا سمت راست، در کنار منوی سه نقطه کلیک کنید.
    • روی «ورود به Chrome» کلیک کنید و دستورات را دنبال کنید.
    • وقتی از شما پرسیده شد که آیا می‌خواهید همگام‌سازی را روشن کنید، «نه متشکرم» را انتخاب کنید.
  5. اگر صفحاتی را نشانک گذاری کنید، آنها به فضای ذخیره سازی همگام سازی اضافه می شوند (به شما امکان می دهد جعبه ذخیره سازی دوگانه را آزمایش کنید).

جدول زمانی

تغییرات برای افشای فضای ذخیره‌سازی دوگانه به‌تدریج انجام می‌شود و برای زیرمجموعه‌ای از کاربران کانال پایدار Chrome قبل از پایان ژوئن 2025 شروع می‌شود و برای درصد کمی از کاربران شروع می‌شود و سپس در هفته‌های بعد به‌طور گسترده‌تر منتشر می‌شود.