StompBox/Kick Ver.1.4 取扱説明書

はじめに――StompBox/Kickについて

 StompBox/Kickを入手いただきありがとうございます。
 StompBox/KickはJavaで作成したシンプルなソフトウェアランチャです。他に実行環境の情報参照のための機能を実装してあります。主にJ2ME搭載のシャープZaurusでのJavaプログラムの開発・実行を容易にすることを目標に開発しました。そのためJ2ME搭載Zaurus(SL-C750/760/860)用のパッケージも用意してあります。J2ME搭載Zaurus以外ではGUIツールキットとしてAWTまたはSwingを選択できます。ソースも同梱しました。
 ごくささやかなユーティリティですがお役にたてば幸いです。
 使用にあたっては「著作権、権利、免責事項、その他」をお読みください。

動作環境

 本ソフトウェアは次の環境で動作の確認を行いました :

 Zaurus SL-C860に搭載されているJava実行環境はJava 2 Platoform Micro Edition(以下J2ME) Connected Device Configuration, Foundation Profile and Personal Profileとのことで、これはJRE 1.3.1準拠とされています。ですのでJRE 1.3.1以上が導入されていれば動作するものと思われます。
 特殊なことは行っていないのでそれ以前のJREでも動作するかもしれませんが、安心して動作させるためには最新のJREの導入をおすすめします(もちろんJ2ME搭載のZaurusの場合は何もする必要はありません)。

導入(install)と削除(uninstall)

 配布パッケージには次のファイルが含まれています :

J2ME搭載Zaurusへの導入と削除

 パッケージファイルsbkickj2me_1.4_arm.ipkを通常の手順にしたがって導入してください。削除も同様です。

上記以外の環境への導入と削除

 インストーラは付属しません。SBKick.jarを任意のディレクトリにコピーすれば導入は終わりです。Windows環境でショートカットを作成する際はお好みにより配布パッケージに含めてあるアイコンファイルをお使いください。
 アンインストーラも付属しません。導入時にコピーしたファイルおよび独自に作成したショートカットやリンクを削除してください。
 また本アプリケーションは次の二つの設定ファイルをログインユーザーのホームディレクトリ(Windowsでは一般的にはC:\Documents and Settings\%ログインユーザー名%、Unixでは~/)に作成します:

 非常にちいさなファイルですが、気になる方は手作業で削除してください。

使いかた

 J2ME搭載Zaurusに導入した場合は一般的なアプリケーションと同様アイコンを選択して起動してください。
 それ以外の環境では通常の手順にしたがってSBKick.jarを実行してください(Windows環境ならSBKick.jarをダブルクリックするだけで起動します)。
 指定可能な引数は次のとおりです:

/AWT
GUIツールキットとしてAWTを利用します。J2ME搭載Zaurusでは常に指定されているとみなします。
/SwingFrame
ウィンドウのタイトルバーや枠をOSではなくJavaが管理するようにします。GUIツールキットとしてAWTを利用しないときのみ有効です。

 GUIツールキットとしてSwingを利用する場合は機能をウィンドウ上部のタブで切り替えます。AWTを利用する場合は機能をウィンドウ上部のコンボボックスで切り替えます。以後の説明ではSwing版のユーザーインターフェースの用語を使用します。

直接指定による実行と登録

 はじめて起動すると「指定」タブが選択されて表示されます。
「指定」タブには次の入力フィールドがあります:

「実行ファイル」入力フィールドに起動したいプログラムのファイルのパスを指定してウィンドウ下部の「実行」ボタンを押すと指定したプログラムを起動します。このとき指定したプログラムがJava実行ファイル(拡張子が.jarまたは.class)のときは適切なコマンドラインを作成して実行します。
「参照」ボタンを押すとファイル選択ダイアログボックスで実行するファイルを選択できます。
 Javaプログラム実行時に追加のクラスライブラリの指定が必要なときは「追加」ボタンを押すとクラスライブラリの存在するパスを選択できます。選択したパスは「クラスパス」リストボックスに追加されます。パスは複数指定することができます。不要なパスはリストボックスで選択後「削除」ボタンを押すと削除できます。
 引数を指定したいときは「引数」入力フィールドに指定したい引数を入力してください。

 指定した情報は一覧に登録することができます。「名前」入力フィールドに名前を入力して「登録」ボタンを押してください。「更新」ボタンを押すと一覧で選択中の実行情報を置き換えます。

一覧からの選択による実行

「選択」タブを選択すると登録されている実行情報の一覧が表示されます(実行情報が登録されている状態で起動すると最初にこちらが表示されます)。一覧から実行情報を選択してウィンドウ下部の「実行」ボタンを押すと指定した情報でプログラムを起動します。
 選択した項目は「上へ」ボタンで一覧の上へ、「下へ」ボタンで一覧の下へ移動させることができます。また「登録」メニューの「選択を削除」を選択すると一覧から削除できます。
