Difference between revisions of "Documentation/Nightly/SlicerApplication/ExtensionsManager"

From Slicer Wiki
Jump to: navigation, search
(move content to readthedocs)
Tags: 2017 source edit, Replaced
Line 2: Line 2:
 
__TOC__
 
__TOC__
  
3D Slicer now supports plug-ins which we call ''extensions''.  Extensions are available for download from an extension server.  Extensions allow end-users to selectively install features that are useful for them.
+
{{documentation/banner
 
+
| text  = [https://slicer.readthedocs.io/en/latest/user_guide/extensions_manager.html This page has been moved to read-the-docs.]
= Extensions Manager =
+
| background-color = 8FBC8F }}
 
 
[[File:Extension_Manager.png|700px]]
 
 
 
== Installing an extension ==
 
 
 
<gallery widths=230px heights=230px perrow=4>
 
File:ExtensionsManager-4.1-Install_0_ExtensionsManagerMenu.jpg|1. Open extensions manager
 
File:ExtensionsManager-4.1-Install_1a_extension_list.png|2. Choose an extension
 
File:ExtensionsManager-4.1-Install_1_extension_details.png|3. Look at extension details
 
File:ExtensionsManager-4.1-Install_2a_InstallButton.png.jpg|4. Click on "Install"
 
File:ExtensionsManager-4.1-Install_2b_ExtensionInstalled_ManagerAndInstallWidget.jpg|5. Extension is installed
 
File:ExtensionsManager-4.1-Install_Restart.jpg|6. Restart Slicer
 
File:ExtensionsManager-4.1-Install_3_ExtensionAvailable.jpg|7. Extension is available
 
</gallery>
 
 
 
Note: if extension manager is not visible then make sure that ''Enable extension manager'' option is enabled in Application Settings (menu item "Edit -> Application Settings -> Extensions"). If you changed the setting, Slicer has to be restarted for it to become effective.
 
 
 
[[Image:ExtensionsManager-enable.png|Enable ExtensionsManager]]
 
 
 
== Installing an extension without network connection ==
 
 
 
<gallery widths=230px heights=230px perrow=4>
 
File:ExtensionsManager-4.4-InstallFromFile_1_DownloadExtensionPackage.png|1. Download the extension package using [[#How_to_manually_download_an_extension_package.3F|these instructions]] on a network-connected computer.
 
File:ExtensionsManager-4.1-Install_0_ExtensionsManagerMenu.jpg|2. Open extensions manager
 
File:ExtensionsManager-4.4-InstallFromFile 3 ToolMenuInstallFromFile.png|3. Select 'Install from File' from the tools menu
 
File:ExtensionsManager-4.4-InstallFromFile 4 SelectPackage.png|4. Select a previously downloaded or otherwise obtained extension archive
 
File:ExtensionsManager-4.4-InstallFromFile_5_ExtensionIsInsalled.png|5. Extension is installed
 
File:ExtensionsManager-4.4-InstallFromFile_6_Restart.png|6. Restart Slicer
 
File:ExtensionsManager-4.4-InstallFromFile_7_ExtensionIsAvailable.png|7. Extension is available
 
</gallery>
 
 
 
== Updating installed extensions ==
 
 
 
<gallery widths=230px heights=230px perrow=4>
 
File:ExtensionsManager-4.1-Install_0_ExtensionsManagerMenu.jpg|1. Open extensions manager and select ''Manage Extensions'' tab
 
File:ExtensionsManager-CheckForUpdate.png|2. Select ''Check for Updates'' from the tools menu
 
File:ExtensionsManager-CheckForUpdate-Log-Success.png|3. Check log
 
</gallery>
 
 
 
By selecting ''Install Updates Automatically'' from the tools menu, Slicer will check if extension updates are available on start-up.
 
 
 
== Uninstalling an extension ==
 
 
 
<gallery widths=230px heights=230px perrow=4>
 
File:ExtensionsManager-4.1-Install_0_ExtensionsManagerMenu.jpg|1. Open extensions manager
 
File:ExtensionsManager-4.1-Uninstall_1b_UninstallButton.jpg|2. Click on "Uninstall"
 
File:ExtensionsManager-4.1-Uninstall_2_ScheduledForUninstall.jpg|3. Extension is scheduled for uninstall
 
File:ExtensionsManager-4.1-Uninstall_3_Restart.jpg|4. Restart Slicer
 
File:ExtensionsManager-4.1-Uninstall_4_ExtensionUninstalled.png| 5. Extension has been uninstalled
 
</gallery>
 
 
 
== Disabling an extension ==
 
 
 
<gallery widths=230px heights=230px perrow=4>
 
File:ExtensionsManager-4.1-Install_0_ExtensionsManagerMenu.jpg|1. Open extensions manager and select ''Manage Extensions'' tab
 
File:ExtensionsManager-4.1-Disable_1.png|2. Disable extension
 
File:ExtensionsManager-4.1-Disable_2.png|3. Restart Slicer
 
</gallery>
 
 
 
== Incompatible extensions ==
 
<!--
 
'''Caveat''': Considering that installed extensions are common to all Slicer version installed by a given user and that an extension is specific to a given revision of Slicer, it's currently not possible to have working extension installed for multiple version of Slicer. The issues has been reported as #[http://www.na-mic.org/Bug/view.php?id=1958 1958] and is currently targeted for 4.2.0 release.
 
-->
 
<gallery widths=230px heights=120px perrow=4>
 
File:ExtensionsManager-4.1-IncompatibleExtension.jpg| Incompatible extension has been identified
 
File:ExtensionsManager-4.1-IncompatibleExtension_ErrorLogMessage.png | Error log message
 
</gallery>
 
 
 
== Extensions Manager Settings ==
 
 
 
=== Extensions settings ===
 
{|
 
| <gallery widths=400px heights=230px perrow=1>
 
File:ExtensionsManager-4.1-UnderTheHood_1_ExtensionsSettings.png|Extensions settings
 
</gallery>
 
||
 
# Extensions server URL: Address of the server used to download and install extensions
 
# Extensions installation path: Directory where extension packages should be extracted and installed
 
|}
 
 
 
=== Module settings ===
 
{|
 
| <gallery widths=400px heights=230px perrow=1>
 
File:ExtensionsManager-4.1-UnderTheHood_2_ModulesSettings.png|Module settings
 
</gallery>
 
||
 
# After installing an extension, the directories containing the modules bundled within an extension will be visible as additional module paths.
 
# Modules associated with an extension can also be disabled one by one.
 
|}
 
 
 
=== Launcher settings ===
 
{|
 
| <gallery widths=400px heights=230px perrow=1>
 
File:ExtensionsManager-4.1-UnderTheHood_3_LauncherSettings.png|Launcher settings
 
</gallery>
 
||
 
Whereas the module path is used to indicate Slicer where to look to load additional modules, the extension manager also takes care of updating the <code>LibraryPaths</code> / <code>Paths</code> / <code>EnvironmentVariables</code> in the launcher settings so that libraries associated with modules can be successfully loaded.
 
|}
 
 
 
  
 
{{:Documentation/{{documentation/version}}/FAQ/Extensions|Extensions}}
 
{{:Documentation/{{documentation/version}}/FAQ/Extensions|Extensions}}

Revision as of 01:03, 23 March 2021

Home < Documentation < Nightly < SlicerApplication < ExtensionsManager