FISYCO читает ваши макеты через подключённый аккаунт Figma. Этим аккаунтом он открывает файлы библиотек, и на него же приходит вебхук после каждой публикации. На этой странице: кто может подключить аккаунт, как указать библиотеке файл и что именно FISYCO читает.
Перед началом
- Чтобы подключить аккаунт для всего рабочего пространства, нужна роль владельца или администратора. Для одного проекта достаточно быть его мейнтейнером.
- Аккаунт Figma может открыть файлы, которые вы хотите синхронизировать.
- Если нужны компоненты или стили, файл опубликован как библиотека команды. Почему это важно, объяснено ниже.
Подключите аккаунт Figma
Проект нельзя создать без аккаунта Figma, поэтому первое подключение обычно происходит при создании проекта.
- Нажмите Создать проект. На шаге Figma нажмите Подключить Figma.
- Figma попросит разрешить доступ. Подтвердите, и вы вернётесь в FISYCO.
- Если в рабочем пространстве уже есть аккаунт, выберите его в блоке Каким аккаунтом Figma проект будет читать файлы? или нажмите Подключить другой аккаунт.
Выбор существующего аккаунта ничего не переавторизует. Проекты делят одно подключение на аккаунт, поэтому остальные продолжают работать.
Чтобы у проекта был собственный аккаунт, откройте проект, затем Настройки → Интеграции, и нажмите Подключить Figma. Такое подключение сначала доступно только этому проекту.
Figma хранит для FISYCO один грант на аккаунт. Если авторизовать тот же аккаунт Figma в другом рабочем пространстве, прежний грант погаснет, а библиотеки там встанут на паузу до переподключения. Выбирайте уже подключённый аккаунт, а не подключайте его второй раз.
Где видны подключения
Откройте меню аккаунта, затем Настройки рабочего пространства → Подключения. У каждого аккаунта Figma своя строка: чей это аккаунт, его статус, кто подключил, когда проверялся и какие проекты через него читают. Владельцы и администраторы могут добавить аккаунт для всего рабочего пространства кнопкой Переподключить вверху страницы.
Кто может пользоваться подключением, решают две настройки:
Новое подключение считается личным. Просматривать файлы через него при настройке библиотеки может только тот, кто его подключил. Служебный аккаунт доступен всем в его области, поэтому заводите под него отдельный аккаунт Figma.
Отозвать стирает сохранённые токены и ставит библиотеки подключения на паузу, пока проект не выберет другой аккаунт. Отозвать могут владельцы, администраторы и тот, кто подключил. Сам грант на стороне Figma так не отзывается: у Figma нет для этого API. Повторное подключение того же аккаунта возвращает доступ и снимает библиотеки с паузы.
Укажите библиотеке файл
Библиотека читает один файл Figma. Создают её мейнтейнеры проекта, а также владельцы и администраторы рабочего пространства.
- В проекте нажмите Добавить библиотеку, выберите тип и нажмите Продолжить.
- Введите Название и вставьте ссылку на файл в поле Figma файл. Подойдёт и ключ файла.
- Выберите, что читать. Иконки и иллюстрации просят Страницы и секции: отметка страницы выбирает все её секции. Библиотека токенов вместо этого предлагает группы стилей и переменных.
- Пройдите остальные шаги и нажмите Создать библиотеку.
После этого FISYCO подписывается на публикации файла и сразу запускает первую синхронизацию. Библиотеку компонентов создают из дизайн-системы, подробности в статье Библиотека компонентов.
Что FISYCO читает
При подключении FISYCO просит у Figma доступ на чтение содержимого файлов, версий, библиотек и вашего профиля, а также право управлять вебхуками. Права менять ваши файлы он не просит.
Опубликуйте файл как библиотеку
Figma REST API отдаёт компоненты и стили только после публикации файла как библиотеки команды. До этого FISYCO нечего читать. Библиотека компонентов на неопубликованном файле покажет на шаге источника Библиотека Figma не опубликована. Опубликуйте библиотеку в Figma (Assets → Publish) и откройте шаг заново.
Публикация служит и сигналом для автоматической синхронизации. Простого сохранения файла мало: в истории версий Figma есть и автосохранения, поэтому FISYCO ориентируется на публикации.
Вебхуки после публикации
Каждая публикация отправляет FISYCO вебхук, и все библиотеки на этом файле синхронизируются сами. Одна подписка на пару «аккаунт и файл» обслуживает все проекты, которые её используют.
Подписка видна в блоке Зарегистрированные вебхуки в разделе проекта Настройки → Интеграции, со статусом Работает, Сломан или Ещё не проверен. FISYCO спрашивает Figma о её состоянии каждые пять минут. Если вебхук перестал работать, FISYCO каждые 30 секунд проверяет последнюю публикацию файла, пока вебхук не починят.
После синхронизации изменения библиотеки приходят в код через pull request в репозиторий, который вы подключаете по инструкции Подключение репозитория.