「登録」メニューの「選択を編集」を選択するとタブが「指定」に切り替わります。このとき各入力フィールドには「選択」タブで選択していた実行情報の内容が設定されています。編集後「更新」ボタンを押すと一覧で選択中の実行情報を置き換えます。

実行結果の参照

 実行すると「結果」タブに切り替わって起動したプログラムの名前(指定されている場合)またはファイル名とStompBox/Kickでの管理IDを表示します。以後起動プログラムが標準出力又は標準エラー出力に出力した内容はこのタブのテキストエリアに出力します。最新の出力はウィンドウ下部のステータスバーにも出力します。
 どの起動プログラムの出力かは行先頭のプロンプトに示します。プロンプトの構成はID:出力の種類>で、出力の種類はOのとき標準出力、Eのとき標準エラー出力、-のときStompBox/Kickが追加した情報です。  終了時には終了メッセージと終了コードを出力します。
 この結果は1000行まで保持します。

その他

スクリプトファイルの作成

「登録」メニューの「スクリプト作成」を選択すると「選択」タブで選択されている、または「指定」タブに入力されている実行情報を元に作成したコマンドラインをファイルとして作成します。ファイル保存ダイアログボックスが表示されるので作成ファイルの保存パスを選択してファイル名を入力してください。なおこの操作はコマンドラインが実行可能でないと行いません。

Javaクラス定義の参照

「JRE」タブを選択するとJava実行環境で利用可能なクラスの定義を参照できます。最上部の入力フィールドに参照したいクラスの名前を完全修飾名で入力して「表示」ボタンを選択してください。中央のテキストエリアにそのクラスの次の定義情報が表示されます:

 入力されたクラスが存在しないときは(Not Found)と表示します。

環境情報の参照

「情報」タブを選択するとJava実行環境のシステムプロパティの内容と利用可能なフォントファミリ名の一覧を参照できます。
 システムプロパティの内容は基本的にはキーと値をそのまま表示しますが、次の二点だけ加工します:

情報のコピー

「編集」メニューの「コピー」を選択すると選択しているタブの情報をクリップボードにコピーします。コピーする情報は次のとおりです:

「選択」タブまたは「指定」タブ選択時のコマンドラインのコピーは入力が実行可能でないと行いません。
「結果」タブ、「JRE」タブ、または「情報」タブ選択時にコピーを実行すると、テキストが選択されているときはその選択だけを、選択されていないときは内容すべてをコピーします。

表示設定の変更

「表示」メニューの「ステータスバー」を選択するとステータスバーの表示 / 非表示を切り替えられます。またGUIツールキットとしてSwingを利用しているときは全体の見た目を「表示」メニューの名称を選択することで切り替えられます。

制限

全般的な制限

Windows固有の制限

Unix全般の制限

J2ME搭載Zaurus固有の制限

著作権、権利、免責事項、その他

著作権者

 本ソフトウェアの著作権はD.B.C.が管理するものとします。

免責事項

権利

 本ソフトウェアはフリーウェアです。再配布や転載にあたっては特に条件を定めません。連絡をいただければありがたく思います。

その他

 精神的・肉体的、抽象的・具体的、その他あらゆるレベルを問わず他者に危害を加える、または危害を加えることを支援する目的で本ソフトウェアを使用することは禁じます。

連絡先

 本ソフトウェアに関するご意見・ご要望・バグ報告などは電子私書箱contact.d.b.c@gmail.comまでお寄せください。今後の参考とさせていただきます。活用例などもお待ちしております。
 個人の範囲を超えて利用される際にはお知らせいただければうれしく思います。
 最新情報はD.B.C Software Craft Studioをご参照ください。
 また、D.B.C.は他にSturgeon's Trashcanで別の活動を公開しています。よろしければ、こちらもどうぞ。

開発環境

 本ソフトウェアは次の環境で作成しました:

ハードウェア
IBM ThinkPad X22(CPU = Pentium III Mobile 733MHz, Memory = 640MByte)
OS
Microsoft Windows2000 Professional(with Service Pack 4)
開発言語
Java 2 SDK, Standard Edition 1.4.2_14(Sun Microsystems)
開発統合環境
Eclipse 2.1.2(Eclipse Foudation)
最適化
ProGuard 3.11(Eric Lafortune)
文書作成
xyzzy(亀井哲弥)

履歴

Ver.1.4(2008-03-02)
Ver.1.3 Release 2(2006-12-01)
Ver.1.3(2005-10-22)
Ver.1.2(2005-06-26)
Ver.1.0(2005-05-21)
Ver.0.8(2005-01-08)
公開。