phonegap安裝環境筆記

PhoneGap 是 Adobe 推出的行動應用開發框架，讓開發者用 HTML、CSS、JavaScript 撰寫跨平台 App。它的核心基於 Apache Cordova，PhoneGap 可以理解為 Cordova 加上 Adobe 雲端服務的版本。

注意：PhoneGap 已於 2020 年 10 月正式停止維護，Adobe 宣布終止支援。現今建議直接使用 Apache Cordova 或改用 React Native、Flutter 等現代框架。

PhoneGap 與 Cordova 的關係

• Apache Cordova：開源核心，由 Apache 基金會維護
• PhoneGap：Adobe 以 Cordova 為基礎加入雲端建置（PhoneGap Build）等服務
• 兩者 CLI 指令幾乎相同，Cordova 用 cordova，PhoneGap 用 phonegap

安裝流程

1. 安裝 Node.js

前往 nodejs.org 下載並安裝 LTS 版本，安裝後確認：

1
2

node -v
npm -v

2. 安裝 PhoneGap CLI

1

npm install -g phonegap

安裝完成後確認版本：

1

phonegap --version

3. 設定 Android 開發環境

1. 安裝 Java JDK，並設定 JAVA_HOME 環境變數
2. 安裝 Android Studio，包含 Android SDK
3. 設定 ANDROID_HOME 環境變數，指向 SDK 目錄，例如：

1

ANDROID_HOME=C:\Users\YourName\AppData\Local\Android\Sdk

4. 將以下路徑加入 PATH：

1
2

%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools

常用指令

建立新專案

1
2

phonegap create my-app com.example.myapp MyApp
cd my-app

參數說明：

• my-app：專案目錄名稱
• com.example.myapp：應用程式 ID（反向域名格式）
• MyApp：應用程式顯示名稱

本地開發伺服器

1

phonegap serve

執行後會啟動本地 HTTP 伺服器，可在手機上安裝 PhoneGap Developer App，輸入電腦 IP 位址即可即時預覽，不需要打包。

建置 App

1
2
3
4
5
6
7
8

# 新增 Android 平台
phonegap platform add android

# 建置 Android APK
phonegap build android

# 建置並安裝到已連接的裝置
phonegap run android

與現代框架的比較

如今若要進行跨平台行動開發，建議優先考慮 React Native 或 Flutter，兩者皆有更活躍的社群與更好的效能表現。

參考資料

• Apache Cordova 官方文件
• PhoneGap 停止服務公告