一、选择模板或自己建立用户库文件结构
想要建立自己的用户库可以选择官方提供的模板库(Arduino用户库模板、microPython用户库模板、实时模式用户库模板),在此基础上修改为自己需要的用户库;也可以自己按以下用户库文件结构从零构建属于自己的用户库(推荐使用模板库,不必重复造轮子)。
用户库文件结构:
用户库文件结构:
│— newExtensions // 项目名称
│— config.json // 本用户库的配置文件
│— LICENSE.TXT // 许可证说明
│— README.md // 文档说明
│— arduinoC // arduino模式用户库根目录
│— main.ts // 图形块描述文件
│— libraries // arduino库文件,列出本扩展库所有需要引用的.c或.h或.cpp文件;若没有则把此文件夹内容删除清空
│— qrcode.h
│— ...
│— _images // 图片文件
│— featured.png // MindPlus扩展库展示图片(600x372像素)
│— icon.svg // MindPlus中图形块上的图标文件
│— ...
│— _locales // 翻译文件,支持多国语言
│— zh-cn.json
│— en.json
│— ...
│— _menus // 下拉菜单参数,每个板子可以独立设置
│— leonardo.json
│— uno.json
│— nano.json
│— mega2560.json
│— microbit.json
│— mpython.json
│—
下载完官方提供的Arduino用户库模板后会得到一个.zip文件。解压后把总文件夹名字改为自己的项目名称(注:不要用中文和特殊符号),并删除其中的.mpext文件。
我的MindDHT11用户库文件结构如下:
二、配置config.json文件
详细说明:
name: 名称。模块显示在扩展库中的标题名称。
description: 描述。模块显示在扩展库中的描述。
author: 作者名。请使用英文字母表示。
email: 邮箱。当版本更新需要修改用户库或用户反馈,将通过邮件通知开发者(预留功能)
license: 许可证类型。参考链接
isBoard: 主控。当前扩展是否为主控(预留功能,统一为false)
id: 模块区分号。同一作者的不同模块需要设置不同的id,建议使用英文和数字符号命名。
platform: 支持平台。有三个选项:“win”, “mac”, “web”,分别表示Mind的windows桌面版,mac桌面版,网页版,当前仅支持win。
asset: 各模式配置。当前仅支持上传模式的arduino C模式。
dir: 指定模式路径。/不能遗漏,例如:“dir”: “arduinoC/”,不建议修改。
version: 版本信息。三个数字,从小到大,例如:“0.0.1”,建议每次发布都增加一位小数,依次从小到大增加(版本控制功能预留)。
board: 指定支持的主控,主控对应字段见下文“主控列表”。请确认测试通过后添加对应支持主控。若当前主控板不支持或模式不支持,则用户库右上角会显示“不可用”
main: block描述文件的文件名。需要是ts后缀文件,名称自定义,需要在对应路径下
注:若模板中有isTest字段和files字段,则把该两字段部分代码删除。因为从Mind+ 1.6.2RC2.0版本开始删除此两字段
{
"name": {
"zh-cn": "温湿度模块",
"en": "DHT11"
},
"description": {
"zh-cn": "DHT11数字温湿度传感器是一款含有已校准数字信号输出的温湿度复合传感器",
"en":