2006/02/24(金) [n年前の日記]
#1 [iappli][eclipse] eclipseでJavaDocを参照できるように設定
_ITmedia エンタープライズ:特集:Eclipseで始めるiアプリ――コード支援編 (6/6)
_Connected Limited Device Configuration (CLDC)
_J2ME Documentation
CLDC 1.0.4 のところに、
_作ろうiモードコンテンツ | NTTドコモ
DoJa 3.0 の、jguidefordoja3_0_apiref_040616.zip というのをDL。解凍。
iアプリのプログラムに限らず、プログラムの記述中にはどのようなクラスやメソッドが利用可能かを調べることが大切です。これに関連するものとして、Javaのクラスやメソッドの使い方を書いたドキュメントを「JavaDoc」と呼びます。特にiアプリのプログラムを作成する際には、CLDCのドキュメントとDoJaのドキュメントが必要です。
Eclipseでは、JavaDocを組み込むことで、クラスやメソッドのドキュメント閲覧を軽減することが可能です。Eclipseは、JavaDocをAPIライブラリのファイルに結びつけて登録します。んん?
ただし、DoJaプラグインが対応しているEclipse 2.1では、拡張子がzipになっているライブラリファイルにはJavaDocを結びつけることができません。このため、ライブラリのzipファイルをコピーして、拡張子をjarにしたものを作成します。
さらに、iアプリ作成ツールをインストールしたフォルダのlibフォルダには、classes.zip と doja_classes.zip というファイルがあるので、これらをコピーしてclasses.jarとdoja_classes.jarというファイルを作成します。
- classes.zip → classes.jar
- doja_classes.zip → doja_classes.jar
_Connected Limited Device Configuration (CLDC)
_J2ME Documentation
CLDC 1.0.4 のところに、
CLDC API Documentation, V1.0, also (ZIP) or Japanese (ZIP, 1.4MB)というのがあるように見える。CLDC1.0_ja_docs.zip というのをDL。解凍。
_作ろうiモードコンテンツ | NTTドコモ
DoJa 3.0 の、jguidefordoja3_0_apiref_040616.zip というのをDL。解凍。
- プロジェクトを右クリック
- プロパティ → Javaのビルドパス → ライブラリー。
- classes.zip ( or doja_classes.zip) を選択して、「編集」。
- .zip を .jar に変更。
- 左側の[+]をクリック。
- JavaDoc ロケーション、を選択。「編集」。
- 「参照」でローカルのフォルダを選択。
- 「検証」を押して、index.html が見つかった云々のメッセージが表示されるのを確認。
◎ _EclipseでDoja :
別の方法が紹介されてる。
DoJaのJavaDocは、DoJaをインストールしたディレクトリのdocにあります(デフォルトでC:\iDKDoJa3.5\doc)。DoJaのライブラリ(classes.zipとdoja_classes.zip)にJavaDocロケーションを設定すれば、外部JavaDocとして開けるはずですが。。。
なんか、ZIPにJavaDoc添付できないなー。classes.zipを右クリックでプロパティーが開けないし、Javaビルド・パスのところで添付しても何故か消えちゃう。Eclipse2ってZIPにJavaDoc添付できないんだったっけ???(そういえば拡張子がZIPのアーカイブにJavaDoc添付ってやったことなかったかも。。。)
あまり美しくないですが、とりあえずの対処。Eclipseをインストールしたディレクトリのworkspace\.metadata\.plugins\org.eclipse.jdt.ui\javadoclocations.xml(JavaDocロケーションの定義ファイル)に直接JavaDoc設定を記述すると一応添付できます(以下)。
<?xml version="1.0" encoding="UTF-8"?>
<javadoclocation>
<location_01 path="C:/iDKDoJa3.5/lib/classes.zip" url="file:/C:/iDKDoJa3.5/doc/"/>
<location_01 path="C:/iDKDoJa3.5/lib/doja_classes.zip" url="file:/C:/iDKDoJa3.5/doc/"/>
</javadoclocation>
これで、一応ソース上でDoJaのクラスなどを選択し、SHIFT+F2(ナビゲート→外部JavaDocを開く)でJavaDocが開けます。EclipseでDoja より
[ ツッコむ ]
以上です。