shogun2-client is an open project which provides a client web application for SHOGun2 based on the BasiGX package. By default, shogun2-client is used when a SHOGun2 webapplication is created with the shogun2-webapp-archetype
.
shogun2-client basically requires the same libraries / tools as SHOGun2 and BasiGX , especially:
- Update/checkout SHOGun2 and run
mvn clean install
in SHOGun2 project directory (thesrc
folder)
- Please note: If SHOGun2 is updated you also have to reinitialize it with
mvn clean install
-
Generate your own fork of shogun2-client
-
Generate a web application based on shogun2-webapp-archetype, e.g. with
-
Execute the following command (ideally in your Eclipse workspace directory): https://github.com/terrestris/shogun2/wiki/Getting-started#generate-a-shogun2-based-web-application
-
After creation of the web application, set the URL of your shogun2-client fork (username:
{github_username}
) inpom.xml
:<developerConnectionUrl>scm:git:git://github.com/{github_username}/shogun2-client.git</developerConnectionUrl>
-
Go to our in project directory
{projectDir}
and run
$ mvn scm:checkout
- Go to
{projectDir}/src/main/webapp/client
and run:
$ git remote add upstream https://github.com/terrestris/shogun2-client.git
- In the same folder run
$ sencha package repo add BasiGX http://terrestris.github.io/BasiGX/cmd/pkgs
$ sencha app upgrade {/path/to/extjs}
$ sencha app refresh
-
Run tomcat with your SHOGun2-webapplication (or use
sencha app watch
) -
Open
http://localhost:8080/{webapp-name}/client/index.html?id={applicationId}
Note: To get a valid {applicationId}
just follow these steps:
* Adapt and open this URL:
`http://localhost:8080/{webapp-name}/application/findAll.action`
* The response will list all of your current SHOGun2 applications (and normally it should return the default one named _Default Application_ only)
* Find the entry `id` containing the ID of the application (e.g. `"id": 50`)
* Use this ID as GET parameter (see above)
Feedback is more than welcome. Please open an issue or contact us directly via info@terrestris.de
GPL v3