| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677 |
- **********************************************************************
- CnPack For Delphi
- 中国人自己的开放源码第三方开发包
- (C)Copyright 2001-2016 CnPack 开发组
- **********************************************************************
- 如何为CnPack组件包捐献及移植代码
- Revision 1.0.0.0
- =========================
- 作者:刘啸
- 创建:2008.01.01
- 致愿意为 CnPack 组件包捐献组件代码的朋友:
- CnPack 组件包一直在开发人员和用户朋友的帮助中不断完善壮大,在此对移植和
- 捐献代码给 CnPack 组件包的朋友表示诚挚的谢意。同时为了 CnPack 组件包的发
- 展,也欢迎有更多的朋友将组件作品捐献出来移植入 CnPack 组件包。
- 将代码捐献给 CnPack 组件包有以下几个前提条件:
- 1. 您同意将您的作品开源。CnPack 的所有产品都是开源免费的。
- 2. 组件是 Delphi/Pascal 代码,功能比较典型、强大。
- 3. 没有引用其他第三方的商业代码,这点很重要。
- 4. 引用了网上其他开源代码时需要注明。
- 如果您和您的组件作品符合以上几个条件,而您又愿意将组件作品捐献给 CnPack
- 组件包,那么烦请按下面的步骤来:
- 将代码移植入 CnPack 组件包的前期步骤:
- 1. 确定您的组件分类。CnPack 组件包目前有界面组件、数据库组件、不可视组
- 件、普通公共组件、多语组件、网络通讯组件等几大分类。您也可以先参考
- 我们的组件包源码来确定和您的组件有无重复。
- (关于如何获得 CnPack 的最新代码,请参考网站的文档中心中的相关文档。)
- 2. 写一段关于组件本身的简介,写明分类,并写个简单的例子,发给管理员。
- 这一步的主要目的是让我们了解您的组件作品的功能、规模与用途,以决定
- 是否能加入 CnPack 组件包。
- 注:管理员信箱 master@cnpack.org,烦请在主题中标明“CnPack”或
- “组件”字样(没法子,垃圾邮件太多了)。
- 如果管理员认为您的组件作品不错,推荐移植,那么烦请您接着按以下步骤来:
- 1. 修改各个源文件命名,以 Cn 开头。
- 2. 修改组件名称和源文件的其他类名,以 TCn 开头。
- 3. 源码要求格式整齐,变量等的命名比较规范,最好按 VCL 代码的格式来。
- 不推荐用匈牙利命名法。
- 4. 组件中用到的字符串,如果和界面有关,都要求单独提出来做成字符串常量
- 的格式,以备组件的多语化之用(多语这一步我们来做)。字符串常量以 SCn
- 开头,中间不用下划线。
- 5. 如果您的组件涉及到 Form(比如您为您的组件写组件编辑器需要弹出一个
- Form 来处理部分内容),那么烦请将 Form 上的所有字符串也都单独提出来
- 做成字符串常量,并在 Form 的 OnCreate 事件中用字符串常量对界面的各
- 个属性进行赋值。这也是为了组件的多语化之用。
- 6. 修改成功后,修改您的例子以适用这些重命名后的组件和源文件。此处例子
- 中的文件名和类名等不需要用 Cn 字样。
- 7. 写个帮助文档,简要列出并解释该组件特有的 public 以及 published 的所
- 有属性、方法和事件。文档格式可用文本格式。我们负责将其格式化并将其
- 并入 CnPack 的组件帮助文档中。
- 8. 将组件源文件、例子、帮助文档打包发给我们。同时可注明您的姓名、网名
- 和邮箱地址(三部分内容中,您至少需要写一个网名以供我们列入有贡献人
- 员名单)。
- 其他注意事项:
- 1. 您的组件最好能支持 Delphi 5 后的所有 IDE 版本。如果实在不能支持,
- 我们也可以接受从 Delphi 7 开始支持。
- 2. 如果您的组件有组件图标 dcr 文件,可以一并发给我们。不过 CnPack 组件
- 包有统一风格的图标,因此您的组件图标可能会被修改一下以符合我们的风格。
- 我们接受组件后会将其并入 CnPack 组件包,并且在我们的有贡献人员名单中将出
- 现您的名字。
- 再次感谢您的支持!
|