您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

PhoneGap 目錄:把網頁專案包成 Android App 的完整設定步驟

編輯:iOS 相關資訊

PhoneGap(後來的 Apache Cordova)讓你用 HTML、CSS、JavaScript 寫一次,就能包成手機 App。以 Android 為例,整個流程其實就是「建立一個空專案 → 放入 Cordova 的 runtime 與你的網頁 → 讓 Activity 改載本地 HTML → 補上權限」。以下依序說明。

步驟一:建立空的 Android 專案

先用你慣用的工具建一個乾淨的 Android Project,後續所有動作都在這個骨架上進行。

步驟二:在 assets 下建立 www 資料夾

Android 應用有個 assets 目錄,其中的檔案會原封不動被打進 APK,並可透過 file:///android_asset/ 這個特殊 URL 存取。Cordova 的網頁內容就放在這裡的 www 子目錄。

步驟三:拷入 Cordova 檔案

  • 將 cordova.js 複製到 www 資料夾底下。
  • 將 cordova-2.9.0.jar 放進專案的 libs 目錄。

步驟四:拷入 xml 資料夾

把 Cordova 發行包中的 xml 資料夾複製到專案的 res 目錄下。這裡放的是 Cordova 的設定檔(如 config.xml),用來宣告 plugins 與白名單,缺少它很多 API 會失效。

步驟五:建立入口頁面

在 www 資料夾中新增 index.html,這就是 App 啟動後看到的第一個畫面。別忘了在頁面中引入 cordova.js。

步驟六:改寫 Activity

讓你的 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 等原生能力。

步驟七:修改 AndroidManifest.xml

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>

幾個實務提醒

  • 以上以 Cordova 2.9.0 為例,屬於舊版寫法。新版 Cordova 已改用 Gradle 建置與 CordovaActivity,並透過 cordova-android 專案模板產生,不再需要手動搬 jar。
  • Android 6.0 以上採執行期權限模型,相機、定位、麥克風等危險權限必須在執行時動態向使用者申請,光在 Manifest 宣告是不夠的。
  • 若網頁需要對外連線,記得在 Cordova 的白名單設定中放行網域,預設是禁止的。
  • 混合式 App 的效能瓶頸多半在 WebView,大量 DOM 操作與列表捲動建議改用前端框架的虛擬化清單,而非硬塞整份 HTML。

完成以上七步,建置並安裝到裝置上,就能看到你的網頁以原生 App 的外殼跑起來了。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved