一、安裝 Play Framework

1. 到官網下載 Play Framework 的安裝檔，檔名會像是 play-1.2.3.zip 這樣的格式。

2. 將 Play Framework 相關檔案，放置到安裝目錄下

我習慣在 C:\ 下，新增一個 Play 目錄，將不同版本的 Play Framework，解壓縮在其中。在 Windows 下，目錄結構看起來會像這樣︰

1
2
3
4
5

C:\Play\
    play-1.1\
    play-1.1.1\
    play-1.2.2\
    play-1.2.3\

而在 Linux / Mac OS X 下，我會在 $HOME 目錄下，新增一個 Play 目錄，將不同版本的 Play Framework，解壓縮在其中。目錄結構看起來會像這樣︰

1
2
3
4
5
6

$HOME/
    Play/
      play-1.1/
      play-1.1.1/
      play-1.2.2/
      play-1.2.3/

3. 設定環境變數

3.1 新增 PLAY_HOME 環境變數，指向 Play Framework 解壓縮下的目錄 (ex: C:\Play]play-1.2.3 or $HOME/Play/play-1.2.3)

3.2 在 PATH 環境變數下，在加入 PLAY_HOME 環境變數。

3.3 以 Mac OS X 為例，我們可以編輯 $HOME/.bashrc 或 $HOME/.bash_profile 設定檔，加入以下設定︰　

1
2

export PLAY_HOME="$HOME/Play/play-1.2"
export PATH=$PLAY_HOME:$PATH

　４. 確認 Play Framework 是否已安裝完成

確認方式也很簡單，在 Windows 下我們打開命令提示字元，Linux 下則是開啓新的 Terminal，執行 Play 指令即可。順利的話，我們會看到以下的畫面︰

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

$ play
~        _            _ 
~  _ __ | | __ _ _  _| |
~ | '_ \| |/ _' | || |_|
~ |  __/|_|\____|\__ (_)
~ |_|            |__/   
~
~ play! 1.2, http://www.playframework.org
~
~ Usage: play cmd [app_path] [--options]
~ 
~ with,  new      Create a new application
~        run      Run the application in the current shell
~        help     Show play help
~

恭喜，安裝已經完成。

二、新增專案

假設今天我們想建立的專案名稱，名稱為 PlayAppDemo，在 Windows 下，我們只需要打開命令提示字元，(Linux/Mac OS X 則是在 Terminal 下)，在我們想要放置專案的目錄下，執行 play new [專案名稱] 指令，就可以完成新增專案的動作。如下︰

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

$ play new PlayAppDem
~        _            _
~  _ __ | | __ _ _  _| |
~ | '_ \| |/ _' | || |_|
~ |  __/|_|\____|\__ (_)
~ |_|            |__/
~
~ play! 1.2, http://www.playframework.org
~
~ The new application will be created in /Users/littlelin/tmp/PlayAppDemo
~ What is the application name? [PlayAppDemo]
~
~ OK, the application is created.
~ Start it with : play run PlayAppDemo
~ Have fun!
~

三、設定 Log 記錄方式

可以參考我之前寫的Play Framework Log 相關設定一文。

(待續…)

XMind 在幫我歸納一堆雜亂的資訊時很好用，很多時候因為資訊太雜，或是有時候時間有點斷斷續續，所以我通常的做法就是想到什麼就亂打什麼，等全部打完再來歸納重點。

透過 XMind 心智圖的形式，其實項目的階層非常容易整理，而且也很容易做。後來我也拿它做為我去開會記錄時的工具，發現比起純寫筆記，回來整理會議記錄時，使用這樣形式記錄下來的重點，更容易讓我回想當時討論的重點跟一些細節。

最近甚至在某些場合，也試著拿 XMind 做為向客戶溝通想法的工具，在某些情境下，覺得甚至比簡報檔還更容易讓客戶理解。因為透過心智圖的形式，整件事情的邏輯，會比一頁頁簡報檔更容易呈現出來讓讀者知道。當然這也有可能是我簡報檔寫太差的原因就是了 XD

XMind 同時有 Windows 和 Mac 版，我都是透過 Dropbox 做為兩個平台上筆記同步的機制。有時候外出帶 MacBook Pro 出去和客戶開會，使用 XMind 做的會議記錄檔，就直接放在 Dropbox 上。回到公司打開公司電腦就可以接著再繼續編輯或瀏覽，很方便。

Evernote 則是在記錄學習筆記和專案文件內容上，我覺得很好用。我目前在學習上，常常是利用 Evernote 將一些網頁資訊先亂貼進去，再使用 XMind 將這些雜亂的資訊，做進一步的整理，理清一下脈絡。等到覺得似乎夠清楚了，再試著將整理完的資訊，以比較有條理的敘述方式，寫進去 Evernote 中。等到覺得又更完整了，再騰到公司內部的 wiki 上。

在撰寫專案的一些文件時，最近也想試行看看，可不可以採用這樣的做法。因為我常常覺得，直接和 Word 直球對決，往往會寫不出東西來。Word 格式化的東西太多太雜，反而會是阻礙思考的雜訊。不如就真的把它拿來當「文書處理軟體」，等「文書」內容都透過 Evernote 等方式大概都準備好了，再專心用 Word 來「處理」它的排版就好 XD`

Evernote 在 Windows、Mac、Android 下都有對應的平台軟體，因為它本來就號稱是雲端記事本，所以在同步上就更加簡單，不需要透過 Dropbox。而且因為有手機版，其實也很方便出門在外可以瀏覽 (寫就算了，太累了)。

小小做個記錄和省思，以後可以回來再看看。

Play Framework 有自己的 Log API，背後整合的 library 為 log4j library。

預設當我們想調整自己的 log 設定時，只需要在 Play Framework 專案的 conf 子目錄下，新增 log4j.properties 檔案即可。以下是我常用的設定檔內容︰

1
2
3
4
5
6
7
8
9
10
11
12
13

log4j.rootLogger=INFO, Rolling, Console
log4j.logger.play=DEBUG

# Console
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} %-5p ~ %m%n

# Rolling files
log4j.appender.Rolling=org.apache.log4j.RollingFileAppender
log4j.appender.Rolling.File=logs/application.log
log4j.appender.Rolling.layout=org.apache.log4j.PatternLayout
log4j.appender.Rolling.layout.ConversionPattern=%d{ABSOLUTE} %-5p ~ %m%n

主要是開發時，專案相關程式的部份使用 DEBUG log level，其他 library 為了不要出現過多訊息，則設定為 INFO log level。