libsフォルダーのjarにjavadocまたはソースを添付する方法は?


254

Eclipse用の新しいバージョンのADT r17プラグインには、JAR依存関係を自動的にセットアップする機能が追加されました。/ libsフォルダー内のすべての.jarファイルがビルド構成に追加されます。残念ながら、Android Dependenciesクラスパスコンテナーは変更できません。

変更できないAndroid依存関係のクラスパス

自動的に挿入された.jar(/ libsフォルダーから)にjavadocとソースを添付するにはどうすればよいですか?


あなたの質問には答えられなかったと思います。マークの受け入れられた答えは、あなたが解決策ではないことを要求したものを正確に与えます。autodoc(手動のjarではなく)を介してjavadocとソースを接続するにはどうすればよいですか?
pjv

2
このバグcode.google.com/p/android/issues/detail?id=27490#c21に問題があります。コメント21は、ソー​​スフォルダー(またはアーカイブ)への相対パスまたは絶対パスを編集できる標準のjava .propertiesファイル(foo.jar-> foo.jar.properties)を使用して、ADT r20でsources / javadocを添付できることを示しています。 /またはjavadocへの相対パスまたは絶対パス。
Sergii Pechenizkyi 2012年

回答:


401

質問に答える最良の方法は、XavierPlastivVinceFR、およびChristopherからの回答を要約することです。

ステップバイステップガイド

リンクするにはソースとJavadocを自動的にEclipseのことでリンクされているの.jarライブラリに次のことを行う必要があります:

  1. ライブラリ.jarファイルをlibsフォルダーに配置し、関連するソース.jarファイルとdoc .jarファイルをlibs / srclibs / docsなどの個別のサブフォルダーに配置します。必要に応じてsrcおよびdocs以外の名前を使用できますが、.jarファイルがlibsフォルダーに直接ないことが重要です。
  2. 実際のライブラリ.jarの正確な名前でlibsフォルダーに.propertiesファイルを作成します(例を参照)。.jarの部分は残しておいてください。
  3. ファイルへのソースおよびjavadoc .jarへの相対パスを指定し.propertiesます。
  4. Eclipseプロジェクトを閉じて再度開いてください!オプションで、を押してプロジェクトを更新しF5ます。
  5. ソースコードでリンクライブラリのオブジェクトを選択します。
  6. EclipseでJavadocビューを開いて、ドキュメントを確認します(スクリーンショットを参照)。
  7. F3選択したオブジェクトのソースコード宣言(デフォルトのショートカット:)を開きます。


この例では、Gsonライブラリを使用しています

libsフォルダーのディレクトリ構造:

libs
├── docs
   └── gson-2.2.2-javadoc.jar
├── gson-2.2.2.jar
├── gson-2.2.2.jar.properties
└── src
    └── gson-2.2.2-sources.jar

gson-2.2.2.jar.propertiesの内容

src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar


追加情報

もちろん、javadocとsources .jarを他のフォルダに移動して、相対パスを指定できます。それはあなた次第です。ソースjarとjavadoc jarをlibフォルダーに直接配置することは可能ですが、推奨さません。ドキュメントとソースコードがアプリケーションに含まれるためです


Eclipse JavaDocパネルのスクリーンショット:

EclipseのJavaDocビュー

Android 4.2.2でGsonを使用するEclipseプロジェクトのスクリーンショット:

Eclipseテストプロジェクトのスクリーンショット


解凍されたjavadocsの参照

ケースでは、パックとして提供されていないリファレンスJavadocをしたい.jarが、単にファイルやフォルダとしてで尋ねたようなコメントにアンドロイド開発者は、次の操作を行います。

  1. ライブラリ.jarlibs/フォルダに配置します
  2. 次の内容のyourlibraryname.jar.propertiesファイルを作成します(を忘れないでください.jar)。

     doc=docs
  3. フォルダーにjavadocsフォルダーを追加しlibs/ます。

次のフォルダ構造を考え出す必要があります。

├── docs
   ├── allclasses-frame.html
   ├── allclasses-noframe.html
   ├── com
      └── google
          └── ads
              ├── Ad.html
                 ....
              └── package-tree.html
      ...
   └── stylesheet.css
├── GoogleAdMobAdsSdk-6.4.1.jar
└── GoogleAdMobAdsSdk-6.4.1.jar.properties

上記のように、Eclipseプロジェクトを閉じて再度開くことを忘れないでください。これは、GoogleAdMobAds Androidライブラリを参照する実際のサンプルプロジェクトのスクリーンショットです。

GoogleAdMobAds AndroidライブラリEclipseプロジェクト


7
ああ、私に必要だったのはEclipseプロジェクトの終了と再開でした。(私はそれまでに運がなく何度かリフレッシュして掃除していました。)
スティーブヘイリー

4
@JJD、ありがとうございました。Eclipseが機能するようになる前に、Eclipseを再起動する必要がありました。
javajavajavajavajava 2012

