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

# ドキュメント

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

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

1. 動作環境

   - PowerPC G3, G4, G5 または Intel 搭載の Macintosh
   - Mac OS X 10.1 以上
   - Java 2 Standard Edition 1.4 (Mac OS X に附属)
   - Apple OpenGL (Mac OS X に附属)
   - Apple QuickTime (Mac OS X に附属)

   「じゅん for Java」バージョン 340 以降では Java 2 が必須になってしまったので、Mac OS X でないと動きません。

2. Java 2 Standard Edition 1.4 のインストール

   Mac OS X には Java 2 Standard Edition 1.4 が含まれているので、インストールは不要です。

   「じゅん for Java」を使って開発を行なう場合には、別途 Java コンパイラが必要となりますので、Mac OS X に附属する Developer Tools をインストールしてください。

   なお、Developer Tools の最新版は、Apple Developer Connection に登録すればダウンロードが可能です。 Online Member は無料です。

3. Apple OpenGL のインストール

   Mac OS X には OpenGL が含まれているので、インストールは不要です。

4. Apple QuickTime のインストール

   Mac OS X には QuickTime が含まれているので、インストールは不要です。

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

   「じゅん for Java」の最新版は、SRAのFTPサーバからダウンロードすることができます。 コンパイル作業の必要がないランタイム版もダウンロードすることができます。 ただしランタイム版にはソース・ファイルが付属していません。

   ダウンロードしたファイルはZIP形式のファイルになっており、展開すると下記のファイルおよびフォルダが作成されます。 適当なフォルダを作成し、そこに展開してください。

   ※ なお、ZIP ファイルの展開には StuffIt Expander または ZipIt をお使いください。

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

   また、ダウンロードしたファイルにはStPLが同梱されています。

   > `README-StPL` | ... | StPLのREADMEファイル
   > `src/sra/smalltalk/` | ... | StPLのソースディレクトリ
   > src-jni/ST/ | ... | StPLに必要なJNI準拠共有ライブラリのソースディレクトリ
   > `lib/StPL??.jar` | ... | StPLに必要なJNI準拠共有ライブラリのソースディレクトリ
   > `lib/macosx/libStPL.jnilib` | ... | StPLに必要なJNI準拠共有ライブラリ

   StPLは、Smalltalkで作られた「じゅん for Smalltalk」をJavaに移植するために利用したSRA社製の「Smalltalk風プログラミングライブラリ(Smalltalk-style Programming Library)」です。 概要はディレクトリStPLにあるREADMEファイルを参照してください。

   libJunGL.jnilib などをコンパイルして作りなおす場合は、Developer Tools をインストールして、`~/Jun4Java/src-jni` で `make` を実行してください。

6. ラウンチャの起動

   2つのJARファイル (`jun???.jar` と `StPL??.jar`) と JNIライブラリファイル (`jun4java.shlib`)、QuickTime用のJNIライブラリファイル (`JunQT.shlib`) を `jun4java.app` と同じフォルダに置き、`jun4java.app` を起動してください。

   あるいはTerminal から起動する場合、まず環境変数 `DYLD_LIBRARY_PATH` を JNI ライブラリのある場所に設定します。 次に、インストールした 2 つの JAR ファイル (`jun???.jar` と `StPL??.jar`) を Java のクラスパスに加え、`main` メソッドを持つクラスを指定して、Java 仮想マシンを実行します。

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

           setenv DYLD_LIBRARY_PATH $HOME/Jun4Java/lib/macosx
           java -cp $HOME/Jun4Java/lib/jun699.jar:$HOME/Jun4Java/lib/StPL89.jar jp.co.sra.jun.system.support.JunLauncher

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

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

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

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

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

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

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

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

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

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

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