Std AddonMgr/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 21: Line 21:
==Descripción==
==Descripción==


<div class="mw-translate-fuzzy">
El comando '''Std GestorComplementos''' abre el gestor de complementos. Con el gestor de complementos puedes instalar y gestionar [[external_workbenches/es|Ambientes de trabajo externos]] y [[macros/es|Macros]] proporcionados por la comunidad de FreeCAD. Las Ambientes de trabajo y macros disponibles se toman de dos repositorios, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] y [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], y de la página [[Macros_recipes/es|Recetas de macros]].
El comando '''Std GestorComplementos''' abre el gestor de complementos. Con el gestor de complementos puedes instalar y gestionar [[external_workbenches/es|Ambientes de trabajo externos]] y [[macros/es|Macros]] proporcionados por la comunidad de FreeCAD. Las Ambientes de trabajo y macros disponibles se toman de dos repositorios, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] y [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], y de la página [[Macros_recipes/es|Recetas de macros]].
</div>


<div class="mw-translate-fuzzy">
Los Complementos marcados como {{emphasis|Sólo Python 2}} no funcionarán en FreeCAD versión 0.19 o superior.

Debido a los cambios en la plataforma GitHub en el año 2020 el gestor de Addons ya no funciona si utilizas la versión 0.17 o anterior de FreeCAD. Necesitas actualizar a la versión [https://github.com/FreeCAD/FreeCAD/releases/tag/0.18.5 0.18.5] o a una versión reciente [https://github.com/FreeCAD/FreeCAD/releases/tag/0.19_pre 0.19]. Alternativamente puedes instalar addons manualmente, ver [[#Notas|Notas]] abajo.
Debido a los cambios en la plataforma GitHub en el año 2020 el gestor de Addons ya no funciona si utilizas la versión 0.17 o anterior de FreeCAD. Necesitas actualizar a la versión [https://github.com/FreeCAD/FreeCAD/releases/tag/0.18.5 0.18.5] o a una versión reciente [https://github.com/FreeCAD/FreeCAD/releases/tag/0.19_pre 0.19]. Alternativamente puedes instalar addons manualmente, ver [[#Notas|Notas]] abajo.
</div>

[[Image:Std_AddonMgr_dialog.png]]
{{Caption|El cuadro diálogo del gestor complementos}}


==Utilización==
==Utilización==


<div class="mw-translate-fuzzy">
# Seleccione la opción {{MenuCommand|Herramientas → [[Image:Std_AddonMgr.svg|16px]] Gestor complementos}} en el menú.
# Seleccione la opción {{MenuCommand|Herramientas → [[Image:Std_AddonMgr.svg|16px]] Gestor complementos}} en el menú.
# Si es la primera vez que utiliza el gestor complementos, se abrirá un cuadro de diálogo advirtiéndole de que los complementos del gestor de complementos no forman parte oficialmente de FreeCAD. Pulsa el botón {{Button|OK}} para confirmar y continuar.
# Si es la primera vez que utiliza el gestor complementos, se abrirá un cuadro de diálogo advirtiéndole de que los complementos del gestor de complementos no forman parte oficialmente de FreeCAD. Pulsa el botón {{Button|OK}} para confirmar y continuar.
Line 38: Line 38:
# Pulse el botón {{Button|[[Image:Process-stop.svg|16px]] Cerrar}} para cerrar el cuadro de diálogo.
# Pulse el botón {{Button|[[Image:Process-stop.svg|16px]] Cerrar}} para cerrar el cuadro de diálogo.
# Si has instalado o actualizado un ambiente de trabajo se abrirá un nuevo cuadro de diálogo informando de que tienes que reiniciar FreeCAD para que los cambios surtan efecto.
# Si has instalado o actualizado un ambiente de trabajo se abrirá un nuevo cuadro de diálogo informando de que tienes que reiniciar FreeCAD para que los cambios surtan efecto.
</div>


==Opciones==
==Opciones==


[[File:AddonManager_Main.png|600px]]
El cuadro diálogo del gestor complementos tiene dos pestañas a la izquierda, una con los ambientes de trabajo disponibles y otra con las macros disponibles. El panel de información de la derecha mostrará la página de inicio del complemento seleccionado.


# The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
===Desinstalación===
# Three different types of addons are supported: [[external_workbenches|workbenches]], [[macros|macros]], and [[Preference_Packs|preference packs]]. You can choose to show just one type, or all of them in a single list.
# The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
# The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
# The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a [[Package_Metadata|package metadata]] file (or for macros with embedded metadata).
# Addon data is cached locally, with a variable cache update frequency set in the user preferences.
# At any time you can choose to manually update your local cache to see the latest updates available for each addon.
# Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.


Clicking on an addon in this view brings up the addon's Details page:
# Seleccione un complemento instalado en la [[Image:Folder.svg|16px]] '''Ambientes de trabajo''' o en la pestaña [[Image:Applications-python.svg|16px]] Pestaña '''Macros'''.
# Pulse el {{Button|[[Image:Delete.svg|16px]] Desinstalar seleccionado}} botón.


[[File:AddonManager_Details.png|600px]]
===Instalación/actualización===


The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).
# Seleccione un complemento en la [[Image:Folder.svg|16px]] '''Ambiente de trabajo''' o en la pestaña [[Image:Applications-python.svg|16px]] Pestaña '''Macros'''.
# Pulse el {{Button|[[Image:Edit_OK.svg|16px]] Instalar/actualizar seleccionada}} botón.
# Si desea añadir una macro a una barra de herramientas personalizada, no olvide descargar manualmente el archivo de imagen del icono, si está disponible, haciendo clic en el enlace de la página principal del panel de información. Ver [[Interface_Customization/es#Barras de herramientas|Personalización de la interfaz]].
# Para cambiar la posición de un ambiente de trabajo complemento en la lista [[Std_Workbench/es|Selector de ambientes de trabajo]] vea [[Interface_Customization/es#Ambientes de trabajo]].


==Preferences==
===Configuración===


The preferences for the Addon manager can be found in the [[Preferences_Editor#Addon_Manager|Preferences Editor]]. {{Version|0.20}}
# Pulse el {{Button|[[Image:Preferences-general.svg|16px]] Configurar...}} botón.
# Se abre el cuadro de diálogo de opciones del gestor complementos.
# Opcionalmente, marque la casilla {{CheckBox|TRUE|Automatically check for updates at start (requires GitPython)}} casilla de verificación.
# Opcionalmente añada repositorios a la lista de '''Repositorios personalizados'''. Los complementos de estos repositorios se añadirán en la [[Image:Folder.svg|16px]] '''Ambientes de trabajo''' o en la pestaña [[Image:Applications-python.svg|16px]] Pestaña '''Macros'''.
# Opcionalmente elige la configuración del proxy.
# Pulse el botón {{Button|Aceptar}} o el botón {{Button|Cancelar}} para cerrar el cuadro de diálogo.


==Notas==
==Notas==


<div class="mw-translate-fuzzy">
* El uso de los complementos no está restringido a la versión de FreeCAD desde la que fueron instalados. También podrás utilizarlos en cualquier otra versión de FreeCAD, soportada por el complemento, que puedas tener en tu sistema.
* El uso de los complementos no está restringido a la versión de FreeCAD desde la que fueron instalados. También podrás utilizarlos en cualquier otra versión de FreeCAD, soportada por el complemento, que puedas tener en tu sistema.
* Los complementos disponibles en el gestor complementos no son parte del programa oficial de FreeCAD y no están soportados por el equipo de desarrollo de FreeCAD. Debes leer la información proporcionada cuidadosamente para asegurarte de que sabes lo que estás instalando.
* Los complementos disponibles en el gestor complementos no son parte del programa oficial de FreeCAD y no están soportados por el equipo de desarrollo de FreeCAD. Debes leer la información proporcionada cuidadosamente para asegurarte de que sabes lo que estás instalando.
Line 71: Line 71:
* Si el paquete [https://github.com/gitpython-developers/GitPython GitPython] está instalado en tu ordenador, el gestor complementos lo utilizará, haciendo que las descargas sean más rápidas.
* Si el paquete [https://github.com/gitpython-developers/GitPython GitPython] está instalado en tu ordenador, el gestor complementos lo utilizará, haciendo que las descargas sean más rápidas.
* También puedes instalar complementos manualmente. Ver [[How_to_install_additional_workbenches/es|Cómo instalar ambientes de trabajo adicionales]] y [[How_to_install_macros/es|Cómo instalar macros]].
* También puedes instalar complementos manualmente. Ver [[How_to_install_additional_workbenches/es|Cómo instalar ambientes de trabajo adicionales]] y [[How_to_install_macros/es|Cómo instalar macros]].

==Información para desarrolladores==

Si has desarrollado un ambiente de trabajo o macro, y quieres verlo incluido en el gestor complementos, lee cómo hacerlo en las páginas del repositorio: ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-complementos] y [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si añades tu macro a la página [[Macros_recipes/es|Recetas de macros]], no hay nada más que hacer, será automáticamente recogida por el gestor complementos.

===Ambientes de trabajo Python===

<div class="mw-translate-fuzzy">
Para las ambientes de trabajo en python, no necesitas ninguna aprobación específica para que tu ambientes de trabajo sea añadido al gestor de complementos y, al estar fuera del código fuente de FreeCAD, puedes elegir la licencia que quieras. Si solicitas que tu ambiente de trabajo sea añadido a la lista (no añadiremos ningún nuevo ambiente de trabajo sin una petición de sus autores), ya sea pidiéndolo en el foro o abriendo una incidencia en el repositorio [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons], tu código permanecerá en tu propio repositorio git, sólo lo añadiremos como un submódulo al repositorio [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-complementos]. Por supuesto, antes de añadir tu ambiente de trabajo, le echaremos un vistazo y nos aseguraremos de que no hay nada potencialmente problemático en él.
</div>
</div>


==Información para desarrolladores==
===Ambientes de trabajo C++===


See [[Addon#Information_for_developers|Addon]].
Si desarrollas un ambiente de trabajo en C++, no puede ser ejecutado directamente por los usuarios y debe ser compilado primero. Entonces tienes dos opciones, o proporcionas versiones precompiladas de tu ambiente de trabajo tú mismo, para los diferentes sistemas operativos, o debes solicitar que tu código se fusione con el código fuente de FreeCAD. Para ello, debes utilizar la licencia LGPL (o una licencia totalmente compatible como MIT o BSD), y debes presentar tus nuevas herramientas a la comunidad en el [https://forum.freecadweb.org FreeCAD forum] para su revisión. Una vez que tu código ha sido probado y aprobado, debes hacer un fork del repositorio de FreeCAD, si no lo has hecho todavía, crear una nueva rama, empujar tu código a ella, y abrir una solicitud de pull para que tu rama se fusione con el repositorio principal.




Line 98: Line 89:
{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 08:43, 9 September 2022

Std GestorComplementos

Ubicación en el Menú
Herramientas → Gestor Complementos
Entornos de trabajo
Todo
Atajo de teclado por defecto
Ninguno
Introducido en versión
0.17
Ver también
Ambientes de trabajo externos, Macros

Descripción

El comando Std GestorComplementos abre el gestor de complementos. Con el gestor de complementos puedes instalar y gestionar Ambientes de trabajo externos y Macros proporcionados por la comunidad de FreeCAD. Las Ambientes de trabajo y macros disponibles se toman de dos repositorios, FreeCAD-addons y FreeCAD-macros, y de la página Recetas de macros.

Debido a los cambios en la plataforma GitHub en el año 2020 el gestor de Addons ya no funciona si utilizas la versión 0.17 o anterior de FreeCAD. Necesitas actualizar a la versión 0.18.5 o a una versión reciente 0.19. Alternativamente puedes instalar addons manualmente, ver Notas abajo.

Utilización

  1. Seleccione la opción Herramientas → Gestor complementos en el menú.
  2. Si es la primera vez que utiliza el gestor complementos, se abrirá un cuadro de diálogo advirtiéndole de que los complementos del gestor de complementos no forman parte oficialmente de FreeCAD. Pulsa el botón OK para confirmar y continuar.
  3. Se abre el cuadro de diálogo del Gestor complementos. Para más información ver Opciones.
  4. El botón Actualizar todo no funciona en este momento.
  5. Pulse el botón Cerrar para cerrar el cuadro de diálogo.
  6. Si has instalado o actualizado un ambiente de trabajo se abrirá un nuevo cuadro de diálogo informando de que tienes que reiniciar FreeCAD para que los cambios surtan efecto.

Opciones

  1. The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
  2. Three different types of addons are supported: workbenches, macros, and preference packs. You can choose to show just one type, or all of them in a single list.
  3. The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
  4. The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
  5. The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a package metadata file (or for macros with embedded metadata).
  6. Addon data is cached locally, with a variable cache update frequency set in the user preferences.
  7. At any time you can choose to manually update your local cache to see the latest updates available for each addon.
  8. Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.

Clicking on an addon in this view brings up the addon's Details page:

The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).

Preferences

The preferences for the Addon manager can be found in the Preferences Editor. introduced in version 0.20

Notas

  • El uso de los complementos no está restringido a la versión de FreeCAD desde la que fueron instalados. También podrás utilizarlos en cualquier otra versión de FreeCAD, soportada por el complemento, que puedas tener en tu sistema.
  • Los complementos disponibles en el gestor complementos no son parte del programa oficial de FreeCAD y no están soportados por el equipo de desarrollo de FreeCAD. Debes leer la información proporcionada cuidadosamente para asegurarte de que sabes lo que estás instalando.
  • Los informes de errores y las peticiones de características deben hacerse directamente al creador del addon visitando el sitio web indicado. Muchos desarrolladores de complementos son usuarios habituales del foro de FreeCAD, y también pueden ser contactados allí.
  • Si el paquete GitPython está instalado en tu ordenador, el gestor complementos lo utilizará, haciendo que las descargas sean más rápidas.
  • También puedes instalar complementos manualmente. Ver Cómo instalar ambientes de trabajo adicionales y Cómo instalar macros.

Información para desarrolladores

See Addon.