探索cordova項目前段時間增加了熱更新功能,自己第一次做的時候在網上查找了很多資料,有的資料寫的並不全面遇到了很多坑。因此總結一些在開發過程中遇到了問題和解決辦法。
這里不涉及app版本更新,只是熱更新。
web代碼的更新
此更新方式,只需要更新web前段代碼,不需要更新android的原生代碼。只是對js、html等的更新。
1、添加插件 Cordova Hot Code Push
cordova plugin add cordova-hot-code-push-plugin
2、添加熱更新工具 cordova-hot-code-push-cli
npm install -g cordova-hot-code-push-cli
3、添加cordova-hcp.json文件
此文件是用於方便生成www文件下chcp.json文件的內容。
執行命令(必須在項目根目錄執行更新工具的命令)
cordova-hcp init 生成熱更新相關配置文件
生成的默認應用程序配置文件(cordova-hcp.json)在項目根文件夾中。
執行時將要求您從命令行中填寫一些項目首選項:
- Project name: 你現在的項目名稱所需.
- Amazon S3 Bucket name:亞馬遜上的S3桶的名字。可以跳過。
- Amazon S3 region: 亞馬遜S3地區。可以跳過。
- iOS app identifier: 應用程序商店的應用程序ID。App升級是跳轉應用商店進行升級。
- Android app identifier: 可以App在應用商城的地址,或者是apk的下載地址。
- Update method: 何時執行更新。
- start: 在啟動應用程序時安裝更新。
- resume: 在恢復應用程序(從背景移動到前景狀態)或啟動時,安裝更新;默認使用。
- now: 從服務器加載更新后立即安裝。
cordova-hcp.json文件內容:
{
"name": "",//可為空 "autogenerated": true,//如果不添加,熱更新會不能使用 "ios_identifier": "id123456789",//應用在App store id(可為空) "android_identifier": "",//應用在應用商城上的地址或者App的下載地址(可為空) "update": "start",//在應用啟動時安裝 "min_native_interface": 1,//可用以做App升級(可以不填) "content_url": "http://************/cordova/www"//www文件在服務器上的地址 }
"autogenerated": true 這個值執行命令后是沒有的需要自己手動添加,如果不添加網頁內容更新將會無效。
4、在www文件下生成chcp.json 和 chcp.manifest文件
- chcp.json: 包含發布相關信息:熱更新代碼版本號,應用 native side 版本號等等
- chcp.manifest: 包含項目熱更新代碼(靜態)文件信息:文件名和文件哈希值
執行命令
cordova-hcp build
執行此命令會在chcp.json文件中增加"release":"當前時間"
字段。(默認使用時間戳,格式為:yyyy.MM.dd-HH.mm.ss),插件將版本號進行字符串相等比較來判斷是否存在新版本。
"release": "2017.06.07-16.30.20",//唯一web項目版本號,用與熱更新web內容的更新。(必需)
5、config.xml 配置
最好寫在底部方便以后配置修改
<chcp> <auto-download enabled="true" /> <auto-install enabled="true" /> <native-interface version="1" /> <config-file url="https://************/cordova/www/chcp.json" /> </chcp>
- config-file:配置文件 chcp.json 從服務器上加載的路徑(必須的配置項)
- auto-download:是否自動下載熱更新代碼,默認是 true
- auto-install:是否自動安裝熱更新代碼,默認是 true
- native-interface:當前 native side 的版本號
6、將打包具有熱更新功能的sdk
運行cordova build android生成具有熱更行功能的安卓app安裝包。
7、測試熱更新
這一步我是直接將項目更改后的的www文件夾放到服務器上,在cordova項目根目錄運行 cordova-hcp build, 然后重啟app,就可實現App的web內容代碼的熱更新了。需要注意的是www文件在服務地地址一定要與"content_url":"http://************/cordova/www"
和config.xml中<config-file url="https://************/cordova/www/chcp.json" />
填寫的地址一致。