26
注:あなたは本当に する必要があり、サブディレクトリにJavadocのソースJARを置くなど「./libs/docs」、それ以外の場合はこれらのJARは、あなたのAPKにバンドルされます!また、重複するHTMLファイルが見つかるとAPKのビルドが失敗するため、複数のライブラリにJavadocを含めることはできません。
Christopher Orr

5
.propertiesファイルからリモートjavadocを参照することは可能ですか?このように:doc = community.versant.com/documentation/reference/db4o-8.0/java/api
Matthias

9
ソースコードではなくJavadocをリンクするだけの場合、これは機能しないようです。7zipのJavadoc jarをマイドキュメントのフォルダに抽出し、プロパティファイルがJavadocインデックスのあるフォルダを指すようにしました。 .htmlのように直接doc = C:\\ Users \\ johny \\ workspacenewfb \\ robotium-solo-4.0-javadoc
mbwasi

25

Windowsでは、プロパティファイル内のdocおよびsrcパスへの参照をバックスラッシュでエスケープする必要があります。たとえば、android-support-v4.jarの場合、プロパティファイルの内容は次のようになります。

doc=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\docs
src=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\src

1
すごいあなたの答えは私の問題を解決し、私は1つを置く\が、我々は\\ .thanksを置く必要がありますので、muchh
アラシュ

17

回答はhttp://code.google.com/p/android/issues/detail?id=27490#c21から取得さます

libsフォルダーには、次のものが必要です。

doc(folder)
    foo_doc(folder)
        index.html
        ...
        ...
foo.jar
foo.jar.properties

そして、あなたにfoo.jar.properties、置くだけdoc=./doc/foo_doc

多分あなたはあなたのプロジェクトをリフレッシュし、それをきれいにし、閉じてそして再び開く必要があるでしょう。

わたしにはできる!


あなたがzipファイルでドキュメントを持っているなら、これは行く方法です、どうもありがとう!いいね
Akhil Jain 2013

10

上記のすべてを試しましたが、どれもうまくいきませんでした。私はいつもうまくいく方法を見つけました。基本的に、原因はADTが「libs」フォルダーを処理する方法であるため、「libs」フォルダーの使用を中止します。代わりに、「ライブラリ」フォルダを作成して使用しました。

次の操作を行うことができ、ADTが将来の「libs」フォルダーの処理方法を変更する方法を変更する必要がある場合でも、常に機能します。

  1. 「ライブラリ」フォルダを作成します。
  2. ライブラリごとに、その下にサブフォルダを作成します。
  3. 各ライブラリーのすべてのファイルを適切なフォルダー(java jarファイル、ソースjarファイル、javadoc jarファイルなど)に配置します。
  4. をクリックして、Javaビルドパスの[ライブラリ]タブで各プロジェクトのjava jarファイルを追加します。 Add Jars...フォルダのライブラリサブフォルダからjarを追加するボタンをを追加します。
  5. 「ライブラリ」タブでプロジェクトを開き、目的のアイテムを選択し、Edit...ボタンをクリックして「ライブラリ」フォルダのライブラリサブフォルダからsource / javadocsを追加することで、source / javadocsを各プロジェクトに添付します。
  6. Javaビルドパスの[注文とエクスポート]タブで各プロジェクトのチェックボックスをオンにします。
  7. すべてのライブラリが移動されたことを確認したら、「libs」フォルダを削除します。

上記の手順に従うと、プロジェクトには次のようなフォルダーが作成されます。

ここに画像の説明を入力してください

Javaビルドパスは次のようになります。

ここに画像の説明を入力してください

注文とエクスポートでは、ライブラリがチェックされています:

ここに画像の説明を入力してください


5

ここでは、Javadocを使用するライブラリを移動しますlib。彼らはそのライブラリをにBuild Path追加し、Javadocを追加します。

Androidの問題でこのコメントを確認してください。


(私がしたように)順序を確認し、ライブラリをエクスポートするように設定することを忘れないでくださいBuild Path
Carlos Sobrinho 2012年

4

ADT 22では、commons-io-2.4.jarとandroid-support-v4.jarの両方のJavadocにアクセスできませんでした

これは私がそれを修正した方法です:

  1. 前提条件:両方のライブラリが「参照ライブラリ」にリストされている。

  2. commons-io-2.4.jarを右クリックし、[プロパティ]を選択します。このウィンドウは現われます:

ここに画像の説明を入力してください

commons-io-2.4.jarはcommons-io-2.4-javadoc.jarにバンドルされているため、アーカイブの外部ファイルパスでJavadocを指定しました。

サポートライブラリについても同じことを行いました。android-support-v4.jarを右クリックし、[プロパティ]を選択します。次の画面が表示されます。

ここに画像の説明を入力してください

今回は、ソースディレクトリへのパスを指定しました。


これは、javadocまたはsrc、あるいはその両方をライブラリにアタッチするための最も簡単で直接的な方法です。ありがとう!追加の注記として、javadocもsrcも参照ライブラリにある必要はありません。

3

SDKツールとADTリビジョン17にアップグレードすると、commons-io-2.0.1.jarへのライブラリ参照が壊れました。

