@ham2k/ extension- sdk
写入扩展名 Ham2K 调试器 ——打入的钩子 合同和主机API的扩展是针对构建的.
npm install @ham2k/extension-sdk
npm install --save-dev @ham2k/extension-tools esbuild
import { defineExtension } from "@ham2k/extension-sdk"
import type { PanelHook } from "@ham2k/extension-sdk"
import manifest from "../manifest.json"
const HelloPanel: PanelHook = {
async getPanels() {
return [{ key: "hello", title: "Hello World", icon: "hand-wave-outline" }]
},
async render() {
return { kind: "markdown", content: "# Hello, World!" }
},
}
defineExtension({
...manifest,
onActivation({ registerHook }) {
registerHook("panel", { key: manifest.key, hook: HelloPanel })
},
})
一个面板返回 内容,而不是部件——这就是不让扩展到 应用程序的UI工具包.
npx -p @ham2k/extension-tools h2kext-init <yourcallsign>-<name> 写入
所有这一切和构建脚本;同一软件包将结果包成
.h2kext 应用程序可以安装.
参考文献在此包中
samples/ 每个形状都有一个工作过的扩展,即与
它需要的证书,一个颁奖程序,一个比赛及其计分器,一个HTML
显示面板。 每一个建筑和包; 每一个在标题中说它漏出的东西.
AGENTS.md 除了这个文件,还有地图—— 清单,沙盒的极限,
和哪一个 docs/ 回答什么问题. docs/ 保存文件本身:
正在启动, 扩展如何运行, 列表, 主机 API, 每个钩
类别、表格、设置面板、模板、包装和出版.
他们用包裹旅行,而不是被连接,所以可以读取
离线并描述安装在此的版本,而不是任何
仓库今天说。 如果代理正在写您的扩展名,请指向
node_modules/@ham2k/extension-sdk/AGENTS.md —— 说 h2kext-init 这样做是为了你.
版本数
小版本为扩展API:SDK 1.26描述API 26
以 API_VERSION。 。 。 . @ham2k/extension-tools 遵循同样的规则,
这样 ^1.19.0 范围表示扩展需要 API 19 并每晚承认一次
一个 一个主要的版本是打破已写入扩展的更改.
导出类型和设置
导出钩头可以注册共享类型 getExportTypes()启用
exportTypeDefinition(activationType, format, label) 为共享身份
为同一活动服务的延长. exportType 确定设置;
exportKey 识别单个文件,例如激活中的一个公园.
这个 activityExportHook 财务报告和审定财务报表 huntingExportHook 帮助者注册其类型
并转发到 ADIF 生成器。 参考活动类型
使用情况 templateCategory: 'reference';其他类型使用其他活动默认值.
GlobalExportSettings 提供单独的普通文件名、 紧凑的文件名,
和每个类别的标题模板,加上共享的 ADIF 字段模板.
在从 SDK 0.3 更新出口商时,保留特定参考标识符
内 exportKey,登记一个稳定 exportType和前进 exportSettings, (中文(简体) ),
exportData, (中文(简体) ), exportTitle,以及 includeLookupData 当授予世代.
每个类型的自定义模板仅在启用时才会覆盖所继承的默认值.
见 docs/import-export.md § 翻译:export 整个合同和 docs/forms.md
联 合 国 textTemplate 窗体字段.
关于同伴的依赖关系
这个软件包列出扩展主机携带的库—— @ham2k/lib-*, (中文(简体) ),
i18next, (中文(简体) ), liquidjs 作为 选项 同伴,你几乎肯定不会
需要安装任何它们.
您的扩展声明于 manifest.json 他们用哪一种
在主机的单个实例上将每个重写为查看
esbuilt 永远到达文件系统。 带主机上去是值得的
大约是捆绑大小的30倍 出版的种类都卷了起来
中,所以您的编辑器只安装了这个软件包.
只安装一个给 inline 运送自己的副本 因为你需要一个
版本的主机不携带.