last update: $Date: 2008/02/20 06:02:29 $

# ドキュメント

## インストールマニュアル

### Windowsへのインストール

1. 動作環境

   - Microsoft Windows 2000/XP (16bitカラー以上)
   - Microsoft OpenGL 4.0以降
   - Apple QuickTime 4.1以降
   - Java2 SDK 1.4.2以降
2. SDK/JREのインストール

   Sun Microsystems社のJava2 Software Development Kit (SDK) またはJava2 Runtime Environment (JRE)をインストールします。 SDKおよびJREは、Sun Microsystems社にあるJava Technologyのホームページから無償でダウンロードすることができます。

   JDKおよびJREはインストーラ付きの実行形式のファイルとして提供されているので、入手したファイルを実行し、指示にしたがってインストールを行って下さい。

3. Apple QuickTimeのインストール

   Apple QuickTime 4.1 以上をダウンロードし、指示にしたがってインストールしてください。 Apple QuickTime は、http://www.apple.com/quicktime/ から無償でダウンロード可能です。

   なお、QuickTime for Java は使用しないのでインストールする必要はありません。

   (注) Jun500 以降、QuickTime for Javaを用いて動画を再生することも出来るようになりました。

4. 「じゅん for Java」のインストール

   「じゅん for Java」の最新版は、SRAのFTPサーバからダウンロードすることができます。

   ダウンロードしたファイルはZIP形式のファイルになっており、展開すると下記のファイルおよびディレクトリが作成されます。 適当なディレクトリ(例えば`C:\Jun4Java\`)を作成し、そこに展開してください。

   > `README` | ... | READMEファイル
   > `changes` | ... | 更新履歴ファイル
   > `doc/Installation/` | ... | インストール方法の解説マニュアル
   > `src/` | ... | ソースディレクトリ
   > `src-jni/GL/` | ... | OpenGLのためのJNI準拠DLLのソースディレクトリ
   > `src-jni/QT/` | ... | Apple QuickTime のためのJNI準拠DLLのソースディレクトリ
   > `lib/jun???.jar` | ... | JAR形式のクラスライブラリ。???の部分はバージョン番号
   > `lib/windows/JunGL.dll` | ... | JavaからOpenGLを利用するために必要なJNI準拠のDLLファイル
   > `lib/windows/JunQT.dll` | ... | JavaからApple QuickTimeを利用するために必要なJNI準拠のDLLファイル

   このうち、`JunGL.dll` および `JunQT.dll` はシステムディレクトリなどのパスが設定されたディレクトリにコピーまたは移動してください。

   また、ダウンロードしたファイルには StPL (Smalltalk-Style Programming Library) が同梱されています。

   > `README-StPL` | ... | StPLのREADMEファイル
   > `src/sra/smalltalk` | ... | StPLのソースディレクトリ
   > `src-jni/ST/` | ... | StPLのためのJNI用共有ライブラリのソースディレクトリ
   > `lib/StPL??.jar` | ... | JAR形式のStPL。??の部分はバージョン番号
   > `lib/windows/StPL.dll` | ... | StPLのためのJNI準拠soファイル

   StPLは、Smalltalkで作られた「じゅん for Smalltalk」をJavaに移植するために利用したSRA社製の「Smalltalk風プログラミングライブラリ(Smalltalk-style Programming Library)」です。 `StPL.dll`はシステムディレクトリなどのパスが設定されたディレクトリにコピーまたは移動してください。

5. ラウンチャの起動

   インストールした2つのJARファイル(`jun???.jar`と`StPL??.jar`)をJavaのクラスパスに加え、`main`メソッドを持つクラスを指定して、Java仮想マシンを実行します。

   例えば以下のようなコマンドで実行が可能です。

           java -cp C:\Jun4Java\lib\jun699.jar;C:\Jun4Java\lib\StPL89.jar jp.co.sra.jun.system.support.JunLauncher

   ここでは、「じゅん for Java」が `C:\Jun4Java\`にインストールされているものとしています。 別の場所にインストールした場合には、`CLASSPATH`の指定を適宜変更して下さい。
6. うまく動かないとき
   - ラウンチャが起動しないで "`Can't find JNI librarlly 'JunGL'.`" と表示される。

     > `JunGL.dll` が見つかりませんでした。 環境変数 `PATH` の検索対象となるディレクトリに `JunGL.dll` を置いてください。

   - ラウンチャが起動しないで "`JNI library 'JunGL' version error.`" と表示される。

     > 違うバージョンの `JunGL.dll` が見つかりました。 環境変数 `PATH` の検索対象となるディレクトリに、展開したファイルに含まれる `JunGL.dll` を上書きコピーしてください。

     > 環境変数 `PATH` に複数のディレクトリが指定されている場合は、複数のディレクトリに `JunGL.dll` が存在しないようにしてください。

   - ムービーウィンドウを開こうとすると "`Can't find JNI librally 'JunQT'.`" と表示される。

     > `JunQT.dll` が見つかりませんでした。 環境変数 `PATH` の検索対象となるディレクトリに `JunQT.dll` を置いてください。

   - ムービーウィンドウを開こうとすると "`JNI library 'JunQT' version error.`" と表示される。

     > 違うバージョンの `JunQT.dll` が見つかりました。 環境変数 `PATH` の検索対象となるディレクトリに、展開したファイルに含まれる `JunQT.dll` を上書きコピーしてください。

     > 環境変数 `PATH` に複数のディレクトリが指定されている場合は、複数のディレクトリに `JunQT.dll` が存在しないようにしてください。

http://www.sra.co.jp/people/nisinaka/
mailto:nisinaka@sra.co.jp