[Eclipse] 暫時關閉排版功能 - formatter:off

相信各位都知道，Eclipse 可以利用快捷鍵 (Ctrl+shift+f 或是 command+shift+f) 幫助排版。但有時候它就是這麼的"假熬" (台)，反而破壞程式碼的可讀性！例如：

private static final String DATABASE_CREATE = "create table " 
      + TABLE_TOGO
      + "(" 
      + COLUMN_ID + " integer primary key autoincrement, " 
      + COLUMN_TITLE + " text not null, "
      + COLUMN_DESCRIPTION + " text not null" 
      + ");";

變成

private static final String DATABASE_CREATE = "create table " + TABLE_TOGO
      + "(" + COLUMN_ID + " integer primary key autoincrement, "
      + COLUMN_TITLE + " text not null, " + COLUMN_DESCRIPTION
      + " text not null" + ");";

真是糟糕透了！！！相信這個狀況大家都曾遇過，在下小弟我就提供一下解決方法囉！

開啟 Formatter

Window --> Preferences --> Java --> Code Style --> Formatter

預設的 Active profile 會是 "Eclipse [built-in]"，這時候點選右邊的 Edit ，並在跳出的視窗中，選擇 Off/On Tags

然後將 Enable Off/On tags 的選項勾起來，並且修改 Profile name 後，按下 OK 就可以了！

使用方式

使用方式很簡單，將程式碼的前後，分別用 @formatter:off 與 @formatter:on 的註解包起來就可以了，如下：

// @formatter:off
private static final String DATABASE_CREATE = "create table " 
      + TABLE_TOGO
      + "(" 
      + COLUMN_ID + " integer primary key autoincrement, " 
      + COLUMN_TITLE + " text not null, "
      + COLUMN_DESCRIPTION + " text not null" 
      + ");";
// @formatter:on

如此一來，就算使用自動整理，也不會被自作聰明的 Formatter 弄亂囉！

開始

與其思考著如何開始，不如

就這樣開始吧!

Android: Support Package

前情提要

一段時間沒有寫Android之後，就發現寫程式的感覺都開始生疏了。
不但如此，連寫個最簡單的 ListActivity 都得偷偷地上官網偷查一下 囧>

但上了官網查了一下 List View，才發現世界都大便變了！！！
居然多了個 CursorLoader！！！這是什麼玩意兒？？？

官網上面的說明是這樣的：

Although the CursorLoader APIs were first introduced in Android 3.0 (API level 11), they are also available in the Support Library so that your app may use them while supporting devices running Android 1.6 or higher.

懶得看英文的客官，容小弟我稍作解釋，
為了讓 Android 3.0 裡面新的API （其中包含剛剛介紹的CursorLoader），
能夠支援較舊版的 API level （目前支援到 API level 4，也就是 Android 1.6 以上）
，所以就有了 Support Library 來支援我們了！（救星啊！！！）

廢話少說，我們就來看怎麼下載與使用吧～

官方連結：http://developer.android.com/tools/extras/support-library.html

下載 Support Library

1. 打開 Android SDK Manager

如果是從 Eclipse 下載，就直接打開 Window > Android SDK Manager
不然就是直接找到下面位置打開：

• Windows: <sdk>/SDK Manager.exe
• Linux or Mac: <sdk>/tools/android

2. 打開 extras 資料夾，選擇安裝 Android Support Package

這部分有以下幾點要注意：

1. 更新 Android SDK

就我的部分來說，開啟 SDK Manager 之後發現，怎麼找都找不到 Support Package 的選項，所以就自作聰明的更新了 Android SDK

• Android SDK Tools: (Rev.) 19 --> 20
• Android SDK Platform-tools: (Rev.) 11 --> 12

更新完記得還要重新啟動 SDK Manager

2. 選擇 Support Library，Support Package 是找不到的

看樣子這部分應該是 Google 一個可愛的小錯誤

選擇圖中的 Android Support Library 並且安裝起來吧～

P.S. 甚至在網路上有看到 Android Capability Package 的，如果有人遇到的話就留意一下吧

設定 Package 路徑

雖然已經安裝好 Support Package 了，

但還是要為你的專案作設定才能開始使用這個 library 喔！

1. 新增資料夾

在專案下新增 libs 資料夾，如同 src 或 res 一樣放在專案目錄下。

2. 複製 library

在上面下載 package 的步驟中，就已經下載好 JAR 檔在你的系統裡了

<sdk>/extras/android/support/v<version>/android-support-v<version>.jar

複製在你系統這個位置下的 android-support-v4.jar 到你剛剛為專案新增的 libs 目錄下


(以我系統為例，我在 <sdk>/extras/android/support/ 下分別看到 v4, v7 還有 v13，
如果在專案上最低的Android API的設定是 4，也就是最低只支援到 Android 1.6 的專案，
則選擇 android-support-v4.jar)

3.  設定 Build Path

在 Eclipse 下，則對著 libs 下的 android-support-v4.jar 按下右鍵選擇 Build Path > Add to Build Path

噹啷！ 

恭喜您，經過這幾個小步驟，就可以順利的開始使用 Support Package 囉！

如果有需要知道實際的例子，請參考 <sdk>/extras/android/support/<version>/samples/ 下的各個範例吧！

希望有幫助到各位

另外，有錯的話，請鞭小力點 囧>