查看: 197|回复: 2

小白制作图形库第一课 新建一个空白库

[复制链接]

12

主题

52

帖子

1133

积分

版主

Rank: 7Rank: 7Rank: 7

积分
1133
发表于 2024-4-7 07:39:38 | 显示全部楼层 |阅读模式
本帖最后由 libai500 于 2024-4-14 22:06 编辑

    时过境迁,岁月蹉跎,小白学习做图形库半年,学会了么?笔者观察,答案肯定是“否”。
    笔者写过两篇图形库制作教学贴,也深入学习总结过一些图形库的制作要领,笔者认为,光靠酣畅淋漓的图文介绍,根本无法让新手顺利上手制作图形库,甚至一上来就会崩溃。必须分课程,系统的,由浅入深的讲述做库要领和步骤。
    本文开始,我们就以课程形式,重新讲解图形库制作。
正文

第一节 清场

    两年来,笔者总结,天问图形库制作对于小白而言,第一障碍就是没有新建空白库的机制,一上来就是一个不确定的复杂页面。

image.png

    如上图,这个页面可能是上次做库的残余文档,也可以是一个意外的导入库,这种状况对于新手来说无疑是雪上加霜。因此我们开篇第一课,就是讲如何建立一个空白库。
    建立一个空白库,是图形库制作的第一课,也是小白做库重要基本技能之一。建立空白库,首先是进入扩展库制作画面,并清场。下面讲述进入库制作画面以及清场要领。
image.png

image.png

image.png

image.png
    如以上步骤,一通操作猛如虎,相信删除操作,对于新手不难。清场工作瞬间完成。
第二节 给图形块起个名字
    一个图形库中,可以有多个图形块,英文叫Block,刚才我们已经删除了所有的图形块。我们必须重新建立一个图形块,并为新图形块起一个合理规范的名字。
image.png
    如上图,我们清场后,库里一个图形块也没有,我们必须先为新图形块起个规范的名字,那么什么样的名字算是规范的呢?笔者经过半年总结,认为图形块名字规范化很重要。
    图形块名字必须包含图形库作者的代号,以及所属图形库的名字和图形块的名字。
image.png
    如上图,我们按照规范,编写了第一个库模块的块名字。因不支持中文,我们直接用汉语拼音平白直叙,我闷试用大小写遵守驼峰命名规则,并用下划线将作者名,库名和图形块名分开。即ZhangSan_KongKbaiKu_KongBaiKuai。
    在这里,我们再次重申命名规则的重要性,这个规则不但有助于库管理,还会在丢失扩展库时,帮助程序员快速找回扩展库,图形块名字中的作者、库名、块名在丢失扩展库时,会出现在天问库丢失报错画面上,如果图形块名字是规范的,则非常有利于程序员追根溯源,将丢失的扩展库重新加回来。
    我们为图形块起名字,千万不要吝惜字数和篇幅,一定要把图形块的相关要素表达清楚,电脑资源足够大,不要担心内存不够,我们借用中国第一代足球洋教练施拉普纳先生的一句名言“如果你不知道球往哪里踢,就往对方球门里踢”,那么同样的,如果你不知道如何起模块名字,那就平白直叙。
第三节 部署最简单的图形样式和图形代码
image.png
第一步如上图,添加一个假输入框,用来装填无需开孔的图形元素。
image.png
第二步如上图,添加一个文本元素,写上“我的空图块”,此时可以预览到右上角的样式变化。
image.png
第三步如上图,添加一个代码组合框。
image.png
第四步如上图,添加一个代码文本条,写上一句注释语句“空图块没代码”
image.png image.png
第五步如夯土,将不需要的组合框删掉。也可以不删或根据需要增加。
image.png


image.png

如上图,最后保存一下图形块,至此我们完成了一个空图形块的最简形式设计。
第四节 打包发布之编写XML文件
image.png

image.png
    如上图,点击打包,弹出扩展库信息填写窗,我们首先要简单学习一个编辑XML文件。
image.png
    如上图,打开XML编辑器后,因第一次编辑XML文件,所以无论打开后里面有什么内容,都全删除。
    内容清空后,直接导入当前编辑,空模块描述语句会出现在画面上(画红下划线的)。
    XML这段语句,决定了使用该库时,是否能在图形菜单上,看到这个图形块,以及看到它时的初始化状态。如果XML文件没有编写或编写错误,扩展库使用者加载扩展库后,会看不到这个图形块正确的样式,甚至看不到图形块。
image.png
    如上图,正确的编写XML文件,扩展库使用者才能在扩展库菜单上,看到一个正确的图形块样式。
image.png
    如上图,要在图形库菜单上输出哪些图块,则在《BLOCK》之间填写好它的名字即可。这一部分可以由“导入当前编辑”按钮自动导入,因本次我们做的是一个空库,因此不用再后期编辑,就此结束XML填写。
