前言
上一篇入门到放弃讲到创建项目,这次记录一下做插件需要注意的几个关键点,以及项目文件的介绍。
文件准备
创建完项目后,可以看到下面这几个文件

其中main.blocks这个文件是需要删掉的。点击右边的垃圾桶图标,将这个文件删掉。
main.ts文件是写代码的主要地方,大多数人都把代码放在这里,也有特殊的,像DFRobot家的Maqueen,新建了一个maqueen.ts,并且把代码放在了这里。(至于怎么做到的,还没仔细研究,先插个旗子,等以后有时间看看)
test.ts文件是测试文件,提交的时候必须要这个文件存在。根据官方的说法,如果你想定期测试TypeScript API,不再需要新建项目,导入插件这么复杂的步骤,项目中有使用这个API的代码,您不需要一个单独的测试项目即可,该项目中包含可以使用这些API的代码。
To test TypeScript APIs regularly, you don’t need to have a separate test project available that has code to exercise the APIs. Instead, you include a test.ts file in the extension itself which contains the tests. This file is only used when you run the extension directly, not when you add the extension to a project. The tests you create are valid code that use your extension APIs.
pxt.json是整个项目的配置文件,里面包含了项目名称,项目描述,所需依赖,以及项目里所有文件,测试文件,支持的平台
{
"name": "blog-test", //这里是项目名字
"description": "", //这里写上项目的描述
"dependencies": { //这里是这个项目的依赖库,引用了什么库可以在这里加上,当然如果不需要的库也可以删掉。如果你的库有用到蓝牙,那么你需要把radio删掉,因为这两个库有引脚冲突
"core": "*",
"radio": "*",
"microphone": "*"
},
"files": [ //files这里是所有文件的索引,相当于一个目录,导入项目时会加载这些文件。
"main.ts",
"README.md"
],
"testFiles": [ //test.ts是测试文件,用于快捷测试插件
"test.ts"
],
"supportedTargets": [ //适用平台,microbit
"microbit"
],
"preferredEditor": "tsprj"
}
README.md是项目的介绍,这个文件是自动生成的,这里需要注意,有些内容是需要删掉的。大球在申请插件过程中也踩到了坑
1、申请需要不在Beta版本,不然不通过(这里有点坑,因为官方说的是,如果你的插件是Beta版本,你需要标记)
The extension is in a finished state. Extensions that are in development should be marked ‘beta’ in the repository description.
2、有些内容是需要删掉的。

另外,在_locales文件夹下面是本地化的文件,例如:_locales/zh/blog-test-strings.json,如果切换为其他语言,会自动创建,只需要把相关的关键词替换就能实现各种语言切换了
参考链接
pxt.json介绍:https://makecode.com/extensions/pxt-json
测试插件的介绍:https://maker.makecode.com/github/test-extension




暂无评论