用 Sencha Touch 搭配 Phonegap 打包時,若把專案名稱設為中文,可能導致建置失敗。本文記錄問題成因與解法。
初始化專案時:
sencha phonegap init com.pushsoft.myapp MyApp
打包後,產生的安裝檔名為 MyApp.apk,手機桌面上顯示的程式名稱(圖示下方文字)也是 MyApp。
修改 MyApp/config.xml,把頂部的 <name>MyApp</name> 中間換成你要的名字即可。
注意編碼問題:如果 XML 內容含中文,必須把檔案存成 UTF-8 編碼。這裡指的是文字檔本身的編碼,不是檔案開頭那行 <?xml version='1.0' encoding='utf-8'?> 宣告。建議用 Notepad++ 透過「編碼 → 轉換為 UTF-8」功能處理。
如果把名稱改成例如「我的程序」這種全中文名稱,sencha app build native 會失敗(phonegap local build android 同樣失敗)。
圖一:專案名稱變成亂碼

圖二:編譯失敗

圖三:產生的 Android 專案中,Java 檔案沒有檔名

圖四:Java 檔案內容中也沒有類別名稱,因此編譯失敗
根本原因:產生的 Java 檔名與類別名稱直接來自 config.xml 中 <name> 的值。Cordova/Phonegap 對中文的支援不佳,於是生成了空的類別名,Java 編譯器自然無法通過。
開啟:
C:\Users\<用戶名>\.cordova\lib\android\cordova\3.4.0\bin\lib\create.js
找到處理專案名稱的那段程式碼(畫面中以紅框標示的部分):

把它改成類似下面的邏輯:

修正的作用是:如果 config.xml 中的名稱是英文,就用這個英文名稱;如果是全中文,就退回使用 CordovaExample 作為類別名稱。
如此一來,產生的安裝檔名是 CordovaExample.apk,而手機桌面上顯示的程式名稱(圖示下方文字)仍然是「我的程序」——因為顯示名稱與 Java 類別名是兩套不同的設定。
如果你不滿意 CordovaExample.apk 這個檔名,想改用其他方式命名(例如取包名 com.pushsoft.myapp 的最後一段作為 Myapp),可以參考下面的調整:

專案名稱保持純 ASCII。這是最省事的策略:把 config.xml 的 <name> 設為英文,需要顯示中文名稱時透過 Android 的 AndroidManifest.xml 中 android:label 指向 res/values-zh-rCN/strings.xml 的 app_name 資源來處理。這樣類別名與顯示名稱徹底分離,不會互相牽連。
直接改 AndroidManifest 與 strings.xml。打包完成後進入產生的 Android 專案,修改 res/values/strings.xml 的 app_name 即可變更桌面顯示名稱,完全支援中文且不影響編譯。缺點是每次重新打包都會被覆寫,需要寫成建置後腳本。
修改 create.js 是環境層級的 hack。這個方法有效,但改動的是 Cordova 安裝目錄中的檔案。一旦升級 Cordova 版本,修改就會消失,且團隊其他成員的環境不會同步。若專案需要長期維護,應改用 hook 機制(config.xml 中的 <hook>)把修正寫進專案本身。
版本相容性提醒。本文示範的是 Cordova 3.4.0 時代的行為。後續版本的 Android 建置流程已大幅改寫(改用 Gradle),中文名稱的處理方式也不同。若你使用的是新版 Cordova,請先確認問題是否仍存在,再決定要不要套用這類修改。