預備環境
- iOS開發環境,Mac OS、XCode 7.2以上版本;
- 下載HBuilder離線打包iOS版SDK(5+ SDK下載)。
SDK目錄說明
- HBuilder-Hello:離線打包演示應用;
- Feature-iOS.xls:iOS平台各擴展Feature API對應的庫文件列表;
- Readme.txt:版本說明文件。
注意:HBuilder運行環境相關庫文件已全部包含在HBuilder-Hello演示應用中
配置編譯工程
- 從演示應用HBuilder-Hello創建工程
解壓SDK包,將演示應用HBuilder-Hello拷貝出來(可對目錄進行重命名),進入目錄,雙擊“HBuilder-Hello.xcodeproj”文件打開工程:

- 配置應用標識(Boundle Identifier)
選擇左側“Project Navigator”中應用工程根目錄,選中TARGETS下的HBuilder打開工程屬性界面,在General下修改Identity的值:
其中Bundle Identifier為蘋果的AppID,必須與應用發布是配置的Profile關聯的AppID一致;Version為應用版本號,在App Store中顯示的版本號,推薦與manifest.json中version下的name值一致;Build為編譯版本號,App Store判斷升級使用,推薦與manifest.json中version下的code值一致。
- 配置應用名稱
在工程屬性界面,切換到Info項下修改Bundle display name的值:
- 配置應用圖標和啟動界面
演示工程中已經配置好應用的圖標和啟動界面,只需要將對應圖片按照指定的分辨率拷貝到對應工程下的icon和splash目錄即可:
- 更新應用資源
注意:Pandora目錄為folder references引入方式,修改后不會自動更新,需要在模擬器或設備刪除應用后再重新運行 注意:拷貝到Pandora目錄的www目錄中manifest.json需要刪除注釋
打開pandora -> apps 目錄,將下面“HelloH5”目錄名稱修改為應用manifest.json中的id名稱(這步非常重要,否則會導致應用無法正常啟動),並將所有應用資源拷貝到其下的www目錄中:
- 配置應用信息
打開工程目錄下的control.xml文件,修改appid值:
其中appid值為HBuilder應用的appid,必須與應用manifest.json中的id值完全一致;appver為應用的版本號,用於應用 資源的升級,必須保持與manifest.json中的version -> name值完全一致;version值為應用基座版本號(plus.runtime.innerVersion返回的值),不要隨意修改。
- 配置應用使用的5+功能模塊(可選)
演示應用中已經引用HBuilder所有擴展的5+ API功能模塊,如果在應用中沒有使用到,為了減少發布時安裝包的大小可以刪除不使用的模塊。在工程屬性界面“Build Settings”下的“Linking”中找到“Other Linker Flags”:
雙擊彈出值列表:
在“Feature-iOS.xls”文件中查找不使用模塊對應的“LinkerFlags”,從列表中刪除。
如不使用“百度地圖”,則可選中“-llibMap”、“-lbmapimp”、“-lbaidumapapi”,通過列表左下角的減號刪除:
- 配置第三方庫的參數
如果用到使用第三方庫的功能模塊(如推送、分享、語音識別、統計),則需要通過“Feature-iOS.xls”文件中查找對應模塊的“Info”值,並在工程屬性界面“Info”下“Custom iOS Target Properties”中找到對應的項配置:
如百度地圖,需要配置在百度雲平台申請應用的appkey,找到“baidu”項下的“appkey”,雙擊后輸入正確的appkey值:
注意:新浪微博和微信分享還需要配置應用的URL Schemes,在“URL Types”項下分別輸入在各開放平台申請的值:
配置完成編譯運行
應用配置完畢,在模擬器上編譯運行應用:
正確編譯后啟動模擬器並運行:
Android平台請參考Android離線打包