Команда "Менеджер дополнений"
Менеджер дополнений |
Системное название |
---|
Нет |
Расположение в меню |
Инструменты → Менеджер дополнений |
Верстаки |
N/A |
Быстрые клавиши |
Нет |
Представлено в версии |
0.17 |
См. также |
Макросы, External workbenches |
Менеджер дополнений — инструмент для установки и управления дополнениями рабочих окружений и макросами, предоставляемых сообществом FreeCAD. Полный перечень рабочих окружений доступен в репозитории дополнений.
The lists of installable workbenches and macros are taken from two repositories, FreeCAD-addons and FreeCAD-macros, respectively, and from the Macros recipes.
Interface of the Addon Manager
Использование
- Open the tool in the menu Tools → Addon manager.
- To install a workbench: scroll through the list and select the add-on; a short description, as well as its home page, will be displayed below the list. Press the Install/update button to install the new tool. For macros, click on the Macros tab and repeat the steps.
- To remove a workbench or a macro: scroll through the list, select the add-on, and then press the Remove button.
- To update a workbench or a macro: scroll through the list, select the add-on, and then press the Install/update button.
- To check for updates: press the Refresh button; available updates will be reported below the list. Press the Refresh button again to install all updates at once. Note: the icon may look different depending on your operating system.
- To run a macro: first install the desired macro, then select it again on the list, and then press the Execute button. The macro is automatically edited in the FreeCAD macro editor, to visualize the code.
- Press Close to exit the manager.
You will have to restart FreeCAD before new workbenches appear in the list of available workbenches. They are appended at the end, if you want to have them in alphabetical order, you can rearrange them in the Std DlgCustomize dialog.
Manual installation
If you don't use the Addon Manager, you can install the new tools manually by placing their code in your user's FreeCAD/
directory. See the following links for details:
Ограничения
- Дополнения не являются частью официального пакета FreeCAD и не поддерживаются командой FreeCAD. Перед установкой дополнения, ознакомьтесь с информацией предоставляемой на его странице, чтобы узнать о возможностях данного дополнения.
- Сообщения об ошибках и запрос новых возможностей должны быть выполнены непосредственно на страницах дополнений.
- The web addresses of the repositories for add-ons and macros are hard coded into the AddonManager. As this application is written in Python, experienced users can change these locations by editing the appropriate fields in
$ROOT/Mod/AddonManager/AddonManager.py
- where
$ROOT
is the installation directory of FreeCAD in your particular system, for example,- Linux:
/usr/lib/freecad/Mod/AddonManager/AddonManager.py
- Windows:
C:\Program Files\FreeCAD version\Mod\AddonManager.py
- Linux:
New workbenches and macros
If you developed a workbench or macro, and want to see it included in the Addon Manager, read how to do that on the repository pages (FreeCAD-addons and FreeCAD-macros). If you add your macro to the Macros recipes, there is nothing else to do, it will automatically be picked by the Addon Manager.
For python workbenches, you don't need any specific approval to have your workbench added to the Addon Manager and, being outside the FreeCAD source code, you can choose the license you want. If you request for your workbench to be added to the list (we will not add any new workbench without a request from its authors), either by asking so on the forum or by opening an issue on the FreeCAD-addons repository, your code will stay on your own git repository, we will just add it as a submodule to the FreeCAD-addons repository. Of course, before adding your workbench, we will take a look at it and make sure there is nothing potentially problematic with it.
If you develop a workbench in C++, it cannot be run directly by users and must be compiled first. You then have 2 options, either you provide precompiled versions of your workbench yourself, for the different operating systems, or you should request to have your code merged into the FreeCAD source code. For that, you should use the LGPL license (or fully compatible like MIT or BSD), and you must present your new tools to the community in the FreeCAD forum for review. Once your code has been tested and approved, you should fork the FreeCAD repository, if not done yet, create a new branch, push your code to it, and open a pull request so that your branch is merged into the main repository.
Testing the Addon Manager
The Addon Manager is coded in Python so it's possible to change the source code without compiling it. More specifically, testing requires modifying the code in FreeCAD/src/Mod/AddonManager
and simply re-running FreeCAD.
To test downloading capability of the Addon Manager you can simulate a need to download say, a previous version of a workbench via the CLI. In the following example we'll use the Assembly2+ workbench (or A2plus for short):
cd ~/FreeCAD/Mod/A2plus/
git reset --hard "v0.4.21"
CLI output should show HEAD is now at b2c53a4 Merge pull request #281 from kbwbe/devel
What we essentially did was use a previous release tag to reset the version. Now, in the Addon Manager refresh the list of workbenches and it should show that the A2plus workbench is using an inferior version.
- Стандартное меню: Файл, Правка, Вид, Инструменты, Макросы, Окна, Справка
- Структура: Std Part, Std Group, Std LinkMake
- Файл: Создать, Открыть, Закрыть, Закрыть всё, Сохранить, Сохранить как, Сохранить копию, Сохранить всё, Вернуться, Импортировать, Экспортировать, Объединить проект, Информация о проекте, Печать, Предварительный просмотр, Экспортировать в PDF, Недавние файлы, Выход
- Правка: Отменить, Вернуть, Вырезать, Копировать, Вставить, Дублировать выбранное, Обновить, Выделить область, Box element selection, Выбрать всё, Удалить, Расположение, Выравнивание, Редактировать/закончить редактирование, Настройки
- Вид: Создать новый вид, Ортогональная проекция, Перспективная проекция, На весь экран, Стандартные виды (Уместить всё, Уместить выделенное, Isometric, Dimetric, Trimetric, Спереди, Сверху, Справа, Сзади, Снизу, Слева, Повернуть влево, Повернуть вправо), Freeze display (Save views, Load views, Freeze view, Clear views), Стиль представления (Как есть, Плоские линии, Shaded, Каркас, Точки, Скрытые линии, Без затенения), Bounding box, Стерео (Стерео красный/голубой, Четверная буферизация стерео, Стерео с чередованием строк, Стерео с чередованием столбцов, Выключить стерео, Выводить положения камеры), Масштаб (Увеличить, Уменьшить, Увеличить область), Окно документа (Закреплённое, Откреплённое, На весь экран), Показать/скрыть оси координат, Плоскость сечения, Текстурирование, Видимость (Видимость, Показать выделенные, Скрыть выделенные, Выбрать видимые объекты, Инвертировать все видимости, Показать все объекты, Скрыть все объекты, Откл/вкл выделяемость, Показывать замеры, Удалить замер), Навигация/редактирование, Внешний вид, Случайный цвет, Верстак, Панели инструментов (Файл, Верстак, Макрос, Вид, Структура, Навигация), Панели (Отчёт, Иерархия документа, Окно свойств, Просмотр выделения, Комбо панель, Консоль Python, DAG view), Tree view actions (Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/expand, Initiate dragging, Go to selection), Строка состояния
- Инструменты: Редактор параметров, Сохранить изображение, Инспектор сцены, Граф зависимостей, Project utility, Измерить расстояние, Text document, Поворотный просмотр, Конвертор величин, Настройка, Addon manager
- Макросы: Запись макроса, Остановить запись макроса, Макрос, Выполнить макрос, Отладка макросов, Остановить отладку, Шаг с обходом, Шаг с заходом, Установить/снять точку останова
- Окна: Следующее, Предыдущее, Плиткой, Каскадом, Окна
- Справка: Справка, Сайт FreeCAD, Пользовательская документация, Документация по созданию скриптов на Python, Автоматически сгенерированная документация Python, Форум FreeCAD, FreeCAD ЧаВо, О FreeCAD, Что это?
- Начинающим
- Установка: Загрузка, Windows, Linux, Mac, Дополнительных компонентов, Docker, AppImage, Ubuntu Snap
- Базовая: О FreeCAD, Интерфейс, Навигация мыши, Методы выделения, Имя объекта, Настройки, Верстаки, Структура документа, Свойства, Помоги FreeCAD, Пожертвования
- Помощь: Учебники, Видео учебники
- Верстаки: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework