Palm應用開發之三appinfo.json 文件詳解

概述

應用程序的文件夾的根目錄包含一個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/
本文版權歸作者和博客園共有,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文連接,否則保留追究法律責任的權利。


 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章