如何为CnPack组件包捐献及移植代码.txt 3.2 KB

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