Single

MakeCode For Micro:Bit插件设计从入门到放弃(三)–逐渐入门

前言

前面简单说了下整个工程的文件,这篇文章主要说说main.ts的结构

namespace

main.ts这个文件是makecode的程序的内容,其中namespace是主要框架

namespace test {
    ...
}

namespace的作用就是为了防止名字冲突,比如一个学校有两个小白的时候,为了区分他们,我们在他们的名字前面可能会加上8班小白,9班小白,或者小8白,小9白等等。namespace定义了标识符的可见范围(标识符指的是程序中元素的名称,例如变量,函数等等)一个标识符可以在多个namespace中定义,并且互不影响。
同时,在namespace中,可以使用JSDoc进行注释(关于JSDoc的介绍,可以看这里),对积木的颜色,权重,logo等等进行设置。

/**
 * Provides access to basic micro:bit functionality.
 */
//% color=190 weight=100 icon="\uf1b9" block="Basic Blocks"
namespace test {
    ...
}

color 这个参数应包含在以//%开头的注释行中。 该颜色采用色相值或HTML颜色。
weight 这个参数定义的是权重,权重确定了这个插件在左边工具栏中的位置,权重越高在工具栏中越靠上。
block 这个参数是定义插件的名字。
icon 这个参数可以自定义你的插件图标,具体图标列表可以在http://fontawesome.io/icons/这个网站找到(如下图)搜索之后打开页面,将箭头指的地方就替换进去,即\u****

另外,如果你想让插件显示在下面advanced里面,需要在注释下面添加advanced=true。

/**
 * Provides access to basic micro:bit functionality.
 */
//% color=190 weight=100 icon="\uf1b9" block="Basic Blocks" advanced=true
namespace test {
    ...
}

最终效果如下图:

积木分组

如果你想将扩展中的插件按功能分组,可以在注释那里添加一行以下代码(例如calculator、serial、others三个分组)

//% groups=['calculator', 'serial', 'others']

并在下面各个插件的注释中添加分组名字

//% group="serial"

最终代码如下:

/**
 * pxt extension test
 */
//% color=190 weight=100 icon="\uf1b9" block="Test Blocks"  advanced=true
//% groups=['calculator', 'serial', 'others']
namespace test {
    /**
    * Calculate the addition and return
    */
    //% group="calculator"
    //% blockId="Additioncalculation" block="the result of %length plus %width"
    //% blockGap=2 weight=0 blockExternalInputs=true
    export function Additioncalculation(length: number, width:number): number {
        return length+width
    }
    /**
    * Calculate the addition and return
    */
    //% group="serial"
    //% blockId="Multiplicationcalculation" block="the result of %length times %width"
    //% blockGap=2 weight=0 blockExternalInputs=true
    export function Multiplicationcalculation(length: number, width:number): void {
        serial.writeNumber(length*width) 
    }
}

代码效果如下:

积木类别

积木大概分为两个类型,一个有输出的,一个没有输出的,可以参考上文中的代码,如果箭头指向的地方用的是void则是没有返回值的积木,用的是number则会生成有返回值的积木(具体代码效果可以看上面截图,这里就不重复放了)

参考链接

Defining blocks

如何製作makecode裡的micro:bit積木

暂无评论

发表评论

zh_CNChinese