摘要：系統(tǒng)在初始化時(shí)，會加載所有，然后分別在和生成對應(yīng)的。那么在中，又是如何將上述的生成為開發(fā)者直接使用的接口的呢下面就為大家介紹我們引入的。它接受一個(gè)對象，然后會遍歷原型鏈中的對象，并且分別按照和去生成一個(gè)叫的對象，最后將這個(gè)對象返回給開發(fā)者。

在 Node.js 社區(qū)中，其實(shí)不乏通過 Markdown 生成 RESTful API 的框架，按照一定的格式約定好 API 所需要的數(shù)據(jù)，然后再通過解析 Markdown 文檔，將這些關(guān)鍵數(shù)據(jù)提取出來，最后生成數(shù)據(jù)庫模型和 HTTPS 服務(wù)。

YodaOS 作為一個(gè)前端操作系統(tǒng)，同樣使用了類似的技術(shù)。YodaOS 中的應(yīng)用分為：lightapp 和 extapp，前者是集成在語音交互運(yùn)行時(shí)（Vui-daemon）進(jìn)程內(nèi)部的輕應(yīng)用，它主要是用于一個(gè)交互簡單，需要快速響應(yīng)的場景，比如音量控制、系統(tǒng)控制等。后者作為一個(gè)獨(dú)立的進(jìn)程，通過 Child Process 與主進(jìn)程通訊，使用場景主要是音樂、游戲、電話等需要長時(shí)期使用的應(yīng)用。

為什么要有輕應(yīng)用？輕應(yīng)用更像是一個(gè)腳本，每當(dāng)用戶一次進(jìn)行一次交互，只需要從預(yù)先加載的腳本中調(diào)用定義在對應(yīng)腳本的函數(shù)即可完成一次響應(yīng)，往往這類應(yīng)用交互比較簡單，如果為此要?jiǎng)?chuàng)建在每次交互的過程中進(jìn)行一次
ipc 甚至 fork 時(shí)，無論對性能還是內(nèi)存來說，都是比較浪費(fèi)的。

在設(shè)計(jì)之初，我們期望對于開發(fā)者來說，并不需要針對不同類型的應(yīng)用，只需要在 package.json 中修改類型即可，YodaOS API 應(yīng)當(dāng)保持完全一致。這樣的話，我們則面對一個(gè)問題，即使是能做到高度抽象，也需要在每次新增一個(gè)接口時(shí)，修改兩處代碼，這其實(shí)是有違我們的設(shè)計(jì)初衷的。

**

**

為此，我們引入了 API Descriptor 的概念：https://github.com/yodaos-pro...?？梢园阉醋魇怯?JavaScript 寫的 DSL，它用于描述每個(gè) YodaOS API，包括命名空間、事件、方法等定義。系統(tǒng)在初始化時(shí)，會加載所有 API Descriptor，然后分別在 lightapp 和 extapp 生成對應(yīng)的 API。

Object.assign(ActivityDescriptor.prototype,
{

/**
 * When the app is active.
 * @event yodaRT.activity.Activity#active
 */
active: {
  type: "event"
},
/**
 * When the Activity API is ready.
 * @event yodaRT.activity.Activity#ready
 */
ready: {
  type: "event"
},
/**
 * When an activity is created.
 * @event yodaRT.activity.Activity#create
 */
created: {
  type: "event"
}

}
)
上面的代碼分別定義了 Activity 中的幾個(gè)事件：active、ready 和 create。因此，在任何應(yīng)用中都可以這樣寫：

module.exports = activity => {
activity.on("active", () => console.log("app activated"))
activity.on("ready", () => console.log("app is ready"))
activity.on("created", () => console.log("app is created"))
}
接下來我們再看看“方法”是如何定義：

Object.assign(ActivityDescriptor.prototype,
{

/**
 * Get all properties, it contains the following fields:
 * - `deviceId` the device id.
 * - `deviceTypeId` the device type id.
 * - `key` the cloud key.
 * - `secret` the cloud secret.
 * - `masterId` the userId or masterId.
 *
 * @memberof yodaRT.activity.Activity
 * @instance
 * @function get
 * @returns {Promise