Comment fixer javadoc ou les sources pour les pots dans le dossier libs?
Nouvelle version de l'outil ADT r17 plugin pour Eclipse ajout de la fonction pour configurer automatiquement POT de dépendances. Tout .les fichiers jar dans le dossier libs sont ajoutés à la configuration de build maintenant. Malheureusement, Android Dépendances classpath conteneur est non modifiable.
Comment puis-je joindre javadoc et les sources de la insérés automatiquement .bocal (à partir de /dossier libs)?
- Je ne pense pas que votre question a été répondue. Marc a accepté de répondre donne exactement ce que vous avez demandé à ne PAS être la solution. Comment peut-on associer javadoc et les sources via l'auto-libs (pas via le manuel des pots)?
- Il y a un problème de ce bug code.google.com/p/android/issues/detail?id=27490#c21 . Commentaire 21 dit que joindre des sources/javadoc sera possible dans ADT r20 avec un standard de java .fichier de propriétés (foo.jar -> foo.jar.les propriétés) qui vous permet d'éditer chemin relatif ou absolu vers le dossier source (ou archive) et/ou un chemin relatif ou absolu vers la javadoc.
Vous devez vous connecter pour publier un commentaire.
La meilleure façon de répondre à votre question, c'est de résumer les réponses de Xavier, plastiv, VinceFR et Christopher.
Guide étape par étape de
Afin de lier la sources et javadoc à un .bibliothèque jar qui est automatiquement lié par Eclipse, vous devez faire ce qui suit:
.properties
fichier dans le libs dossier avec le nom exact de la bibliothèque actuelle .bocal (voir l'exemple). Assurez-vous de garder le .jar partie..properties
fichier.Exemple
L'exemple utilise la Gson bibliothèque.
Structure de répertoire du dossier libs:
Contenu de gson-2.2.2.jar.propriétés
Des informations supplémentaires
Vous pouvez bien sûr déplacer la javadoc et les sources .jar dans d'autres dossiers et spécifier les chemins d'accès relatifs. C'est à vous. En plaçant la source et la javadoc pots directement dans le lib dossier est possible, mais pas recommandé, en tant que causes de la documentation et le code source pour être inclus dans votre application.
Capture d'écran de l'Éclipse JavaDoc: panneau de
Capture d'écran d'un projet Eclipse à l'aide de Gson avec Android 4.2.2.:
Référencement déballé javadocs
Dans le cas où vous souhaitez faire référence à la documentation javadoc qui ne sont pas prévues comme des paniers
.jar
mais simplement que des fichiers et des dossiers, comme demandé par développeur android dans les commentaires procédez de la manière suivante:.jar
dans lelibs/
dossierCréer un
yourlibraryname.jar.properties
fichier (n'oubliez pas le.jar
) avec le contenu suivant:Ajouter à la javadoc des dossiers à la
libs/
dossier.Vous devez venir avec la structure de dossiers suivante:
Ne pas oublier de fermer et re-ouvrir le projet Eclipse comme mentionné ci-dessus!
Voici une capture d'écran d'un exemple de projet référencement de la GoogleAdMobAds Android bibliothèque.
libs
dossier. Leur projet de test cependant fonctionne hors de la boîte (il montre la JavaDoc, mais utilise une autre structure de projet). Je vous recommande de ouvrir une nouvelle question sur robotium en particulier. Je suppose qu'il a qqch. à voir avec la façon dont le ..javadoc.jar a été généré. Vous pourriez essayer de le compiler vous-même à partir des sources. Comme je peux voir, il y a certains fichiers manquants qui sont inclus dans le javadoc.jar de gson.doc=http://www.joda.org/joda-time/apidocs/
dans monjoda-time-2.3.jar.properties
fichier. Ai-je raison sur ce point, ou est-il quelque chose que je suis absent? C'est sûr qu'il serait agréable de simplement le lien vers le public Javadoc hébergés en ligne, plutôt que de les garder séparés-sources.jar
et-javadoc.jar
Pots pour chaque bibliothèque. J'ai essayé de réglage de la Javadoc emplacement du chemin d'accès d'URL sous "Java Build Path > Bibliothèques > Javadoc location" pour le POT en question, mais il ne fonctionne pas. Merci!Sur windows, vous avez pour échapper à la barre oblique inverse pour les références à doc et src chemins d'accès dans le fichier de propriétés. Exemple, pour
android-support-v4.jar le fichier de propriétés du contenu est quelque chose comme:
Une réponse viennent de http://code.google.com/p/android/issues/detail?id=27490#c21
Dans votre dossier libs, vous devez avoir:
Et dans votre
foo.jar.properties
, il suffit de mettredoc=./doc/foo_doc
Peut-être que vous devrez actualiser votre projet, de le nettoyer, de le fermer et le rouvrir.
Ça marche pour moi!
J'ai essayé tous les éléments ci-dessus n'a pas fonctionné pour moi. J'ai trouvé une méthode qui fonctionnera toujours. Fondamentalement, le coupable, c'est la manière dont l'ADT traite de la "libs" dossier donc j'ai quitté à l'aide de la "libs" le dossier. Au lieu de cela, j'ai créé un "bibliothèques" du dossier et de s'en servir.
Vous pouvez effectuer les opérations suivantes et il le sera toujours - même si celui-ci devrait changer la façon dont il change la façon dont il traite de la "libs" dossier dans l'avenir:
En suivant la procédure ci-dessus votre projet auront des dossiers qui ressemblent à ceci:
Votre Java Build Path va ressembler à quelque chose comme ceci:
Dans l'Ordre et à l'Exportation, les bibliothèques sont cochées:
Pour l'instant, déplacer la bibliothèque que vous souhaitez Javadoc pour
lib
. Les ajouter à la bibliothèque de laBuild Path
et ajouter la Javadoc.Cochez cette commentaire dans l'android problèmes.
Build Path
.Sur l'ADT 22 je ne pouvais pas accéder à Javadoc pour les deux commons-io-2.4.jar et android-support-v4.jar
C'est la façon dont je l'ai corrigé:
Condition: les deux bibliothèques sont répertoriés sous "Référencé Bibliothèques".
Clic droit sur commons-io-2.4.jar et sélectionnez Propriétés. Cette fenêtre s'affiche:
commons-io-2.4.jar est livré avec commons-io-2.4-javadoc.jar, de sorte que j'ai précisé la Javadoc dans l'archive Externe chemin d'accès au fichier.
J'ai fait la même chose pour la bibliothèque de prise en charge: un clic droit sur android-support-v4.jar et sélectionnez Propriétés. Cet écran s'affiche:
Cette fois, j'ai de spécier le chemin du répertoire source.
De référence de la bibliothèque de commons-io-2.0.1.jar a été cassé quand j'ai mis à Outils du kit SDK et ADT révision 17.
Pour résoudre le problème, j'ai utilisé de Projet -> Propriétés - > Java Build Path et j'ai sélectionné l'onglet Bibliothèques. J'ai supprimé toute référence à commons-io-2.0.1.jar et ensuite utilisé Add Jar à ajouter de nouveau commons-io-2.0.1.jar pour le projet. Puis je clique sur le " >’ flèche en regard du nom de la bibliothèque, afin d'élargir la référence à la bibliothèque et j'ai utilisé les boutons d'édition pour définir la Source de l'attachement et de la Javadoc emplacement.
Désolé je ne peux pas poster une image que je n'ai pas assez rep (s'il vous plaît...).
Semble être une cible en mouvement, mais, après avoir recueilli les morceaux à partir de nombreux endroits (y compris les réponses à cette question qui a aidé, mais a échoué à décrire tous les détails nécessaires, ou peut-être le système a été légèrement modifié entre temps), ce qui semble être la solution, au moins à partir d'aujourd'hui (28 août 2013).
lib
dossier, ajouter unxxx.jar.properties
fichier pour chaque lib vous souhaitez associer une javadoc avec.doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices
Non-respect de l'une de ces étapes (pas de décompression de la javadoc, le référencement d'un fichier au lieu d'un dossier, etc) semble pour le casser.
Je sais que cette question est un peu vieux, mais quand j'ai été confrontée au même problème hier, et la solution posté ci-dessus était trop gênant pour moi, j'ai découvert que l'on peut facilement ajouter une source de définition du chemin d'accès à l' .classpath fichier du projet. Eclipse va alors s'adapter, et vous êtes en mesure de parcourir la source.
classpath avant:
Après l'ajout du chemin d'accès à la source
Espère que cette aide
juste mettre à jour le plugin ADT. Ce qui a fonctionné pour moi!!
https://dl-ssl.google.com/android/eclipse/
Remarque: Android Outils de Développeur de site de mise à jour nécessite une connexion sécurisée. Assurez-vous que la mise à jour de l'URL du site que vous entrez commence par HTTPS.
Dans la boîte de dialogue, sélectionnez la case à cocher à côté des Outils de développement et cliquez sur Suivant.
Espère que ça aide!
Pour tout pot, si vous souhaitez voir la Javadoc de l'aide sur l'info-bulle lors de l'encodage, procédez de la manière suivante:
Cliquez-droit sur votre projet > Propriétés > Java Build Path > Onglet Bibliothèques. Cliquez sur la flèche à côté de votre bocal de s'étendre.
Source de l'attachement doivent pointer vers l'emplacement de la réelle pot (probablement droit à votre dossier java).
Javadoc emplacement: Vous avez deux choix ici: URL et archive. Si votre documentation javadoc pour ce pot sont sous la forme d'un dossier contenant un index.html fichier au premier niveau, choisissez "Javadoc URL" et le point à ce dossier.
Si votre documentation javadoc sont dans un bocal, choisissez "Javadoc dans les archives" et le point dans le pot.
N'oubliez pas de redémarrer votre espace de travail/de fermer et de rouvrir votre projet de mise à jour de l'info-bulle avec la Javadoc info.
J'espère que cela aide à vous donner une réponse simple pour ce que je crois être une tâche très simple.
Mon solucion:
Télécharger un plugin eclipse appelé: "Source Java Attacher à la Fonctionnalité".
Plus tard, sélectionnez un bocal et fixez le code source à l'aide de ce plugin. Cliquez sur dans le fichier jar pour le sélectionner, droit buttom sur la souris, puis sélectionnez "joindre source java".
Lorsque vous avez le code source, vous avez automatiquement la javadoc.
Maintenant, vous pouvez utilisez la touche F2 sur les classes pour afficher les associés javadoc.
Profiter de