Difference between revisions of "Documentation/Nightly/Developers/Tutorials/Contribute Extension Description File using Extension Wizard"
From Slicer Wiki
Line 3: | Line 3: | ||
= Overview = | = Overview = | ||
− | This page | + | This page describes how to easily contribute an extension description file using the [[Documentation/{{documentation/version}}/Developers/ExtensionWizard|ExtensionWizard]]. The wizard automates the manual steps documented [[Documentation/{{documentation/version}}/Developers/Tutorials/Contribute_Extension_Description_File|here]]. |
− | It will automatically | + | It will automatically generate the extension description file (<code>.s4ext</code>) based on the <code>CMakeLists.txt</code> in the extension directory. |
= Definitions = | = Definitions = |
Latest revision as of 01:44, 5 August 2017
Home < Documentation < Nightly < Developers < Tutorials < Contribute Extension Description File using Extension Wizard
For the latest Slicer documentation, visit the read-the-docs. |
Contents
Overview
This page describes how to easily contribute an extension description file using the ExtensionWizard. The wizard automates the manual steps documented here.
It will automatically generate the extension description file (.s4ext
) based on the CMakeLists.txt
in the extension directory.
Definitions
- Extension description file: This is a text file with extension
.s4ext
that fully described an extension. More details here.
- ExtensionsIndex: This is a repository containing a list of extension description files
*.s4ext
. These description files are used by the Slicer extensions build system to build, test, package and upload extensions on the extensions server. More details here
Prerequisites
- Extension belongs to Category 1 or Category 2 as described in Slicer requirements
- Extension has been built, tested and installed on at least one platform (Linux, MacOSX or Windows)
Conventions
- Terminal command - Block like the one below indicates that the command should be executed in a terminal.
- On Windows, Git Bash is expected (not the Windows command line). Need help ?
$ echo "This is a command"
Contributing a new extension / Requesting an extension update
Typing this command will create a pull request on ExtensionsIndex repository.
- Make sure the latest changes associated with your extension have been pushed in your extension repository.
Extensions built against Slicer trunk
$ bin/slicerExtensionWizard --contribute ~/src/Slicer-MyExtension/
Extensions build against Slicer 4.10
$ bin/slicerExtensionWizard --contribute --target 4.10 ~/src/Slicer-MyExtension/