この問題を解決するために、プロジェクト->プロパティ-> Javaビルドパスを使用し、[ライブラリ]タブを選択しました。commons-io-2.0.1.jarへの参照をすべて削除し、Add Jarを使用してcommons-io-2.0.1.jarをプロジェクトに再度追加しました。次に、ライブラリ名の横にある「>」矢印をクリックしてライブラリ参照を展開し、編集ボタンを使用してソースの添付ファイルとJavadocの場所を設定しました。

担当者が不足しているため、画像を投稿できません。


私のために働いていませんでした。プロジェクトのどこにjarファイルを保持していますか?私はlibsフォルダーにあります。
ダニエルライアン

最後に、誰かが実際に機能する指示を出しました!どうもありがとうございました。「.properties」ファイルを含む前述のメソッドはどれも私にとって何の役にも立ちませんでしたが、ダイアログ画面でライブラリを外部JARとして追加することでうまくいきました。
AlxDroidDev 2016

1

動くターゲットのようですが、多くの場所から細かい部分を収集した後(必要なすべての詳細を説明するのに役立ちましたが、説明に失敗したこの質問に対する回答、またはシステムがその間に少し変更された可能性があります)、これは少なくとも現時点での解決策(2013年8月28日)。

  • プロジェクト内ではない場所にjavadocsのフォルダーを開きます。
  • Javadocを解凍して、それぞれ独自のフォルダに入れます。
  • libフォルダー内にxxx.jar.properties、javadocを関連付ける各libのファイルを追加します。
  • そのプロパティファイルで、適切なjavadocを解凍したフォルダを参照します(Windowsでは、バックスラッシュをエスケープします)。

doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices

  • Eclipseでプロジェクトを閉じて再度開きます(更新だけでは不十分です)。適切なクラスにカーソルを合わせると、ツールチップが表示されます。

これらの手順(javadocを解凍しない、フォルダーではなくファイルを参照するなど)を守らないと、問題が解決するようです。


1

私はこの質問がかなり古いことを知っていますが、私が昨日同じ問題に直面していて、上記に投稿された解決策が私にとって非常に煩わしい場合、プロジェクトの.classpathファイルにソースパス定義を簡単に追加できることがわかりました。Eclipseはそれを適応させ、ソースを閲覧することができます。

前のクラスパスエントリ:

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]"/>

ソースにパスを追加した後

<classpathentry kind="lib" path="[PATH_TO_MY_JAR]" sourcepath="[PATH_TO_MY_SOURCE_JAR]"/>

お役に立てれば


0

ADTプラグインを更新するだけです。それは私のために働いた!!

  1. Eclipseを起動し、[ヘルプ]> [新しいソフトウェアのインストール]を選択します。
  2. 右上隅にある[追加]をクリックします。
  3. 表示される[リポジトリの追加]ダイアログで、名前に「ADTプラグイン」、場所に次のURLを入力します。https//dl-ssl.google.com/android/eclipse/ 注:Androidデベロッパーツールの更新サイトには、安全な接続。入力する更新サイトのURLがHTTPSで始まることを確認してください。
  4. OKをクリックします。「使用可能なソフトウェア」ダイアログで、「開発者ツール」の横にあるチェックボックスを選択して、「次へ」をクリックします。
  5. 次のウィンドウに、ダウンロードするツールのリストが表示されます。次へをクリックします。
  6. 使用許諾契約を読んで同意し、[完了]をクリックします。
  7. ソフトウェアの信頼性または有効性を確立できないことを示すセキュリティ警告が表示された場合は、[OK]をクリックします。
  8. インストールが完了したら、Eclipseを再起動します

お役に立てば幸いです。


0

特定のjarについて、コーディング中にツールチップのJavadocヘルプを表示するには、次の操作を行います。プロジェクトを右クリックし、[プロパティ]> [Javaビルドパス]> [ライブラリ]タブをクリックします。jarの横の矢印をクリックして展開します。

ソースの添付ファイルは、実際のjarの場所を指している必要があります(おそらくjavaフォルダーの右側)。

Javadocの場所:URLとアーカイブの2つの選択肢があります。このjar のjavadocが、第1レベルにindex.htmlファイルを含むフォルダーの形式である場合は、「Javadoc URL」を選択し、そのフォルダーをポイントします。Javadocがjarにある場合は、「アーカイブ内のJavadoc」を選択し、jarをポイントします。ワークスペースを再起動するか、プロジェクトを閉じて再度開き、Javadoc情報でツールチップを更新することを忘れないでください。

これが、非常に単純なタスクであるべきだと私が信じていることに簡単な答えを与えるのに役立つことを願っています。


0

私の解決策:

「Java Source Attacher Feature」というEclipseプラグインをダウンロードします。

後で、jarを選択し、このプラグインを使用してソースコードを添付します。jarファイルをクリックして選択し、マウスの右ボタンをクリックして、「attach java source」を選択します。

ソースコードがあると、自動的にjavadocができます。

これで、クラスでF2を使用して、関連付けられたjavadocを表示できます。

楽しい

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.