【Android學習筆記】你的第一支PhoneGap應用程式：Hello Inside!

[image credit : laihiu]

PhoneGap 是一個跨平台行動開發解決方案，它把行動網頁的介面包成像原生軟體一樣，在先前本站的 Richard 曾專文介紹過：請參閱：跨越行動網頁與原生軟體的隔閡 – PhoneGap，其中談到的例子是以 iPhone 為範例，今天筆者參照官網的教學範例，簡單的分享如何用 PhoneGap 在 Android 上開發一支 Hello Inside 程式。

首先，如果你還沒有安裝 Android SDK 和 Eclipse 的開發環境，請先參考：[Android 學習筆記] 開發環境建置。
接著請到 http://www.phonegap.com 下載最新版的 PhoneGap，並且解壓縮
打開你的 Eclipse，到 [Flie] -> [New] –> 新增一個 [Android Project]

並建立一個專案本文以 [helloinside] 為名稱，分別輸入專案的屬性為

Application name：helloinside

Package name：com.phonegap.helloinside

Create Activity：app

註：經筆者的測試，目前 PhoneGap 0.9.3 用 Android 2.3 以上版本會出錯，所以 Build Target 請選 Android 2.2 以下的版本。

解開你的 PhoneGap 資料夾，選擇 Android，裡面會有一個 phonegap.js 和 phonegap.jar 檔

接著在你建立 Android 的 workspace 的根目錄 ，新增二個目錄

/libs
/assets/www

把 phonegap.jar 複製到/libs 裡，而 phonegap.js 複製到/assets/www 裡

修改程式碼

在 Eclipse 裡展開專案，並點開 [src] –> [com.phonegap.helloinside] –> [app.java] 並執行以下步驟：

把 Class extends 名稱從 Activity 改成 DroidGap
把最後一行的 setContentView(R.layout.main); 改成 super.loadUrl(file:///android_asset/www/index.html);
在程式碼上方加入 Add import com.phonegap.*;

照理說現在程式碼裡會出現一堆錯誤訊息，別擔心，這是因為程式沒有抓到你剛複製進去的 phonegap.jar，右鍵點專案名稱，並 refresh 後

右鍵點選你剛複製進去的 libs/phonegap.jar，選擇 [Build Path」-> [Add to Bulid Path]

錯誤訊息就會消失了！

右鍵點選專案中的 AndroidManifest.xml，並選擇 Open With -> Text Editor，接著把以下的程式碼都複製到 android:versionName="1.0″> 後面

<supports-screens
android:largeScreens="true"
android:normalScreens="true"
android:smallScreens="true"
android:resizeable="true"
android:anyDensity="true"
/>
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

再把 android:configChanges="orientation|keyboardHidden" 加到 activity 裡的 android:label="@string/app_name" 的後面，如下圖：

存檔後，一個 phonegap 的開發環境就算完成了。

建立你的第一個 Phonegap 程式：Hello Inside

在 assets/www 裡新增一個名為 [index.html] 的空白檔案，把以下網頁程式碼複製進去，並存檔

<!DOCTYPE HTML>
<html>
<head>
<title>Hello Inside</title>
<script type="text/javascript" charset="utf-8″ src="phonegap.js"></script>
</head>
<body>
<h1>Hello Inside</h1>
</body>
</html>