1. ホーム
  2. アンドロイド

[解決済み】libsフォルダのjarにjavadocやソースを添付する方法は?

2022-04-03 20:55:11

質問

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

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

解決方法を教えてください。

の回答をまとめると、以下のようになります。 ザビエル , プラスティヴ , VinceFR そして クリストファー .

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

をリンクさせるために ソースと javadoc を .jar ライブラリにリンクし、Eclipse で自動的にリンクするようにするには、次のようにする必要があります。

  1. ライブラリの .jar ファイルを ライブラリ フォルダに、関連する source .jar と doc .jar ファイルをそれぞれ別のサブフォルダ libs/src libs/docs . 以外の名前を使用することができます。 src ドキュメント を使用することもできますが、.jar ファイルが直接 ライブラリ フォルダーに格納されます。
  2. を作成します。 .properties ファイルを ライブラリ フォルダに、実際のライブラリ.jarの正確な名前で保存します(例参照)。必ず .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を他のフォルダに移動したり、相対パスを指定することも可能です。それはあなた次第です。ソースと javadoc の jar を直接 lib フォルダーを使用することも可能ですが 推奨しない そのため、ドキュメントやソースコードが アプリケーションに含まれる .



EclipseのJavaDocパネルの画面。

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


解凍されたjavadocsを参照する

パックされて提供されていないjavadocsを参照したい場合は、以下のようにします。 .jar でなく、単に ファイルやフォルダーとして で尋ねたように アンドロイド開発者コメント を実行してください。

  1. ライブラリを配置する .jar の中にある libs/ フォルダ
  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 ライブラリ .