Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document application distribution #1315

Closed
charphi opened this issue Jan 25, 2021 · 9 comments
Closed

Document application distribution #1315

charphi opened this issue Jan 25, 2021 · 9 comments

Comments

@charphi
Copy link
Contributor

charphi commented Jan 25, 2021

Similar to the chapter Packaging Your Application in the documentation, it would be great to have a chapter dedicated to the distribution (for example: "Distributing Your Application").

Distribution can be done by downloading binaries directly or by using a package manager such as

  • homebrew, macports
  • chocolatey, scoop, winget
  • apt-get, yum, dnf
  • Snap, FlatPak, AppImage
  • ...
@remkop
Copy link
Owner

remkop commented Jan 26, 2021

Not sure about this one...

First, my knowledge in this area is very limited. I know how to publish the picocli binaries to bintray, in a way that they also get published to Maven Central, and that is pretty much it. On the other side, I have consumed packages from chocolatey, apt-get and yum, but that is the full extent of my knowledge. :-)

Second, even just writing about how to publish jar files and documentation for a library to Bintray/Maven Central is not easy to explain in a few paragraphs. If we provide enough detail to be useful, there is enough material for an article of a few pages.

And this is just Bintray/Maven Central. I imagine that documentation for each of these repositories and distribution mechanisms would be a similar amount of material. So overall, this is a lot of documentation. And is this not already available elsewhere? I am not sure how much value can we add by mentioning these in the picocli manual.

@charphi
Copy link
Contributor Author

charphi commented Jan 26, 2021

Indeed, it would be to much to documentation to write.
Maybe some links to some relevant documentation?

To my knowledge, all package managers work similarly but the details are different. It is annoying and time consuming to support several.
The ideal solution would be to have a "magic" Maven plugin that takes care of the tedious steps and generates everything that is needed for each package manager.

@remkop
Copy link
Owner

remkop commented Jan 26, 2021

Do you feel like contributing some documentation? :-)

@charphi
Copy link
Contributor Author

charphi commented Jan 26, 2021

Why not?
I will try to gather links in this conversation as a starting point.

@charphi
Copy link
Contributor Author

charphi commented Jan 29, 2021

Just for fun, here is a list a package managers:
https://en.wikipedia.org/wiki/List_of_software_package_management_systems
I didn't know there were so many. 😅

@remkop
Copy link
Owner

remkop commented Feb 1, 2021

I am perfectly happy not to pursue this further. 😉

@remkop
Copy link
Owner

remkop commented Feb 21, 2021

Shall we close this ticket?

@charphi
Copy link
Contributor Author

charphi commented Feb 22, 2021

Sure.

@charphi charphi closed this as completed Feb 22, 2021
@charphi
Copy link
Contributor Author

charphi commented Apr 12, 2021

It seems that someone is automating the distribution 😄
https://github.com/jreleaser/jreleaser and #1359

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants