Palm应用开发之三appinfo.json 文件详解

本系列目录：

1. Palm Web OS 简介
2. Palm 应用开发之一开发环境搭建
3. Palm 应用开发之二从Helloworld开始学习Palm开发

概述

应用程序的文件夹的根目录包含一个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"
}