Comment créer et publier un Java Library
J'ai récemment travaillé sur un Java classe qui génère des permutations par liste d'objets. En tout cas, j'aimerais que cette bibliothèque offrait au public, j'ai donc plusieurs questions:
- La plupart des bibliothèques que je vois avoir ce package compliqué nommant, notamment, notamment
com/org. Existe-t-il une convention pour ceux-ci ou est unpermutationsun package assez? - Y a-t-il un format spécifique pour les publier? Devrais-je inclure des guerres distinctes pour le code source/Javadoc?
- J'ai les fichiers sur un référentiel GitHub. Je suppose que je peux servir les fichiers là-bas, mais comment puis-je obtenir des gens pour trouver mon repo?
La plupart des bibliothèques que je vois ont cet emballage compliqué de nommer, en particulier, y compris COM/org. Existe-t-il une convention pour ces ou un paquet permutations suffisamment?
Il y a recommandations de Oracle sur la manière de nommer vos packages . La raison de cette convention de dénomination est de minimiser les doublons. Si tout le monde a simplement utilisé des noms courts et simples, il devient plus probable qu'un projet comprendra deux packages permutation. Si un nom de classe était le même, il y aurait des conflits de noms. Les choses peuvent être déroutantes pour le développeur, s'il n'y a pas de conflit de dénomination qui empêche la résolution des classes.
Si vous avez un nom de domaine, je suggérerais d'utiliser cela. Si vous hébergez sur un service tel que GitHub ou Sourceforge, utiliser le chemin de votre projet suffirait également. Quoi qu'il en soit, soyez explicite pour prévenir les conflits ou la confusion.
Y a-t-il un format spécifique pour les publier? Devrais-je inclure des guerres distinctes pour le code source/Javadoc?
Il n'y a pas de format spécifique. À tout le moins, la source et une convention créent un script (make, fourmi, maven). C'est bien d'avoir des bocaux ou des guerres précompilats, mais pas indispensables. Certains projets incluent le Javadoc dans la bibliothèque, d'autres pourraient produire deux pots (un avec Javadoc et un sans). Il peut également être une bonne idée de simplement publier votre Javadoc sur Internet si votre solution d'hébergement de projet le permet.
J'ai les fichiers sur un référentiel GitHub. Je suppose que je peux servir les fichiers là-bas, mais comment puis-je obtenir des gens pour trouver mon repo?
Annoncez-le. Commencez par le montrer à quelques amis. Blog à ce sujet. Partagez un lien sur Internet. Trouvez quelqu'un qui a un problème pour lequel ils peuvent résoudre en utilisant cette bibliothèque (mais assurez-vous de divulguer que vous avez créé la bibliothèque).