您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

PhoneGap / Cordova Android 專案的建立步驟

編輯:iOS 開發綜合

用 PhoneGap 做混合式 App,本質上是把一個網頁包裝成原生應用,並透過 JS Bridge 呼叫裝置能力。以 Cordova 2.9.0 為例,建立一個空的 Android 專案後依序做以下設定。

一、放好檔案

  1. 建立一個空的 Android 專案。
  2. 在 assets 下建立 www 資料夾。
  3. 到 PhoneGap 解壓目錄,把 cordova.js 複製到 www,把 cordova-2.9.0.jar 放進 libs。
  4. 把 xml 資料夾複製到 res 下(Cordova 用它存放 plugin 設定與 feature 宣告)。
  5. 在 www 下建立 index.html 作為入口頁。

二、改寫 Activity

讓你的 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。

三、修改 AndroidManifest.xml

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 下的實際檔名一致,錯一個字就是白畫面。
  • 別忘了 cordova.js 的版本要與 jar 相符。 版本不一致時 Bridge 會靜默失效,JS 呼叫沒有任何反應也不報錯,很難查。
  • 本機檔案的限制。 從 file:// 載入的頁面在ajax請求外部網域時會遇到同源政策問題,需在 res/xml/config.xml 的 whitelist 中放行網域。
  • 版本差異。 Cordova 3.0 之後專案結構改為 command-line 建立(cordova create),不再需要手動搬 jar 與 xml。若你在開新專案,建議直接學新版 CLI 流程,上面這套手動步驟主要用於理解原理或維護舊專案。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved