Documentation

You are viewing the documentation for Play 1. The documentation for Play 2 is here.

インストールガイド

前提条件

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 を設定しよう を見てください。