6.1 上传代码

在“上传模式”下慧编程会将工作区(workspace)转为 python / c /javascript 语言,并由用户主动上传到硬件设备上。

配置转码语言

配置 Python 的转码模板

# generated by mBlock5 for <product>
# codes make you happy

### import #$$
### lib #$$
###
# initialize variables
###{
  if (this.$VARIABLES.length !== 0) {
    this.$VARIABLES.map(n => n + '= 0').join('\n')
  }
}#$$
#$$

### code #$$

这份模板声明了最终转码的样式,你可以在代码对照区看到实际发生的转码:

模板的结构

### ??? 表示一个模板样式,比如:

  • ### import #$$ 表示了这里将会实例成 import字段
  • ### code #$$ 表示了这里将会实例成 code 字段

对应每个块 上传转码 配置

如果有多个块拥有同一个字段,转码过程中,会将同一个字段的多个值进行全并,如下:

import = 积木块A的 import 字段 + 积木块B的 import 字段...

这个过程叫做 转码器,通常来说,你不需要修改转码器默认实现,但不符合预期时,可以在 转码设置/转码器 里进行配置。如下为 Python 示例:

转码模板说明

转码模板指的是将参数(占位符)嵌入到模板字符串中,运行时刻生成实际代码。在扩展设计器里存在两类模板。

  • 积木块模板
  • 代码框架模板

积木块模板

用于生成一个积木块的代码,如codey的 当按下按钮(A)

@event.button_{BUTTONS}_pressed
def on_button_{BUTTONS}_pressed{$INDEX}():
    {$BRANCH}

这里 BUTTONS 为该积木块配置的参数名,{BUTTONS} 会替换成该积木块实际的参数值。

积木块模板语法说明:

  1. template 可以是 一般参数:如 {args_1}
  2. template 可以嵌套: 如 {i am {args_1} }, 求值策略为,如果 args_1“somebody",该模板会实例化为"i am somebody" ,如果为空,整体代码生成为空 ("")
  3. template 可以嵌入 Javascript 代码, 规则为 { ... }+right, 无空格,例: {{ console.log('log'), 123 }}, 打印后,求值为123

下面是例子:

如果积木块的的实际参数如下:

  • name: move
  • speed: 50
  • time: 10

模板转码规则如下:

  • {name}() 将翻译成 move()
  • {name}({speed}, {time} ) 将翻译成 move(50, 10)
  • { {name} } 将翻译成 move // 模板内的模板,先求值内部模板,(注意这里有空格)
  • {no_exist} 将翻译成 //因为该模板变量不存在
  • { time: {time} } 将翻译成 time: 10 //模板内的模板
  • { time: {no_exist} } 将翻译成 //模板内的模板如果未赋值, 外部模板求值 为空
  • { {no_exist} } 将翻译成 //模板内的模板如果未赋值, 外部模板求值 为空(注意空格)
  • asdf 将翻译成 asdf //表示模板里的js表达式
  • 3 将翻译成 3 //表示模板里的js表达式

另外,设计器提供了一些”伪参数“,这些伪参数有特别的意义:

  • $INDEX :(适用于帽子块)同一类型积木块的序号,例子:
def on_start{$INDEX}():,  
第一次转换时生成 def on_start(): 
第二次转换成生成 def on_start1():
  • $BRANCH : 指带帽子头以下代码生成,例子:
def on_start():

    {$BRANCH}

将会替换该块以下的代码生成

def on_start():

    code1

    code2

    ...
  • $ALL_VARIABLES: 慧编程的变量(VARIABLES), 例子如下:
如果创建了变量 va, vb

{{ "global" + $ALL_VARIABLES.join(', ') }}  //javascript 模板

将会生成

global va, vb

代码框架模板

整体代码结构的模板,如:

# generated by mBlock5 for codey
# codes make you happy
from codey import *
from rocky import *
### import #$$
### lib #$$
###
# initialize variables
###{
    (this.$ALL_VARIABLES.length !== 0)? this.$ALL_VARIABLES.map(n=> n + ' = 0').join('\n'):undefined
}#$$
#$$

### code #$$
while True:
    # every tick
    ### loop #$$
#$$
字段模板

在框架里的 import lib code, 为在设计器里需要配置的字段, (### 为模板左括号, #$$ 为模板右括号)

Javascript 模板
###{
(this.$ALL_VARIABLES.length !== 0)? this.$ALL_VARIABLES.map(n=> n + ' = 0').join('\n'):undefined
}#$$ // 这里javascript求值后回的字串在此占位
嵌套模板
###
while True:
    # every tick
    ### loop #$$
#$$
// 当嵌入的字段(这里是loop) 存在值时, 整体代码会生成,loop字段为空时,从while起始的整体代码段不生成

附录一:默认的代码框架模板

Arduino C:

// generated by mBlock5 for <your product>
// codes make you happy

//( include //)
//( lib //)
//( declare //)
//(
void setup() {

    //( code //)
}
//)

//(
void loop() {
    //( loop //)
}
//)

Python:

# generated by mBlock5 for <your product>
# codes make you happy
from codey import *
### import #$$
### lib #$$
###
# initialize variables
###{
    (this.$ALL_VARIABLES.length !== 0)? this.$ALL_VARIABLES.map(function(n){return n + ' = 0'}).join('\n'):undefined
}#$$
#$$

### code #$$
###
while True:
    # every tick
    ### loop #$$
#$$

附录二:变量转码模板

涉及积木块的变量(VARIABLE) ,提供模板参考如下,

data_variable

{{this.getSafeName(this.VARIABLE)}}

data_setvariableto

{{this.getSafeName(this.VARIABLE)}} = {VALUE}

data_changevariableby

{{this.getSafeName(this.VARIABLE)}} = {{this.getSafeName(this.VARIABLE)}} + {VALUE}

results matching ""

    No results matching ""