用 PhoneGap 做混合式 App,本質上是把一個網頁包裝成原生應用,並透過 JS Bridge 呼叫裝置能力。以 Cordova 2.9.0 為例,建立一個空的 Android 專案後依序做以下設定。
assets 下建立 www 資料夾。cordova.js 複製到 www,把 cordova-2.9.0.jar 放進 libs。xml 資料夾複製到 res 下(Cordova 用它存放 plugin 設定與 feature 宣告)。www 下建立 index.html 作為入口頁。讓你的 Activity 繼承 DroidGap,並用 loadUrl 取代原本的 setContentView:
import org.apache.cordova.DroidGap;
public class MainActivity extends DroidGap {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
super.loadUrl("file:///android_asset/www/index.html");
}
}
記得 cordova-2.9.0.jar 要出現在 Build Path 中,否則會找不到 DroidGap。
1. 支援多種螢幕密度:
<supports-screens
android:largeScreens="true"
android:normalScreens="true"
android:smallScreens="true"
android:resizeable="true"
android:anyDensity="true" />
2. 加入所需權限。 混合式 App 用到的裝置能力都要在這裡宣告,不需要的請自行刪減——權限開越少,上架審核越順利:
<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 變化的話,螢幕旋轉時 Activity 會被重建,網頁會重新載入,填到一半的表單就全丟了。
<activity
android:name=".MainActivity"
android:label="@string/app_name"
android:configChanges="orientation|keyboardHidden|screenSize">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
loadUrl 裡的路徑必須與 assets/www 下的實際檔名一致,錯一個字就是白畫面。file:// 載入的頁面在ajax請求外部網域時會遇到同源政策問題,需在 res/xml/config.xml 的 whitelist 中放行網域。cordova create),不再需要手動搬 jar 與 xml。若你在開新專案,建議直接學新版 CLI 流程,上面這套手動步驟主要用於理解原理或維護舊專案。