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

kzdq

第一节 清场

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

    如上图，这个页面可能是上次做库的残余文档，也可以是一个意外的导入库，这种状况对于新手来说无疑是雪上加霜。因此我们开篇第一课，就是讲如何建立一个空白库。

    建立一个空白库，是图形库制作的第一课，也是小白做库重要基本技能之一。建立空白库，首先是进入扩展库制作画面，并清场。下面讲述进入库制作画面以及清场要领。

    如以上步骤，一通操作猛如虎，相信删除操作，对于新手不难。清场工作瞬间完成。

第二节 给图形块起个名字

    一个图形库中，可以有多个图形块，英文叫Block，刚才我们已经删除了所有的图形块。我们必须重新建立一个图形块，并为新图形块起一个合理规范的名字。

    如上图，我们清场后，库里一个图形块也没有，我们必须先为新图形块起个规范的名字，那么什么样的名字算是规范的呢？笔者经过半年总结，认为图形块名字规范化很重要。
    图形块名字必须包含图形库作者的代号，以及所属图形库的名字和图形块的名字。

    如上图，我们按照规范，编写了第一个库模块的块名字。因不支持中文，我们直接用汉语拼音平白直叙，我闷试用大小写遵守驼峰命名规则，并用下划线将作者名，库名和图形块名分开。即ZhangSan_KongKbaiKu_KongBaiKuai。
    在这里，我们再次重申命名规则的重要性，这个规则不但有助于库管理，还会在丢失扩展库时，帮助程序员快速找回扩展库，图形块名字中的作者、库名、块名在丢失扩展库时，会出现在天问库丢失报错画面上，如果图形块名字是规范的，则非常有利于程序员追根溯源，将丢失的扩展库重新加回来。
    我们为图形块起名字，千万不要吝惜字数和篇幅，一定要把图形块的相关要素表达清楚，电脑资源足够大，不要担心内存不够，我们借用中国第一代足球洋教练施拉普纳先生的一句名言“如果你不知道球往哪里踢，就往对方球门里踢”，那么同样的，如果你不知道如何起模块名字，那就平白直叙。
第三节 部署最简单的图形样式和图形代码

第一步如上图，添加一个假输入框，用来装填无需开孔的图形元素。

第二步如上图，添加一个文本元素，写上“我的空图块”，此时可以预览到右上角的样式变化。

第三步如上图，添加一个代码组合框。

第四步如上图，添加一个代码文本条，写上一句注释语句“空图块没代码”

第五步如夯土，将不需要的组合框删掉。也可以不删或根据需要增加。





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



    如上图，点击打包，弹出扩展库信息填写窗，我们首先要简单学习一个编辑XML文件。

    如上图，打开XML编辑器后，因第一次编辑XML文件，所以无论打开后里面有什么内容，都全删除。
    内容清空后，直接导入当前编辑，空模块描述语句会出现在画面上（画红下划线的）。
    XML这段语句，决定了使用该库时，是否能在图形菜单上，看到这个图形块，以及看到它时的初始化状态。如果XML文件没有编写或编写错误，扩展库使用者加载扩展库后，会看不到这个图形块正确的样式，甚至看不到图形块。

    如上图，正确的编写XML文件，扩展库使用者才能在扩展库菜单上，看到一个正确的图形块样式。

    如上图，要在图形库菜单上输出哪些图块，则在《BLOCK》之间填写好它的名字即可。这一部分可以由“导入当前编辑”按钮自动导入，因本次我们做的是一个空库，因此不用再后期编辑，就此结束XML填写。

退出XML画面之前别忘了保存。
第五节 打包发布之填写扩展库基础信息

    如上图，中文名是对英文名的解释。给中国人使用的扩展库要写一个中国人能看懂的中文名。
    英文名也非常重要，它会出现在平台的管理系统中，是平台用来管理这个库的依据。比如缺少这个库时的报错弹窗，要显示这个名字，而不是中文名，扩展库管理也是一句英文名。大部分朋友包括笔者英文水平不高，所以干脆汉语拼音伺候，不用担心名字太长占内存，这些内容是有计算机处理，并不下载到单片机上，存储空间足够。

如上图，版本号用于区分同一个扩展库的不同版本，第一版当然就是1.0.0。

如上图，库的颜色决定了扩展库菜单左侧彩条的颜色，没什么大用。
中文介绍会出现在扩展库图标上，尽量填写明白。

    如上图，空库不存在语法差异和兼容性，因为空库没有程序语句。空库作为所有芯片扩展库的模板，因此我们勾选所有芯片， 这样无论创建哪一个芯片的扩展库，都可以用这个空库来新建一个库文档。

    如上图，同样的，因为是一个空库，我们帮助文档直接指向好搭论坛或不填写。
    也是因为是空库，我们不需要上传头文件，不需要封面。
    最后直接点击保存。
第六节 保存扩展库并预览

    如上图，点击保存，系统已经根据库信息的英文名，为我们直接写上了库文件名zip文件。因我们库英文名起的圆满，因此也不用修改，直接默认这个文件名保存即可。

    差点忘记一点，我们保存时，还是加上版本号为秒，因为从文件名上，我们无法区分版本号，不方便管理。因此我们自己加上版本号，版本号要与库内部版本信息一致。



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



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