![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
wija およびそのプラグインは Java 言語 (J2SE; Java 2 Standard Edition) により記述されています*1。 J2SE による開発には JDK (J2SE Development Kit) が必要です (Mac OS X には付属しています)。 また、ビルドは ant ツールにより行われることを想定しています。
Media Art Online で開発・配布されるソフトウェアおよび web サイトは、 wija およびそのプラグインを含め、 Perforce ソフトウェアによってバージョン管理されています。 Perforce は商用ソフトウェアですが、Media Art Online では、現在、オープンソースの開発目的に限り、 40ユーザのライセンスを Perforce 社から無償で取得しています (将来的にはユーザ数を増やしてもらえる可能性もあります)。 また、Media Art Online での開発を行わず、参照・取得するだけの目的であれば、 どなたでも Perforce ソフトウェア (クライアントソフトウェアは無償) を用いて開発中の最新のソースコードを取得できます。
Perforce の 40ユーザのライセンスを活用するために、 また、開発上の様々な議論を行うために、wija-devel(-en) メーリングリストが用意されています (wija-devel-en では英語のみを用います)。 wija-devel(-en) のメンバには、 バージョン管理データベースへの書き込みが許可された Perforce ユーザアカウントが割り振られます。
wija-devel(-en) メーリングリストに参加されたい方は、下記までご連絡ください。
wija-devel(-en) のメンバは、 Perforce によるレビューメッセージを受け取ることで、 更新があったときに最新のソフトウェアやドキュメンテーションを試用できます。
しかし、Perforce で取得できるのはソースコードですので、実際に試用するためには、 開発ツールを用いてソフトウェアをビルドする必要があります。 その操作は、ソフトウェアの開発に携わっていない人にとっては煩雑だと考えられます。
そこで、開発ツールを用いない方でも、更新があったときにそれを試せるように、 内部リリースを行います。
この内部リリースは、更新があった翌日の、日本時間の明け方に行われます。 (将来的には自動化する予定ですが、当面、手作業で行いますので、実施時間にブレが生じます。) 以下の URL から内部リリースをダウンロードできるようにします。
※ 当面は、内部リリース自体が Perforce によるレビューメッセージで通知されます。
内部リリースは、対応する最新の Perforce change 番号を含んだ次のファイル名で、 圧縮アーカイブファイルとして提供されます。
wija-change番号.zip
同様に、ヘルプページも「オムニドキュメント」という形式で書かれたソースコードが バージョン管理の対象となりますので、ご自身のコンピュータ上で web ページとして閲覧するためには開発ツール (ヘルプページ作成ツール) によるビルドが必要です。 しかし、この場合、Media Art Online のスタッフも web サーバ上でビルドを行いますので (将来的には自動化したいですが)、しばらくすると、 次の URL から更新内容が反映されたページを閲覧できるようになります。
試用した結果、問題がなければ更新内容が http://www.media-art-online.org/wija/ に反映されます。
Perforce は、離れた場所にいて、別々のコンピュータを使っている人々が、 インターネットを用いてひとつのソフトウェアやドキュメンテーションを開発することを支援するソフトウェアです。 Perforce では、ソフトウェアやドキュメンテーションを構成するファイルのひとつひとつについて、 バージョンを管理できます。
何故、Perforce なのか:
Perforce と同様にバージョン管理を行うソフトウェアには様々なものがあります。 特に、CVS (Concurrent Versions System) と呼ばれるソフトウェアは無償で利用でき、 フリーソフトウェアの開発に広く使われています。 Media Art Online で Perforce を用いている理由としては、それが高速であること、 また、デザインが整理されており、保護機構も強力で、緻密な設定が可能であることなどがあげられます。
※ Perforce ソフトウェアの使用は必須ではありません。
ご自分で開発をされない方は、nightly build を活用してください。
お使いのプラットフォームでの方法に沿って、以下の環境変数を設定してください。
| 環境変数名 | 意味 | 設定する内容 |
| P4CLIENT | クライアント名 | ユーザが用いるワークスペースを識別するのに用いられます。 |
|---|---|---|
| P4EDITOR | エディタ | ユーザが普段用いているエディタプログラム |
| P4PASSWD | パスワード | お知らせしたパスワード |
| P4PORT | サーバ名:ポート | perforce.media-art-online.org:1666 |
| P4USER | ユーザ名 | お知らせしたユーザ名 |
クライアント名の付け方は、次の形式を参考にしてください。
コンピュータ名_scm ←ソフトウェア開発用のクライアント名 コンピュータ名_wcm ←ドキュメント開発用のクライアント名
p4 ソフトウェアでは、-c オプションによりクライアント名を指定できるので、 複数のクライアントを切り替えて使う方は、環境変数 P4CLIENT を設定する必要はありません。
p4 では、次の形式でコマンドを打ち込みます ($ はプロンプトを表しています)。
$ p4 コマンド [コマンドオプション...] [コマンド引数...]
グローバルオプション (-c 等) はコマンドよりも前に指定します。 例えば次のような形式になります。
$ p4 -c クライアント名 コマンド [コマンドオプション...] [コマンド引数...]
p4 での主なコマンドは以下の通りです。
| コマンド名 | 機能 |
| p4 add | ファイルの追加 |
|---|---|
| p4 client | クライアントの作成・編集・削除 |
| p4 clients | クライアントの一覧表示 |
| p4 delete | ファイルの削除 |
| p4 edit | ファイルを編集のためにオープン |
| p4 resolve | 編集内容の衝突の解決 |
| p4 revert | 提出前の変更の取り消し |
| p4 submit | 追加・編集・削除内容の depot への提出 |
| p4 sync | depot からファイルを取得してワークスペースを更新 |
| p4 user | ユーザの作成・編集・削除 |
| p4 users | ユーザの一覧表示 |
Media Art Online における Perforce 応用システムを MAO WSCM (Media Art Online Web/Software Configuration Management) と呼んでいます。 Media Art Online での depot の大まかな構成は以下の通りです。
| パス | 意味 |
| //depot/wcm/... | Media Art Online Web サイト (wija ヘルプページを含む) |
|---|---|
| //depot/scm/... | Media Art Online ソフトウェア (wija を含む) |
| //depot/docs/... | Media Art Online パブリケーション (論文、発表資料等) |
wija-devel(-en) メーリングリストのメンバは、//depot/wcm/... と //depot/scm/... に対するレビューメッセージを受け取るように設定されています (設定はご自分で変更可能です)。 wija-devel(-en) メーリングリストのメンバのうち、村井研究室のメンバは、 更に //depot/docs/... に対するレビューメッセージを受け取るように設定されています。
パブリケーションに p4 submit された内容は以下の URL から自動的にアクセス可能になります。
wija に関係するディレクトリは、//depot/scm/main/ 以下、次のようになっています。
+-java----+ ↓java ディレクトリ以下は p4 sync で自動的に作成されます。 | | | +-org-+ | | | +-media-art-online-+ | | | +-encoding (符号化ライブラリ) | | | +-gnupg (GnuPG ライブラリ) | | | +-helpgen (ヘルプページ作成ツール) | | | +-iwat (i-WAT プラグイン) | | | +-iwatsrv (i-WAT ロボットプラグイン) | | | +-jabber (Jabber/XMPP ライブラリ) | | | +-omelets (OMELETS (LETS) ライブラリ) | | | +-plugin (プラグインライブラリ) | | | +-qtx (Cutie X プラグイン) | | | +-spotlite (SpotLite プラグイン) | | | +-tunes (Tunes プラグイン) | | | +-whp (WIDE Hours プラグイン) | | | +-whpsrv (WIDE Hours ロボットプラグイン) | | | +-wija (wija ライブラリ) | | | +-wija_ (wija 主プログラム) | | | +-wijabot (wija ロボット主プログラム) | | | +-xml (XML ライブラリ) | | +-javadoc (ドキュメントディレクトリ; ant doc で自動的に作成されます) | +-javaout (出力ディレクトリ; ビルドする前に作成しておく必要があります)
helpgen と omelets は wija の一部ではありません (helpgen はヘルプページ作成ツールで、ヘルプページを記述するためのオムニドキュメントのトランスレータが現状 omelets の中に含まれています)。
また、wijabot は自動化可能な wija であり、wija とは別々にビルドされます。
wija に関係するディレクトリは、//depot/wcm/main/ 以下、次のようになっています。
+-gnupg--+
| |
| +-help (GnuPG ヘルプページ)
|
+-iwat---+ (i-WAT 主ページ)
| |
| +-help (i-WAT ヘルプページ)
|
+-java---+
| |
| +-help (Java ヘルプページ)
|
+-png (画像ファイル)
|
+-png-en (画像ファイル - 英語版用)
|
+-wija---+ (wija 主ページ)
|
+-help (wija ヘルプページ)
|
+-download-+ (wija ダウンロードページ)
|
+-0.07 (version 0.07 リリースファイル)
|
:
上では、i-WAT はプラグインの代表として描かれています。 Media Art Online で開発されるその他のプラグインの web ページもこの構成に従います。
0.07 はリリースされているバージョンの代表として描かれています。
Media Art Online のメンバによるパブリケーションは //depot/docs/main/ 以下、次のように格納されています。
+-tex-+ (論文／発表資料の LaTeX2εソースファイル)
|
+-eps (論文／発表資料に挿入する図版)
ユーザの設定は、p4 user コマンドにより行います。 以下のコマンドを打ち込むと、エディタが開き、ユーザの設定を変更することができます。
$ p4 user ユーザ名
Media Art Online から Perforce ユーザアカウントを取得した場合、 初期パスワードが設定されていますので、セキュリティ上、それを変更することが強く奨励されます。
Password: ****** ←書き換えます
また、以下のようにレビューメッセージが設定されていますが、変更が可能です。
Reviews:
//depot/wcm/... ←ドキュメントの更新のレビューメッセージを受け取ることを示します
//depot/scm/... ←ソフトウェアの更新のレビューメッセージを受け取ることを示します
ユーザの設定が済んだら、クライアント (depot とワークスペースのマッピング) を作成します。 次のコマンドを打ち込むと、エディタが開きます。
$ p4 client クライアント名
クライアント名にはお使いのコンピュータ名 (種類ではなく、個体名) を含めるようにすると、 混乱を避けられます (例: iggy_wcm ← iggy というコンピュータでドキュメント開発を行う)。
depot とワークスペースのマッピングのためには、Root と View を設定します。
Root: 基点となるディレクトリ名 (例: /Users/alice/Programs)
Root で、ワークスペースの基点となるディレクトリ名を指定します。 ソフトウェア開発であれば、ご自分のホームディレクトリ下の Programs という名称を奨励します。 ドキュメント開発の場合は、 ご自分のコンピュータの web 共有のためのディレクトリを指定するとよいでしょう。
View:
//depot/scm/main/java/org/... //クライアント名/java/org/...
View では、depot 内のパスとワークスペース内のパス (Root からの相対指定) のマッピングを定義します。 上は、ソフトウェア開発のために指定すべき内容を示しています。
View:
//depot/wcm/main/gnupg/... //クライアント名/gnupg/...
//depot/wcm/main/iwat/... //クライアント名/iwat/...
//depot/wcm/main/java/... //クライアント名/java/...
//depot/wcm/main/png/... //クライアント名/png/...
//depot/wcm/main/png-en/... //クライアント名/png-en/...
//depot/wcm/main/wide_hour/help/... //クライアント名/wide_hour/help/...
//depot/wcm/main/wija/... //クライアント名/wija/...
上は、煩雑ですが、ドキュメント開発のために指定すべき内容です。 Media Art Online の web サイト (//depot/wcm/main/ 以下) には、 wija 関連のページ以外にも大量のコンテンツがあるため、 上のように書いた方がローカルディスク資源を節約できます。
p4 sync コマンドにより、depot の内容をワークスペースに読み込みます。 下は、コマンドラインでクライアント名を指定する場合です。
$ p4 -c クライアント名 sync
ソフトウェアのビルドには ant ツールが必要です。
wija 本体をビルドする場合は次のようにします (ワークスペースの基点が ~/Programs であると前提)。
$ cd ~/Programs/java/org/media_art_online/wija_ $ ant package
ビルドが完了すると、~/Programs/javaout にソフトウェアが構築されています (予め ~/Programs/javaout を作成しておいてください)。
更にプラグインをビルドする場合は、例えば i-WAT であれば次のようにします。
$ cd ../iwat $ ant package
ドキュメントのビルドには、現状では Perl が必要です。 また、helpgen をビルドしておく必要があります。
以下は、ソフトウェア開発用ワークスペースの基点が ~/Programs であることを前提にしています。
$ cd ~/Programs/javaout $ perl helpgen.pl ドキュメント開発用ワークスペースの基点
レビューメッセージを受け取ったら、Perforce を用いている場合は、以下のコマンドで再度、 depot からファイルをワークスペースにダウンロードしてください。
$ p4 -c クライアント名 sync
そしてビルドを行い、問題が生じていないか確かめてください。
Perforce を用いない場合は、nightly build を待って試用してください。
p4 add により、ワークスペースにファイルを追加できます。 ファイルを作成する前後 (後を推奨します) に、 以下のようなコマンドにより、depot に対して、追加しつつあるファイルの存在を知らせます (p4 submit するまで、実際には追加されません)。
$ p4 -c クライアント名 add -t ファイルタイプ ファイル名...
ファイルタイプは、ファイルの種類を指定します。
| ファイルタイプ | 意味 |
| text+k | テキストファイル (キーワード変換あり) |
|---|---|
| binary | バイナリファイル |
キーワード変換:
ソースコードに次のような文字列を注釈として埋め込んでおくことにより、 p4 submit 時にキーワードが変換され、更新日時などの情報をソースコード自体から読み取れるようになります。
| キーワード | 意味 |
| $Id$ | ファイルの ID (depot 上のパスとリビジョン) |
|---|---|
| $DateTime$ | ファイルの更新日時 |
p4 add による、ファイルの追加予約は、p4 revert によって取り消すことができます。
既存のファイルは、Perforce によってロックされています。 ロックを解除し、編集可能にするためには、p4 edit を用います。
$ p4 -c クライアント名 edit ファイル名...
p4 edit の後に行った編集内容は、p4 revert により取り消すことができます。
$ p4 -c クライアント名 submit
Description を記述します (なるべく英語を用いてください)。
