概述
應用程序的文件夾的根目錄包含一個appinfo.json文件。這個文件包含了一個javascript的json對象。如果應用程序 是一個多語言版本的程序,那麼每種語言都需要配置一個自己的本地化的appinfo.json。但是,應用程序的標題和版本號都必須和頂層 appinfo.json相同。如果應用程序的標題和版本號和頂層結構或者值不一樣的話,這個應用程序就不能打包安裝,這在做多語言版本的應用程序中是非 常重要的。
appinfo.json的語法說明:
*這個文件中不能包含任何的註釋性的文字,僅包含JSON對象。比如://或者是/* */都是不允許出現的,否則會出錯,使得應用程序不能正常安裝.
*JSON對象中的屬性和值必須要用雙引號("")括起來,不能使用單引號.
屬性詳解
appinfo.json屬性列表:
屬性名稱 |
是否可以選 |
描述 |
示例 |
icon |
可選 |
一個文件格式爲png,或gif的圖片文件的路徑字符串,路徑相對appinfo.json,它是應用程序在系統中顯示的圖標,默認是:icon.png |
如:"images/appIcon.png" |
id |
必須 |
這是應用程序的ID,每個應用程序都有一個ID,並且這個ID必須是唯一的,獨一無二的,它是應用程序的唯一標識,當應用程序安裝到系統上以後,啓動器設根據這個ID進行啓動和管理這個應用程序的,一旦應用發佈後這個ID就不能在修改了,如果改了就是一個新的程序 |
如:"com.palm.mycompany.weather" |
main |
必須 |
爲應用程序的入口點, 這是一個文件路徑相對於appinfo.json文件的html文件。默認值是:index.html |
如:"index.html" |
miniicon |
可選 |
用於通知時顯示的圖標,這是一個文件路徑相對於appinfo.json的圖片文件。默認值是miniicon.png |
如:"appnini-icon.png" |
noDeprecatedStyles |
可選 |
是一個bool值,如果設置爲true,會加載 global-deprecated.css文件 |
如:true |
noWindow |
可選 |
是否允許應用沒有菜單欄,是一個bool值 |
如:false |
theme |
可選 |
當設置爲"light"時dark css就不會加載了,這樣會使得加載快一些 |
如:"dark" |
title |
必須 |
這是應用程序的名稱,安裝後它會顯示在啓動器的應用程度圖標的下方,應用程度啓動後它是應用程度的標題,這個標題應該是唯一的否則會在啓動器中發生混淆,應用程度發佈以後就不能在該動這個名稱了 |
如:"天氣預報" |
type |
必須 |
標識應用程序的類型,默認設置是"web" |
如:"game" |
vendorurl |
可選 |
一個字符串,標識一個URL,一般開發商會將自己的網址下載這裏 |
如:"http://vaiyanzi.cnblogs.com" |
version |
必須 |
應用程序的版本號碼,格式...主要,次要,版本號都是強制性的非負整數 |
如:"1.0.12" |
這
個文件是一個全局參數的存儲器,它的參數傳遞給ApplicationService.launch()。該appinfo.json文件可以包含任何其
他有效的JSON開發人員認爲有用的信息,然後可以通過Mojo.Controller.appInfo訪問。例如,在電子郵件和日曆應用程序使用此屬性
來指定lwStages他們傳遞給createStageWithCallback()來確定是否要啓動一個新的"舞臺".
App ID
該appinfo.json文件給出了系統所需的信息,加載和啓動應用程序。最重要的屬性是ID,每個應用程序必須是唯一的。該ID是調 用其他應用的標識,也是爲其它應用提供服務是調用的唯一標識,因此appid保證唯一性是非常重要的。建議反向DNS命名約定,也可以使用其他的命名預 定,應用程序ID必須只包含小寫字母(a-z),數字(0-9),加號和減號和句點。
示例
下面是一個簡單的例子appinfo.json對象使用所需的字段和默認值。
{
"title": "MyApp",
"type": "web",
"main": "index.html",
"id": "com.yourdomain.app.myapp",
"version": "1.0.3",
"icon": "icon.png"
}
作者:藍之風
出處:http://www.cnblogs.com/vaiyanzi/
本文版權歸作者和博客園共有,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文連接,否則保留追究法律責任的權利。