KOL-CE组件介绍、下载地址、安装说明、范例......

猫工

介绍
KOL-CE是由Vladimir Kladov (http://kolmck.net)开发的元件，在其他平台上为KOL跟MCK两组套件，现在则是将之移植到Free Pascal跟Lazarus上使用，关于它的授权，请参见: wxWindow函式库授权.
KOL-CE可以建立非常精简的Win32/WinCE图形界面程序(如果项目只包含一个空的视窗的话，建置出来的程序码大约只占40KB而已)。
MCK则是让KOL-CE项目使用的一组Lazarus套件，KOL-CE的图形界面就是靠MCK来达成的。
原本KOL-CE只是计划把KOL移植给WinCE使用而已，但后来开发的时候决定要把Win32的许多功能保留下来，并让FPC开发WinCE应用程序能够更顺利。原本KOL是为Delphi设计的，当时在FPC上面运作并不顺，而原始的MCK则是完全不能在Lazarus上面使用的。

[edit] 下载
请从这里下载最新版的KOL-CE
您也可以从SVN下载最新出炉的KOL-CE原始码，连结如下: https://kol-ce.svn.sourceforge.net/svnroot/kol-ce/trunk


[edit] 基本需求

[li]Win32平台上的Free Pascal编译器2.2.0版或更新的版本。 [/li][li]Win32平台上的arm-wince交叉编译器2.2.0或更新的版本(开发WinCE程序时会用到). [/li][li]Win32平台上的Lazarus 0.9.23版或更新的版本。 [/li]

[edit] 能支援的平台

[li]所有32位元的Windows作业系统，从Windows 95到Vista都行。 [/li][li]使用Windows CE为作业系统的PocketPC跟手机。 [/li]

[edit] 安装

---

如果您正在使用Lazarus 0.25版或更新的版本，则您就需要先加入DisableFakeMethods这个设定，重新编译Lazarus，接着才能安装MCK套件。
步骤如下:

[li]执行Lazarus. [/li][li]点选选单项目: Tools > Configure "Build Lazarus"... [/li][li]在Quick Build Options分页上，点选Clean Up + Build all项目。 [/li][li]开启Advanced Build Options分页，并在Options这个对话框里面加入-dDisableFakeMethods这个设定字符串。 [/li][li]点选Build按键以重新建置Lazarus。 [/li]

---

[li]下载KOL-CE的原始码，并将之放在您的硬盘里(当然要解压缩)。 [/li][li]执行Lazarus并点选选单项目Components > Open package file (.lpk)，然后寻找到MCK套件所在的目录，并选择MirrorKOLPackage.lpk这个档案。 [/li][li]套件视窗此时就会跳出来了，请按下Install按键。 [/li][li]Lazarus会将MCK套件进行编译，然后重新执行Lazarus IDE。 [/li][li]Lazarus IDE重新出现后，KOL分页就会在元件盘上面出现了。 [/li]

附注: 如果您没有在元件盘上面看到KOL分页的话，请把该视窗的高度拉大一点即可，您会看到元件盘的分页标签变成两排，KOL分页标签就会出现在第二排。(如上面的荧幕截图所示)
MCK套件的升级非常简单，请直接用新版的KOL-CE原始码把旧版的覆盖掉，再次开启MCK套件(MirrorKOLPackage.lpk)，然后按下Install按键，重新编译套件就行了。
[edit] 使用MCK
[edit] 建立MCK项目

[li]启动Lazarus并点选表单来新增一个应用程序项目:File > New...。 [/li][li]新增项目以后不要急! 千万不要在这个时候放任何元件上去，请先把项目存档，点选目录选项: File > Save All，然后选择您要存放项目档案的目录即可。 [/li]

请注意!该项目的所有档案，都必须存放在同一个目录里面。您可以随时变更表单的单元档档名，但请不要变更项目的名称，就用原来的Project1.lpi。

[li]请拖拉一个TKOLProject元件放到表单上面。 [/li][li]请设定ProjectDest这个属性，来变更MCK项目的名称(不用包含路径喔)。如果您输入了MyKOLProg，那么您的MCK项目名称就会自动变成MyKOLProg.lpi，而产生出来的执行档，也会被命名为MyKOLProg.exe。
[/li][li]请把TKOLForm这个元件拖放到表单上面。 [/li][li]把目前的项目存起来。 [/li][li]请开启刚刚您在ProjectDest属性内设定的项目名称， (在刚刚的例子里面，应该是MyKOLProg.lpi，应该可以在同一个目录里面找到。然后，您就可以把project1.*给删掉了，以后不会再用到这些档案了。 [/li][li]跟您的新KOL/MCK项目熟悉一下吧。(调整参数，放TKOL相关元件，编译，执行，侦错等等) 祝您玩的高兴啦! [/li]

[edit] 新增一个表单

[li]点选目录选项: File > New form [/li][li]把新表单跟项目存放在同一个目录里面。(如果项目档已经存档了的话，没存档的话请先把项目档存档) [/li][li]把TKOLForm元件拖拉到表单上面来。 [/li][li]请确认在项目的主表单上面，已经有摆放了TKOLApplet这个元件。 [/li][li]如果AutoBuild这个属性已经设定为关闭，请点选主表单上面的TKOLProject元件，并双击它的属性Build就可以建置该项目了，如果您双击Build没有动静的话，请按alt+Tab将视窗的焦点移到别的视窗上面，您就会发现有所动作了。 [/li]

[edit] 撰写程序码
请别使用RTL/FCL/LCL相关的单元，由其是SysUtils, Classes, Form这些单元，您需要的函式，应该在KOL, Windows, Messages这三个单元档里面找到，或者是由您自行撰写的。当您在项目内撰写程序码的时候，请记得要放在事件处理函式内。您也可以自行撰写程序码，但不要动到程序原始码的开始部分，也就是LCL表单的宣告部分。不要更改自动产生的inc档案，请记得，您在项目里面写的程序码，必须同时兼容于LCL跟KOL，当使用LCL建置的时候，宣告部分会使用LCL的相关单元档，项目会变成Win32兼容的应用程序，而使用KOL建置的时候，则会使用KOL的相关单元档，建置出来的则是WinCE兼容的应用程序。
[edit] 重点
为了解决KOL跟LCL对关键字的冲突: LCL.Self跟KOL.@Self，所以要特别使用Form这个栏位，在LCL里面，TKOLForm元件的Form属性，将会回传Self这个属性，也就是表单本身的意思，而在KOL里面Form: PControl则是物件的属性之一，包含了表单元件。也因为这一点，要变更表单的属性，就要这么写:
[pre]Form.Caption := 'Hello!'; [/pre](原来的写法，是写成Caption := 'Hello!';即可，当在使用LCL对本项目进行编译的时候，这样是完全没问题的，但以KOL编译时则会出错) 但上述讨论的关键字Form只能使用到表单这个属性，无法使用到表单上面的控制项。您要使用子控制项跟表单的事件处理函式时，请依照原来的方式即可，例如: Button1.Caption := 'OK';
[pre]Button1Click(Form);[/pre][edit] 在执行时期动态建立表单
在执行时期，同一个表单是可以建立出多个实体的，只要把表单的属性”AutoCreate”设定成不要自动建立，然后在需要的时候再透过程序码来建立表单即可。要动态建立表单，请使用全域函式NewForm1:
[pre]TempForm1 := NewForm1( Applet );[/pre]要让这个动作能够执行，请别在建立表单实体的时候使用单元档里面的全域变量来承接建立出来的表单，除非您知道您为何要那么作。


[edit] WinCE
[edit] 设定
您需要在您的系统中安装Win32版本的arm-wince交叉编译器，以建立WinCE的应用程序，请从这里下载。
要编译arm-wince的应用程序，您必须先设定项目的编译器属性，请点选选单项目: Project > Compiler options...，点选Code分页，并把target platform改变为arm-wince，如附图所示。
附注: 在编译您的WinCE应用程序时，IDE可能会回报以下的错误讯息:
[pre]Compiling resource KOL-CE.rcarm-wince-windres.exe: no resourcesKOL.PAS(57901) Error: Error while linkingKOL.PAS(57901) Fatal: There were 1 errors compiling module, stopping[/pre]此时，您需要编辑Windows的环境变量PATH，把Win32平台FPC的编译器路径加进去。
如果您不知道要加入哪个路径，请点选Lazarus选单项目: Environment options，然后看compiler path这个栏位的资料就是了。
别变动Lazarus里面的PATH，离开Lazarus.
用鼠标右键在”我的计算机”图示上面点击，选择目录里的’’’内容’’’，再点选内容视窗里面的进阶分页，再点选环境变量这个按键就可以编辑PATH这个环境变量了。
[edit] 提示与注记

[li]要建立大多数Pocket PC上的全荧幕应用程序，请别变更表单的位置跟大小，如果表单的大小跟位置被变动了，则该表单就会看起来象是有标题栏的对话视窗，当然也包含标题栏的关闭程序按钮。在MCK里面把TKOLForm元件的defaultSize跟defaultPosition这两个属性设定为”True”就能让表单全荧幕显示了。 [/li]

[edit] 已知的问题

[li]下列两个元件目前不支援: RichEdit, TrayIcon. [/li][li]目前只支援gsVertical, gsHorizontal 这两种panel样式。 [/li]

[edit] 说明文件

[li]您可以从KOL官方网站找到KOL跟MCK的官方文件跟相关信息: http://kolmck.net [/li][li]请务必阅读MCK目录里面的KOLmirrorReadme.txt这个档案，这是MCK的说明文件。 [/li]

kmgog

不错的教程，正在摩拜学习。

kmgog

编译的时候提示
unit1.pas(8,10) Fatal: Can't find unit mirror used by Unit1

是不是那弄错了？

popzone

同上我也是编译不了
Fatal: Can't find unit mirror used by Unit1
希望高手解答

猫工

引用第3楼popzone于2009-05-28 00:22发表的  :
同上我也是编译不了
Fatal: Can't find unit mirror used by Unit1
希望高手解答

说你找不到单元，你要在项目属性里，把单元的目录加进去

popzone

可能版本不匹配
我重装 lazarus 0.9.27 + KOL 2.88 后一切正常

但是还是谢谢猫工的解答！

kmgog

版本问题？
我重装了几次了，汗。
单元在装的时候已经加过啦。

再请猫工指导。

猫工

我蛮顺利的安装好了啊。我等会再找个新机器安装，截图你们看

猫工

因为好多人问怎么安装kol-ce，我觉得是很简单的东西，不知道为什么大家还是安装不好。现在我一步一步截图上来：
http://www.lazarus.net.cn/read.php?tid=160

jchchen

C:\\lazarus\\components\\codetools\\fileprocs.pas(1,1) Fatal: Can't find unit Unix used by FileProcs