image.png
退出XML画面之前别忘了保存。
第五节 打包发布之填写扩展库基础信息
image.png
    如上图,中文名是对英文名的解释。给中国人使用的扩展库要写一个中国人能看懂的中文名。
    英文名也非常重要,它会出现在平台的管理系统中,是平台用来管理这个库的依据。比如缺少这个库时的报错弹窗,要显示这个名字,而不是中文名,扩展库管理也是一句英文名。大部分朋友包括笔者英文水平不高,所以干脆汉语拼音伺候,不用担心名字太长占内存,这些内容是有计算机处理,并不下载到单片机上,存储空间足够。
image.png
如上图,版本号用于区分同一个扩展库的不同版本,第一版当然就是1.0.0。
image.png
如上图,库的颜色决定了扩展库菜单左侧彩条的颜色,没什么大用。
中文介绍会出现在扩展库图标上,尽量填写明白。
image.png
    如上图,空库不存在语法差异和兼容性,因为空库没有程序语句。空库作为所有芯片扩展库的模板,因此我们勾选所有芯片, 这样无论创建哪一个芯片的扩展库,都可以用这个空库来新建一个库文档。
image.png
    如上图,同样的,因为是一个空库,我们帮助文档直接指向好搭论坛或不填写。
    也是因为是空库,我们不需要上传头文件,不需要封面。
    最后直接点击保存。
第六节 保存扩展库并预览
image.png
    如上图,点击保存,系统已经根据库信息的英文名,为我们直接写上了库文件名zip文件。因我们库英文名起的圆满,因此也不用修改,直接默认这个文件名保存即可。
image.png
    差点忘记一点,我们保存时,还是加上版本号为秒,因为从文件名上,我们无法区分版本号,不方便管理。因此我们自己加上版本号,版本号要与库内部版本信息一致。
image.png

image.png
    如上图,我们点击预览按钮,弹出一个模拟的图形化编程页面,我们可以看到这个库的名字,菜单样式,部署这个图形块后,可以看到我们预先安排好的代码。
    最后我们重申一下主题,我们建立这个空库有什么用呢?
image.png

image.png
    如上图,作用就是从导入本地库时,完成一个基础新库的建立,这个新库有一个基本的空图形,和已经写好了的库信息,可以直接预览和继续创作,不用每次都要清空整理。
    讲到这里,可能不少朋友会有疑问,怎么新建一个空库的过程也这么气势磅礴,步骤规矩繁多?
    所谓没有规矩不成方圆,一回生二回熟,希望我们从规范的空库建立,就能领会一个实库制作的要领。
    好,新建库这一课就讲到这里,全课文结束,谢谢朋友关注,谢谢老师指导。
同时吧这个空白库送给大家,朋友们可以导入这个空白库,作为快速新建空白库的模板
ZhangSan_KongBaiKu_1_0_0.zip (19.75 KB, 下载次数: 2)
回复

使用道具 举报

3

主题

15

帖子

63

积分

注册会员

Rank: 2

积分
63
发表于 2024-4-12 11:40:36 | 显示全部楼层
用你的步骤成功建立一个库,但是导入时直接提示“添加库失败”,也没提示更详细的原因,为何会这样 nullib0.0.2.zip (19.32 KB, 下载次数: 1)
回复

使用道具 举报

12

主题

52

帖子

1133

积分

版主

Rank: 7Rank: 7Rank: 7

积分
1133
 楼主| 发表于 2024-4-13 10:24:51 | 显示全部楼层
本帖最后由 libai500 于 2024-4-13 11:01 编辑
milefo 发表于 2024-4-12 11:40
用你的步骤成功建立一个库,但是导入时直接提示“添加库失败”,也没提示更详细的原因,为何会这样 ...

经检查,你和这个库在打包导出时,英文名依然是zhangsan......,也就是张三空库那个名字
所以与它冲突了。报错含义应该是与现有库重提。也就是你同时还加载了那个张三空库。
只要你打包时,改掉英文名,就没事了。
库的英文名是库的重要标识,图块的英文名,是图块的重要标识,这两个名字必须有自己的特色。一定不要与现有库冲突,否则过不了防冲突检测这一关。

    如上图,英文名一定要有自己的特色,必须确保唯一性。
    在第二课中基于空库建立新库章节里,详细阐述了新英文名修改环节。马上就回发布第二课。
    另,关于报错提示不完整,未能直观表达具体报错原因,我以与天团发了留言,也许新版本已经完善了,如果未完善报错提示机制,下一版本应该能进一步完善报错提示机制。敬请期待
-------------------------------
因笔者加载数据混乱,可能分析有误。经过我想我是海大佬鉴定,应该是库兼容选项勾选了不恰当的设备导致的。

image.png
如上图,经大佬提示,最好不要勾选自己不熟悉的设备,以免加载失败



回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|Archiver|手机版|小黑屋|好好搭搭在线 ( © 好好搭搭在线 浙ICP备19030393号-1 )

GMT+8, 2024-5-2 02:13 , Processed in 0.358951 second(s), 25 queries .

Powered by Discuz!

© 2001-2024 Comsenz Inc.

快速回复 返回顶部 返回列表