インストールガイド
前提条件
Play framework を実行するには、Java5 以降 が必要です。Play をソースからビルドしたいのであれば、ソースコードを取得するために Bazaar ソースコントロールクライアント が必要であり、ビルドするために Ant が必要になります。
MacOS を使っているのであれば、すでに Java は組み込まれています。Linux を使用している場合は、Sun-JDK か OpenJDK のいずれかを使用すること (多くの Linux ディストリビューションにおいてデフォルトの java コマンドである gcj ではないこと) を確認してください。Windows を使用する場合は、最新の JDK パッケージをダウンロードして、インストールしてください。
カレントパスで java コマンドが認識できることを確認してください (java -version を入力して確認してみてください) 。Play はデフォルトの java コマンドか、 $JAVA_HOME が定義されている場合は、このパスで実行可能な java コマンドを使用します。
play のコマンドラインユーティリティは Python を使用します。ですから、どのような UNIX システムでもそのまま使うことができます (ただし Python 2.5 以上が必要です) 。 Windows で実行する場合でも、フレームワークに Python ランタイムをバンドルしているので、心配する必要はありません。
バイナリパッケージのダウンロード
最新の Play バイナリパッケージ をダウンロードして、アーカイブを展開してください。利便性のために、フレームワークのインストールディレクトリをシステムの PATH に追加することをお勧めします。UNIX を使用している場合は、 play スクリプトが実行できることを確認してください (もしくは、単純に chmod +x play を実行してください) 。これだけです。
Tip
もし何かしらの理由でフレームワークのリビルドが必要になった場合は、 $PLAY_HOME/framework ディレクトリで ant を実行してください。
最新ソースからのビルド
最新の機能やバグ修正の恩恵を得るために、Play をソースからコンパイルしたくなるかもしれません。ソースコードを取得するためには Bazaar クライアント が必要であり、フレームワークをビルドするためには Ant が必要です。
コマンドラインから下記を実行します:
# bzr checkout lp:play
# cd play/framework
# ant
これで Play framework を使用する準備が整いました。
lp:play は、現在 http:bazaar.launchpad.net/%7Eplay-developers/play/1.0/ のエイリアスです。
play コマンドを使用する
フレームワークを正しくインストールしたら、シェルを開いて play コマンドを実行してください。
$ play
play のデフォルトメッセージが見えるはずです:
play help コマンド名 を実行することで、特定のコマンドのより詳細なヘルプを見ることができます。次の例を試してみてください:
# play help run
新しいアプリケーションの作成
new コマンドを使って新しいアプリケーションを作成してください。アプリケーションの作成先として、存在しないパスを指定する必要があります。
# play new myApp
新しいアプリケーションが作成されます。以下のコマンドでアプリケーションを開始します:
# play run myApp
ブラウザで http://localhost:9000 を開いて、アプリケーションのデフォルトページを見ることができます。
Play を利用する環境が整いました
お好みの IDE を設定しよう を見てください。