PhoneGap(後來的 Apache Cordova)讓你用 HTML、CSS、JavaScript 寫一次,就能包成手機 App。以 Android 為例,整個流程其實就是「建立一個空專案 → 放入 Cordova 的 runtime 與你的網頁 → 讓 Activity 改載本地 HTML → 補上權限」。以下依序說明。
先用你慣用的工具建一個乾淨的 Android Project,後續所有動作都在這個骨架上進行。
Android 應用有個 assets 目錄,其中的檔案會原封不動被打進 APK,並可透過 file:///android_asset/ 這個特殊 URL 存取。Cordova 的網頁內容就放在這裡的 www 子目錄。
cordova.js 複製到 www 資料夾底下。cordova-2.9.0.jar 放進專案的 libs 目錄。把 Cordova 發行包中的 xml 資料夾複製到專案的 res 目錄下。這裡放的是 Cordova 的設定檔(如 config.xml),用來宣告 plugins 與白名單,缺少它很多 API 會失效。
在 www 資料夾中新增 index.html,這就是 App 啟動後看到的第一個畫面。別忘了在頁面中引入 cordova.js。
讓你的 Activity 繼承 DroidGap,並用 super.loadUrl 取代原本的 setContentView:
1、import org.apache.cordova.DroidGap;
2、class 宣告改為 extends DroidGap
3、以 super.loadUrl("file:///android_asset/www/index.html");
取代 setContentView();
DroidGap 本質上是一個內建 WebView 的 Activity,它負責把 Cordova 的 JavaScript 橋接建立起來,讓你的網頁能呼叫相機、GPS 等原生能力。
1. 支援多種螢幕密度
<supports-screens
android:largeScreens="true"
android:normalScreens="true"
android:smallScreens="true"
android:resizeable="true"
android:anyDensity="true" />
2. 補齊所需權限(依你的功能取用,不需要的請自行刪除,權限越多上架審核越容易被質疑)
<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" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" /> <uses-permission android:name="android.permission.BROADCAST_STICKY" />
3. Activity 加上 configChanges 屬性
這一步很重要:orientation|keyboardHidden 能讓旋轉螢幕與鍵盤彈出時 Activity 不被重建,否則 WebView 會重新載入,你的網頁狀態就全丟了。
4. 完整 Activity 宣告範例
<activity
android:name="org.apache.cordova.DroidGap"
android:label="@string/app_name"
android:configChanges="orientation|keyboardHidden">
<intent-filter></intent-filter>
</activity>
CordovaActivity,並透過 cordova-android 專案模板產生,不再需要手動搬 jar。完成以上七步,建置並安裝到裝置上,就能看到你的網頁以原生 App 的外殼跑起來了。