每一个 YodaOS 应用都需要存在一个 package.json 文件在应用根目录。这个 package.json 文件描述了一些关于应用的必要信息。

这个 package.json 必须声明以下信息：

• 应用的包名。
• 应用的域名。

接下来几节就会详细叙述应用开发中几个重要的部分是如何反映到 Manifest 中去的。

包名与域名

应用如果希望接收 Url 事件并与外部组件通信，Url 域名是一个必不可少的元素，为了将一个 Url 与应用关联起来，需要在应用的 package.json 中填写 manifest.hosts 字段，如下例子：

{
  "name": "com.company.example.awesome-app",
  "manifest": {
    "hosts": [
      "an-awesome-host"
    ]
  }
}

Manifest 元素参考

name

<string> Required

一个应用的本地唯一名称就是他的 name 字段。

一些规则：

• 包名可能会作为 Url 的一部分，或者作为一个命令行的参数，或者一个文件夹的名字。因此，这个名字不能包含任何 Url 不安全的字符；
• 不能使用 Node.js 的核心模块名作为包名。

main

<string> Default: index.js

代表了应用的默认启动入口文件。YodaOS 会使用这个入口文件启动应用。默认使用应用根目录的 index.js。

manifest.hosts

<array> Default: []

代表了应用能处理的 yoda-app 的域名。YodaOS 应用可以使用 API 如 Application#openUrl 来打开一个如 yoda-app://an-app-registered-host/path/to/resources 的 Url，并通过 Url 参数将希望传递的参数发送给能够处理这个 Url 的应用。而一个应用如果希望 YodaOS 将一个域名的 Url 代理给自己，则需要在 package.json 中注册这个域名。

manifest.hosts 字段需要是一个数组，这个数组的元素都是第一位是域名、第二位是可选的域名参数的元组。

Example:

{
  "manifest": {
    "hosts": [
      "example.app"
    ]
  }
}

manifest.daemon

<boolean> Default: false

如果应用希望在 YodaOS 一准备好就立刻启动，而不是等到用户希望使用时在启动；并且在意外崩溃时能够得到保护、快速重新启动，就需要将 manifest.daemon 选项设置为 true。

Example:

{
  "manifest": {
    "daemon": true
  }
}