Test archetypes in JBoss Central

    One solution to test your archetypes in JBoss Central is to define a Project Example User site.


    First, grab a copy of the last version of project-examples-shared-XXXX.xml and save it locally.

    Then, you need to edit it : remove all unwanted projects and keep the one you're interested in. You will have to change :

    • the <name> so it doesn't collide with existing names in JBT
    • The archetype coordinates :
      • <archetypeGroupId>
      • <archetypeArtifactd>
      • <archetypeVersion>
      • Add/change <archetypeRepository> to point to the location of the repository (local or remote) containing the archetype under test
    • The <tag> value must be set to central
    • You may change the rest of the example properties according to your needs.
    • Save your project example descriptor locally.


    You will end up with something like :



            <category>Open Archetypes</category>
            <shortDescription>Multi Module</shortDescription>
            <description>This is an overly complex Hello world</description>
                <fix type="wtpruntime">
                    <property name="allowed-types">org.jboss.ide.eclipse.as.runtime.70, org.jboss.ide.eclipse.as.runtime.71, org.jboss.ide.eclipse.as.runtime.eap.60</property>
                    <property name="description">This project example requires JBoss AS 7.0/7.1 or EAP 6 </property>
                    <property name="downloadId">org.jboss.tools.runtime.core.as.710</property>
                <fix type="plugin">
                    <property name="id">org.eclipse.m2e.core</property>
                    <property name="versions">[1.0.0,1.2.0)</property>
                    <property name="description">This project example requires m2e &gt;= 1.0.</property>
                    <property name="connectorIds">org.eclipse.m2e.feature</property>
                <fix type="plugin">
                    <property name="id">org.maven.ide.eclipse.wtp</property>
                    <property name="versions">[0.13.1,0.17)</property>
                    <property name="description">This project example requires m2eclipse-wtp &gt;= 0.13.1.</property>
                    <property name="connectorIds">org.maven.ide.eclipse.wtp</property>
                <fix type="plugin">
                    <property name="id">org.jboss.tools.maven.core</property>
                    <property name="versions">[1.3.0,1.4.0)</property>
                    <property name="description">This project example requires JBoss Maven Tools.</property>
                    <property name="connectorIds">org.jboss.tools.maven.feature,org.jboss.tools.maven.cdi.feature,org.jboss.tools.maven.hibernate.feature,org.jboss.tools.maven.jaxrs.feature,org.jboss.tools.maven.portlet.feature,org.jboss.tools.maven.seam.feature</property>
            <importTypeDescription>The project example requires the m2e, m2eclipse-wtp and JBoss Maven Integration features.</importTypeDescription>
                <!-- Archetype coordinates-->
                <!-- You can remove the <archetypeRepository> if the archetype is available from Maven Central -->
                <!-- if you need to test with your local build
                <!-- Pre-populate the project wizard input texts-->
                <!-- Override default archetype properties -->
                    <property name="name" value="Java EE 6 webapp project"/>
            <!-- use the tag 'central' to make this example appear in JBoss Central - Project Examples section -->
            <!-- Icon to use in JBoss Central-->
            <icon path="icons/newwebprj_wiz.gif" />
            <!-- Readme / Cheatsheet to open automatically when the project is generated -->
            <welcome type="editor" url="/${project[0]}/readme.md"/>


    Now you need to open Eclipse's preferences and got to JBoss Tools > Project Examples.

    • Check 'Show experimental sites'
    • Click on the 'Add' button to add your customized project example descriptor as a User Site




    Back to JBoss Central, in the Project Examples section, click on the refresh button and see your archetype appear in the list :



    You can now test your custom archetype exactly as if it was a built-in project wizard from JBoss Central