Библиотека CADBase для FreeCAD

Контроль версий, облачное хранилище и командная работа

Синхронизация FreeCAD с CADBase

Оглавление

Библиотека CADBase

Библиотека CADBase (CADBase Library) — это мост между FreeCAD и платформой CADBase, который добавляет к локальному проектированию преимущества облачного проектирования:

  1. Доступность — работайте с проектами с любого устройства.
  2. Хранилище проектов — синхронизация FreeCAD с облачным хранилищем.
  3. Работайте в команде — параллельная разработка компонентов и модификаций.
  4. Безопасность — надёжное хранилище и эффективное управление версиями.
  5. Библиотека компонентов — используйте готовые детали с моделями для FreeCAD.

Сохраняйте проекты через дополнение CADBase Library для FreeCAD и получайте доступ к компонентам с любого компьютера.

Наборы файлов на платформе CADBase

Концепция наборов файлов

Наборы файлов организуют данные по программам внутри модификации компонента. Например, конструктор работает с набором FreeCAD, а документация прикрепляется непосредственно к модификации.

Ограничений на хранение данных в наборе нет — можно загружать любые файлы.

Специализация наборов

  • FreeCAD — чертежи, модели и ресурсы для проектирования в FreeCAD.
  • Прочие наборы — файлы из различных САПР и программного обеспечения.

Как работает дополнение

Дополнение создаёт иерархию папок компонентов и синхронизирует только файлы набора FreeCAD. Это позволяет команде работать параллельно в разных приложениях без конфликтов версий.

Установка и настройка

Установка через Менеджер дополнений FreeCAD

Это самый простой способ установкиCADBase Library:

  1. В главном меню FreeCAD выберите Инструменты откройте Менеджер дополнений.
  2. Дождитесь, когда обновится список доступных дополнений.
  3. В строке поиска введите “CADBase Library” и выберите найденный верстак.
  4. Нажмите кнопку Установить и дождитесь окончания процесса.
  5. Перезапустите FreeCAD.
  6. После перезапуска в списке верстаков появится Библиотека CADBase.
Важное требование:

Для работы с CADBase Library необходима версия FreeCAD 0.21 или выше.

Настройка

Первый запуск и настройка

После перезапуска FreeCAD:

  1. Выберите верстак Библиотека CADBase.
  2. Укажите папку для локальной библиотеки.
    Ваши компоненты из CADBase будут доступны в этой папке.
Выбор верстака Библиотека CADBase

Конфигурация верстака

Чтобы открыть окно Конфигурация библиотеки CADBase:

  1. В окне Библиотека CADBase перейдите на вкладку Опции.
  2. Нажмите кнопку Настройки.
Настройка пути библиотеки

Укажите папку на вашем компьютере, в которой будет храниться локальная библиотека компонентов.

Важно:

Изменения вступят в силу после перезапуска FreeCAD. При изменении пути существующие файлы не переносятся автоматически.

Адрес сервера

Укажите URL или IP-адрес сервера CADBase для подключения.

Для возврата настройки в значение по умолчанию, достаточно нажать Сбросить.

Настройки дополнения CADBase Library в FreeCAD
Параметры загрузки

Настройте логику работы с облачным хранилищем:

Пропускать вычисление хеша
Загружает только новые файлы, не проверяя изменения в существующих.

Принудительное обновление файлов
Обновляет все файлы в облаке, игнорируя проверки.

Примечание:

Эти настройки влияют только на отправку данных в облако. При скачивании файлы никогда не перезаписываются автоматически.

Авторизация на платформе CADBase

Для работы с облачным хранилищем необходимо получить токен доступа:

  1. Нажмите кнопку Авторизация в окне Библиотека CADBase.
  2. В открывшемся окне введите:
    • Имя пользователя (ваш логин)
    • Пароль
  3. Для новых пользователей: отметьте Устанавливается для создания нового пользователя....
  4. Нажмите кнопку OK для получения токена.
  5. Дождитесь завершения авторизации.
Учётные данные CADBase Library в FreeCAD

Данные авторизации будут сохранены — при следующих запусках FreeCAD ввод пароля не потребуется.

Обновление токена: повторите шаги 1 и 4.

Проверка работы

Убедитесь, что библиотека корректно подключена к вашему аккаунту:

  1. Переключитесь на верстак Библиотека CADBase.
  2. Нажмите Обновить список.

    Кнопка Обновить список в интерфейсе CADBase Library для обновления списка компонентов
  3. Дождитесь появления ваших избранных компонентов в дереве библиотеки.

Примечание: После нажатия кнопки дождитесь завершения процесса... Время зависит от объема данных и скорости интернета. Не закрывайте FreeCAD и не прерывайте процесс, иначе данные не загрузятся полностью.

Готово! Если вы видите список компонентов — настройка прошла успешно. Можно переходить к работе с библиотекой.

Практическое применение

Создание нового компонента

Компонентом может быть деталь, сборка, узел или любой другой объект конструкторской разработки.

Создание компонента в библиотеке CADBase через FreeCAD — 3 шага:

  1. Нажмите кнопку Новый компонент.
  2. Введите название компонента в диалоговом окне.

    Диалоговое окно добавления нового компонента с полем для ввода названия
  3. Нажмите OK для создания.

Процесс создания компонента

После создания:

  • Компонент появится в ваших закладках.
  • Будет создана начальная модификация N1.
  • Список компонентов в библиотеке обновится.

