Page History

Wstęp

Poniżej opisane zostały 2 sposoby tworzenia projektu wtyczki:

• ręcznie
• maven archetype

Tworzenie projektu z archetypu jest szybsze i wygodniejsze. Musimy jedynie uzupełnić wymagane parametry takie jak nazwa, klucz etc.

Tworzenie projektu od podstaw

1. Tworzymy nowy projekt Maven (File -> New -> Maven Project).
2. Zaznaczamy opcję Create a simple project (skip archetype selection) i klikamy Next

3. Uzupełniamy informacje o projekcie i tworzymy projekt

   Image Modified
   
   
   

   Info
   title Parametry projektu
   Projekt powinien być stworzony zgodnie z konwencją: groupId: dla wtyczek przyjęto com.suncode.plugin artifactId: identyfikator wtyczki (musi być

Wstęp

Poniżej opisane zostały 2 sposoby tworzenia projektu wtyczki:

• ręcznie
• maven archetype

Tworzenie projektu z archetypu jest szybsze i wygodniejsze. Musimy jedynie uzupełnić wymagane parametry takie jak nazwa, klucz etc.

Tworzenie projektu od podstaw

Introduction

Below are described 2 ways to create a plug-in project:

• manually
• maven archetype

Creating a project from an archetype is faster and more convenient. We only need to complete the required parameters such as name, key etc.

Creating a project from scratch 

1. We create a new Maven project (File -> New -> Maven Project).
2. Zaznaczamy opcję Select the Create a simple project option (skip archetype selection) i klikamy NextUzupełniamy informacje o projekcie i tworzymy projektand click Next

3. We complete the information about the project and create the project
   
   

   
   
   
   

   Projekt powinien być stworzony zgodnie z konwencją

   Info
   title Parametry projektu	Project parameters
   The project should be created in accordance with the convention: groupId: dla wtyczek przyjęto com.suncode. plugin plugin accepted for plugins artifactId: identyfikator wtyczki (musi być uniwersalny  plug ID (must be universal) version: wersja wtyczki może być niezależna od wersji systemu docelowego packaging: musi zostać ustawione na bundle (wartości nie ma na liście)

    

   Dodajemy niezbędny plik deskryptora wtyczki 

   the plugin version can be independent from the target system version packaging: must be set to bundle (the value is not on the list)

    

   We add the necessary suncode-plugin.xml do katalogu descriptor file to the src/main/resources directory: 

   Code Block
   language html/xml title suncode-plugin.xml
   <?xml version="1.0" encoding="UTF-8"?> <plugin key="${project.groupId}-${project.artifactId}" name="Tutorial Plugin"> <plugin-details> <description> <localized language="en">Description</localized> <localized language="pl">Opis</localized> </description> <author>Suncode</author> </plugin-details> <!-- I18N --> <i18n key="i18n-bundle" location="locale/messages" /> <!-- Web MVC --> <web-mvc key="mvc" /> </plugin>

   Info

   Plik The suncode-plugin.xml jest filtrowany przez Maven'a. Oznacza to, że w miejsca właściwości file is filtered by Maven. This means that the contents of these properties are dynamically inserted into the properties of ${...} dynamicznie wstawiana jest zawartość tych właściwości . Zamiast Instead of ${project.groupId} - ${project.artifactId} możemy wpisać stały identyfikator wtyczki. Wpisanie we can enter a permanent ID of the plugin. Typing ${project.groupId} - ${project.artifactId} skutkuje dynamicznie tworzonym identyfikatorem z właściwości groupId i artifactId.

   Dodajemy plik tłumaczeń messages.properties do katalogu 

   results in a dynamically created identifier from the groupId and artifactId properties.

4. We add the messages.properties file to the src/main/resources/locale

Ostateczna struktura projektu powinna wyglądać następująco:

Image Removed

Tworzenie projektu wykorzystując gotowy archetyp

Przed stworzeniem projektu należy skonfigurować katalogi archetypów. W tym celu otwieramy Window->Preferences oraz dodajemy Remote Catalog z adresem URL repozytorium Suncode: http://192.168.1.51:8081/nexus/content/groups/public/

Image Removed

Image Removed

Image Removed

<?xml version="1.0" encoding="UTF-8"?>
<plugin key="com.suncode.plugin-tutorial" name="Tutorial Plugin">
	<plugin-details>
		<description>
			<localized language="en">Description</localized>
			<localized language="pl">Opis</localized>
		</description>
		<author>Suncode</author>
	</plugin-details>
	
	<!-- I18N -->	
	<i18n key="i18n-bundle" location="locale/messages" />
	
	<!-- Web MVC -->
	<web-mvc key="mvc" />
</plugin>

Ostateczna struktura projektu powinna wyglądać następująco:

Image Removed