open-index/open-npm huggingface dataset:
npm package: @sumor/app
Description: 轻呈云应用框架
Latest version: 17.1.4
Deprecated: SUNSET

# @sumor/app
轻呈云应用框架

## 安装

通过 [npm](https://www.npmjs.com/) 安装:
```sh
$ npm install --save @sumor/app
```

## 使用说明

ES6方式
```js
//例如要访问的程序路径为level1.level2.level3
import {level1} from '@sumor/app';

level1.level2.level3('parameter1');
```
Node.js CommonJS方式
```js
//例如要访问的程序路径为level1.level2.level3
const {level1} = require('@sumor/app');

level1.level2.level3('parameter1');
```

## 构建应用示例
```javascript
const {App} = require("@sumor/app");
const app = new App();
app.handle({
    _meta:{
        program:{
            "api.demo":{}// 参照实体定义
        }
    },
    api:{
        demo:(parameters,context)=>{
            return parameters.p1;
        }
    }
});
app.serve();
// 然后您就可以通过运行提示访问您的应用了
```

## 事件增强

### 全局事件
#### serve
启动服务后事件，可初始化全局变量等

### 会话事件
#### context 
交互上下文处理事件，可藉由此拓展上下文内容
#### error 
错误处理，用于拓展错误发生处理额外的操作，如数据库回滚


## SSL 临时证书设置
在开发阶段，如您无法提供有效证书，将会自动生成临时证书。 
临时证书是不被浏览器信任的，需要按照以下步骤完成证书启用，以达到调试目的。
请注意，该方案仅使用于本地测试环境，请勿用于正式用途

### 1. 下载证书
#### windows用户
可跳过该步骤
#### macOS用户
* 打开浏览器访问测试站点
* 右键菜单中选中检查按钮```inspect```或点击键盘F12
* 选中安全页签```Security```
* 点击查看证书```View certificate```
* 拖拽证书图标到本地即可下载证书（大的证书图标）
* 双击本地文件打开该证书
* 在自动打开的证书列表中找到该证书并右键打开简介
* 选择信任页签```Trust```
* 下拉框中选中始终信任
* 刷新浏览器测试站点页面

### 2. 允许使用临时证书
* 打开测试站点
* 点击```高级```
* 点击```继续前往XXX（不安全）```


## 接口文档

### new App(path) 轻呈云应用
构建轻呈云应用
###### 类型
类
###### 参数
* `path` __应用目录__