Обновите расширения перед предстоящими изменениями синхронизации закладок

Джеймс Ли
James Lee

Опубликовано: 17 июня 2025 г.

В августе прошлого года мы анонсировали предстоящие изменения в модели идентификации Chrome на платформах Windows, Mac и Linux, следуя тем, которые уже были запущены на iOS и Android. Цель этих изменений — привести Chrome в соответствие с текущими ожиданиями пользователей относительно входа в систему. Пользователи все чаще ожидают простого входа в систему, чтобы получить доступ к своим данным, включая закладки, и выхода из системы, чтобы сохранить их в безопасности.

В рамках развертывания этих обновлений мы вносим изменения в то, как Chrome хранит закладки на рабочем столе. Например, закладки, которые хранятся локально на устройстве, останутся локальными после входа в систему; пользователи могут по желанию загружать такие данные в свою учетную запись Google по отдельности или оптом. Чтобы расширения могли поддерживать их, мы предоставляем новые данные в API расширений Chrome . Следующая информация актуальна для всех авторов расширений Chrome, которые используют API chrome.bookmarks .

Обзор

Сегодня пользователи всегда имеют один набор папок верхнего уровня, включая папки «Панель закладок» и «Другие закладки». Данные в этих папках могут быть или не быть синхронизированы в зависимости от того, вошел ли пользователь в систему с включенной синхронизацией или нет.

В рамках изменений модели идентификации Chrome разделит синхронизируемые и несинхронизируемые закладки на два отдельных поддерева в дереве закладок . В некоторых случаях, когда пользователь не решил загрузить все свои закладки в свою учетную запись, у пользователя могут быть как синхронизируемые, так и несинхронизируемые папки закладок одновременно. Расширения, использующие API закладок, могут нуждаться в обновлении, чтобы отображать дерево закладок понятным для пользователей способом.

Подробные изменения API

Для пользователей, имеющих как синхронизируемые, так и несинхронизируемые закладки, API закладок может возвращать дерево, подобное следующему в API getTree :

  • id=A (имя: "Панель закладок", тип папки: "bookmarks-bar", синхронизация: true)
    • …
  • id=B (имя: "Другие закладки", тип папки: "другие", синхронизация: true)
    • …
  • id=C (имя: "Панель закладок", тип папки: "bookmarks-bar", синхронизация: false)
    • …
  • id=D (имя: "Другие закладки", тип папки: "другие", синхронизация: false)
    • …

Чтобы разработчики расширений могли различать эти папки верхнего уровня, в API были добавлены два новых свойства:

  • folderType : это позволяет расширениям идентифицировать "специальные" папки, такие как панель закладок. Обратите внимание, что name и id не должны использоваться для этой цели ( name зависит от локали, а id не является фиксированным)
  • syncing : чтобы позволить расширениям различать синхронизирующиеся и несинхронизирующиеся части дерева. Это будет true до изменения модели идентификации, если пользователь вошел в систему и включил синхронизацию.

Обновления расширений

Если для вашего расширения верно что-либо из следующего, вам может потребоваться внести обновления:

  • Если ваше расширение отображает пользователю полный результат getTree, чтобы предотвратить отображение версий с одинаковыми именами, например, панели закладок. Вы можете добавить суффикс к имени или предоставить какую-либо другую обработку пользовательского интерфейса.
  • Если ваше расширение пытается сопоставить bookmarks-bar, other или mobile permanent folders по id или name . Эти методы уже не поддерживались.
  • Если ваше расширение предполагает, что существует ровно или максимум один экземпляр панели закладок, других или мобильных постоянных папок

Тестирование

Новые свойства API folderType и расширения syncing задокументированы и доступны в последней версии Chrome Canary (версия 138.0.7196.0 или более поздняя).

Пользователи в стабильных каналах Chrome имеют одно хранилище (то есть максимум по одному из каждого типа папок). Для целей тестирования вы можете включить двойное хранилище следующим образом:

  1. Включите оба следующих параметра в chrome://flags и перезапустите Chrome.
    • синхронизация-включение-закладок-в-транспортном-режиме
    • включить-закладки-выбранный-тип-при-входе-для-тестирования
  2. Добавьте новый профиль Chrome (https://support.google.com/chrome/answer/2364824)
    • Не входите в систему: выберите «Продолжить без учетной записи».
  3. Если вы добавите страницы в закладки, они будут добавлены в несинхронизируемое хранилище.
  4. Теперь войдите в Chrome:
    • Нажмите на изображение аватара в правом верхнем углу, рядом с меню в виде трех точек.
    • Нажмите «Войти в Chrome» и следуйте инструкциям.
    • На вопрос о том, хотите ли вы включить синхронизацию, ответьте «Нет, спасибо».
  5. Если вы добавите страницы в закладки, они будут добавлены в синхронизируемое хранилище (что позволит вам протестировать вариант с двойным хранилищем).

Хронология

Изменения, позволяющие использовать двойное хранилище, будут внедряться постепенно и начнут внедряться для части пользователей стабильной версии Chrome не ранее конца июня 2025 года . Сначала это произойдет для небольшого процента пользователей, а затем в течение следующих недель будет реализовано более широкое внедрение.