jhipster / jhipster-lite

JHipster Lite ⚡ is a development platform to generate, develop & deploy modern web applications & microservices architecture, step by step - using Hexagonal Architecture :gem:
https://lite.jhipster.tech
Apache License 2.0
463 stars 212 forks source link

Running the JHipster jar released on Maven does not work #4085

Closed biergit closed 2 years ago

biergit commented 2 years ago

Hi,

my understanding was that I could just download the jar from Maven Central and run it locally with java -jar jhlite-0.20.0.jar. This fails with no main manifest attribute, in jhlite-0.20.0.jar

pascalgrimaud commented 2 years ago

Hello @biergit

This JAR file on maven central is used for building your custom JHLite project, it's not for being downloaded and run.

image

The one which could be downloaded is in the release page. For exemple: https://github.com/jhipster/jhipster-lite/releases/tag/v0.15.0 image

But when looking at your ticket, all release after v0.15.0 have javadoc.jar instead ! And it's a bug, so I opened this ticket https://github.com/jhipster/jhipster-lite/issues/4086

I'll try to rebuild these jar locally and upload its

biergit commented 2 years ago

Hi @pascalgrimaud,

to be honest the Readme is quite confusing to me. It is unclear to me what is being described there. Is it the way that the JHipster Lite code itself is being built? Or is it the way my own project would be built if I was to use JHipster? Also what would I need the JHipster Lite jar for? I can't see it described in the Readme. Also what is XDD? Is that a term that anyone coming to this project should know? I suggest to make it very easy to run the JHipster Lite platform locally by including the necessary steps up front in your Readme and basing it all on Docker. Just my 2c of course :)

Good luck with your project, Biergit

pascalgrimaud commented 2 years ago

to be honest the Readme is quite confusing to me. It is unclear to me what is being described there.

So agree with you, if the README is not clear enough, we'll try to improve it Anyway, I suggest you to have a look to the 2 videos, it will be easier to understand after that, I think.


Is it the way that the JHipster Lite code itself is being built? Or is it the way my own project would be built if I was to use JHipster?

The schema is just here for helping. If you want a simple CRUD application, go and use generator-jhipster. If you want XDD approch, use JH Lite


Also what is XDD? Is that a term that anyone coming to this project should know?

We're talking about TDD, BDD, DDD approach


I suggest to make it very easy to run the JHipster Lite platform locally by including the necessary steps up front in your Readme and basing it all on Docker.

The Docker image should work. About the JAR in the release page, it is fixed so you can download the jar here https://github.com/jhipster/jhipster-lite/releases/download/v0.20.0/jhlite-0.20.0.jar and launch it Anyway, the best way would be to simply clone this project and launch it with maven, like you would do for classical Spring Boot projects.


Don't hesitate if you have other questions

biergit commented 2 years ago

Thank you. The docker image worked perfectly and was the easiest way to get what I wanted :)