Создание структуры компонента

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

  1. Найдите созданный компонент в дереве библиотеки.
  2. Дважды нажмите на него.
    Система создаст папки модификации и наборов файлов.

Сохранение документа в наборе файлов

Свяжите документ с компонентом для дальнейшей синхронизации:

  1. Откройте или создайте документ FreeCAD.
  2. Сохраните его в папку набора файлов:
    Библиотека CADBaseКомпонентN1📁FreeCAD
Примечание:

Файлы из этой папки будут загружаться в облако при отправке изменений.

Расположение папки набора файлов FreeCAD

Расположение папки FreeCAD

Отправка данных

Чтобы отправить изменения в облако:

  1. Выберите модификацию с изменёнными файлами.
    Можно выбрать папку модификации или конкретно папку набора файлов FreeCAD.
  2. Нажмите кнопку Выгрузить файлы.
  3. Проверьте изменения в открывшемся окне:
    Диалог отправки данных в удалённое хранилище CADBase: сообщение о фиксации и список изменений

    Окно отправки файлов (пример)

    новый — файл добавится в облако
    изменён — файл заменит старую версию в облаке
    удалён — файл удалится из облака
  4. Добавьте комментарий к изменениям (необязательно).
    Поможет коллегам понять, что было изменено.
  5. Нажмите OK для начала загрузки.
    Отправка изменений начнётся после нажатия кнопки.

Прогресс отправки можно отслеживать в панели Просмотр отчёта FreeCAD.

Замена локального файла

Если нужно загрузить свежую версию файла из облака:

  1. Найдите файл в дереве библиотеки и нажмите Открыть каталог.
  2. Удалите файл в открывшейся папке.
  3. Вернитесь в FreeCAD и дважды нажмите на папку набора файлов.
    Система загрузит актуальную версию из облака.
Когда это нужно?

Если файл был изменён в облаке другим пользователем или вы хотите откатить свои изменения.

Кнопка для открытия папки с файлами

Импорт файлов в документ

Добавьте готовые детали и сборки в свой проект:

  1. Найдите файл в библиотеке компонентов.
  2. Нажмите Объединить или дважды кликните по файлу.
  3. Модель появится в вашем документе.
    Как отдельный объект для редактирования.

Удобно для: сборок, использования стандартных деталей, работы над сложными проектами по частям.

Импорт модели в текущий документ FreeCAD

Управление закладками

Закладки помогают быстро находить нужные компоненты. Управляйте ими на платформе CADBase:

  1. Найдите компонент через поиск на CADBase.
  2. Откройте страницу компонента.
  3. Нажмите значок закладки на странице компонента.
    Добавляет или убирает из закладок.
Примечание:

Новые закладки появятся после обновления списка.
Уже загруженные компоненты останутся в библиотеке, даже если убрать их из закладок.

Управление закладками на платформе

Настройка доступа к компоненту

Новые компоненты по умолчанию закрытые (приватные). Чтобы открыть доступ:

  1. Нажмите Копировать ссылку на компоненте.
  2. Откройте ссылку в браузере.
  3. В настройках компонента измените доступ на “публичный”.
  4. Сохраните изменение.

Теперь компонент виден другим пользователям.

Настройка доступа компонента на платформе CADBase — выбор типа доступа

Выбор типа доступа на платформе CADBase

Часто задаваемые вопросы (FAQ)

Можно ли работать офлайн?

Да, с ранее загруженными компонентами.

Что происходит при конфликте версий?

Приоритет у локальной версии.

Можно ли использовать один аккаунт на нескольких компьютерах?

Да, без ограничений.

Можно ли использовать специальные символы в названиях?

Можно использовать любые символы, но учитывайте, что названия компонентов станут именами папок в файловой системе.

Какие файлы можно импортировать в документ?

Поддерживаются форматы FCStd, STEP, BRP и BREP.

Как обеспечивается безопасность данных?

Гибкая система управления доступом позволяет настраивать права доступа к данным, для отдельных пользователей и компаний.

Верстак может работать в Интранет (изолированной сети)?

Да, для этого потребуется развернуть серверную часть внутри сети.

Диагностика и решение проблем (Troubleshooting)

Ошибка авторизации

Обновите токен через кнопку Авторизация.

Нет подключения

Проверьте подключение к интернету и доступ к заданному в Server URL адресу.

Не отображаются компоненты

Убедитесь, что они добавлены в избранное на сайте.

Не применяются настройки

Для некоторых настроек требуется перезапуск FreeCAD.

Нет доступа к серверу api.cadbase.rs

В настройках верстака переключитесь на сервер https://api.cadbase.ru.

Не обновляются файлы в облаке (ошибки с SHA256)

Включите Принудительное обновление файлов в настройках.

Файлы не синхронизируются (неактуальные UUID)

Удалите файлы component из папки компонента и modification из набора файлов.

Отладка

Создайте файл cadbase_file_2018.log в корне библиотеки, в нём будут сохраняться логи и другие данные для отладки.

Расширьте возможности FreeCAD: добавьте контроль версий и безопасную совместную работу.


  • CADBase Library для FreeCAD разрабатывается и поддерживается командой CADBase.
  • Максимальный размер одного файла - 5 ГБ, каждому пользователю доступно 15 ГБ хранилища.
  • Доступ предоставляется бесплатно, без скрытых платежей и ограничений.