Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mathieusoysal/java-maven-library-template

Template to easily create a Java library and automatically publish it to GitHub Package and Maven Central.
https://github.com/mathieusoysal/java-maven-library-template

hacktoberfest java library-template maven maven-library-template

Last synced: 3 months ago
JSON representation

Template to easily create a Java library and automatically publish it to GitHub Package and Maven Central.

Host: GitHub
URL: https://github.com/mathieusoysal/java-maven-library-template
Owner: MathieuSoysal
License: apache-2.0
Created: 2021-12-25T20:09:56.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2023-07-12T09:45:05.000Z (over 1 year ago)
Last Synced: 2024-04-28T07:29:40.869Z (9 months ago)
Topics: hacktoberfest, java, library-template, maven, maven-library-template
Language: Java
Homepage:
Size: 263 KB
Stars: 3
Watchers: 2
Forks: 1
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=MathieuSoysal_Java-Maven-library-template&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=MathieuSoysal_Java-Maven-library-template)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=MathieuSoysal_Java-Maven-library-template&metric=coverage)](https://sonarcloud.io/summary/new_code?id=MathieuSoysal_Java-Maven-library-template)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=MathieuSoysal_Java-Maven-library-template&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=MathieuSoysal_Java-Maven-library-template)

![GitHub Actions](https://github.com/MathieuSoysal/Java-Maven-library-template/workflows/Java%20CI%20with%20Maven/badge.svg)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md) 

[![Javadoc](https://img.shields.io/badge/JavaDoc-Online-green)](https://mathieusoysal.github.io/Java-Maven-library-template/javadoc/)

#  Java Maven Library Template [![GitHub](https://img.shields.io/badge/license-Apache%202.0%20License-green)](LICENSE)

Template to easily create a Java Maven library and publish it automatically on GitHub Package and Maven Central, the publication is automated via the repo versions.

## Use template

To use this template, you just need to click on "Use this template" at the top of the main page of this repository, or you can copy/paste this repository.

## Requirements

- [ ] [Create an account on Sonatype](https://issues.sonatype.org/secure/Signup!default.jspa)

- [ ] [Create a JIRA ticket on Sonatype to approve your groupId (io.github.YOUR-GITHUB-USERNAME)](https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134)

- [ ] [Generate a gpg key and distribute the public key to a keyserver](https://central.sonatype.org/publish/requirements/gpg/)

## Template configurations :

- [ ] **Fix pom.xml**

  - *To guide you, a FIXME tag has been added to all lines to be edited.*

- [ ] **Config SonarCloud**

  - To configure SonarCloud for your project you must go to https://sonarcloud.io

  - Replace the file at [/.github/workflows/sonar.yml](.github/workflows/sonar.yml) with your own yaml file at https://sonarcloud.io and if your Java project is not on Java 11 edit that yaml file.

- [ ] **Create your GitHub secrets on your repository**

  - *NEXUS_USERNAME* with your username used on Sonatype

  - *NEXUS_PASSWORD* with your password used on Sonatype

  - *GPG_PRIVATE_KEY* with the private key of your generated pgp key

    - to get the private key `gpg --armor --export-secret-key  > privkey.asc` 

  - *GPG_PASSPHRASE* with the passphrase of your gpg key

- [ ] **Activate the JavaDoc GitHub page**

  - To enable the JavaDoc GitHub Page, you need to enable the GitHub page in your repository settings for the *javadoc* branch.

## Badges

Don't forget to add your own SonarCloud badges to your readme 😉

 - to get your maven-central badge : https://shields.io/category/platform-support

 - to get your JavaDoc Badge : 

```Markdown

  [![Javadoc](https://img.shields.io/badge/JavaDoc-Online-green)](https://.github.io//javadoc/)

```

On the link of JavaDoc badge, replace  `` by your GitHub username, `` by the name of your GitHub repository.

## Contact

If you have any problems setting up CI, CD or other, do not hesitate to contact me at [email protected]