CHelper 网页接口 / JavaScript 接口文档

如果有不明白的地方，可以直接参考CHelper 网页版的内核对接方式。

编译内核（可选）

在CHelper 内核文档中已经包含了内核的编译步骤，你甚至可以根据需求定制化内核再进行编译。如果嫌麻烦或者实在不会编译，你也可以直接使用编译好的内核。

资源包生成（可选）

通过运行代码可以读取 json 文件生成更加利于程序读写的二进制文件资源包。如果嫌麻烦或者不会生成，你也可以直接使用生成好的资源包。

与 JavaScipt 代码交互

通过观察CHelper-Web这个项目，可以发现：在src/assets目录下，有 1 个wasm格式的文件是生成好的内核，6 个cpack格式的文件是生成好的资源包，你可以直接使用这些文件。在src/core目录下，libCHelperWeb.js用于加载wasm文件，并且提供了 js 的调用方式：

export class CHelperCore {
  constructor(cpack) {
    // 构造函数
  }

  release() {
    // 释放内存
  }

  onTextChanged(content, index) {
    // 文本改变事件
  }

  onSelectionChanged(index) {
    // 光标位置改变事件
  }

  getStructure() {
    // 获取命令结构
  }

  getDescription() {
    // 获取参数注释
  }

  getErrorReasons() {
    // 获取错误原因
  }

  getSuggestionSize() {
    // 获取补全提示数量
  }

  getSuggestion(which) {
    // 获取其中一个补全提示
  }

  getAllSuggestions() {
    // 获取所有补全提示
  }

  onSuggestionClick(which) {
    // 补全提示使用事件
  }

  getSyntaxTokens() {
    // 获取每个字符的token类型，用于语法高亮
  }
}

可以观察到这个类的构建函数需要传入资源包。在src/core目录下，CPackManager.js用于获取资源包并通过资源包初始化内核，其实现如下：

export async function getCore(branch) {
  let cpack = cpackCache[branch];
  if (cpack === undefined) {
    cpack = await fetch(getRealFileName(branch))
      .then((response) => response.arrayBuffer())
      .then(async (cpack) => {
        return new Uint8Array(cpack);
      });
    cpackCache[branch] = cpack;
  }
  await createWasmFuture;
  return new CHelperCore(cpack);
}

获取到内核后，即可去调用内核的各种接口了。需要注意的是，在内核要被销毁的时候，记得调用release()函数释放内存。