招收火山平台类库兼职封装人员

一、前提要求：

1、封装火山安卓平台类库需要熟悉安卓系统的java程序开发并有安卓程序的开发经验；封装火山视窗平台类库需要熟悉Windows系统的VC++程序开发。

2、清楚并了解火山软件开发平台的语法手册（不明白之处可以提前向 我们咨询），熟悉火山程序的开发 ，建议首先仔细读懂已有类库内容；

3、需要有耐心并细致，特别是最开始进行封装时，可能会磨合一段时间，要有心理准备。

二、兼职工作流程：

1、我们向 您发布火山类库封装项目具体需求（此需求也可以来自您的建议）并商定开发时间；

2、您进行开发；

3、我们验收项目成果，然后付款给 您。自付款之时起，项目成果的版权归属我公司所有 。

三、费用评估及交付方法：

1、项目验收合格后，按照每行1.2元的价格 于当天全额付款，总付款金额 = 1.2 x 项目结果总行数；

2、付费行数的具体界定方法：

A、火山程序部分：在火山IDE中打开用作封装的程序，以该程序最后一行在窗口左侧所显示的行号为准；

B、本地(java/c++/asm...)程序部分：用文本编辑器打开，以最后一行的行号为准；

C、为所封装内容所书写的用户使用方法用例包括在有效付费行数内；

D、用作提供给 我公司验收功能时使用的测试用例不包括在付费行数计算范围之内；

E、 所使用的任何第三方（即非您所亲自书写的）代码不在付费行数计算范围之内。

3、 超时处理：

如果项目花费时间超出商定时间7天，此项目中止作废，不再合作。如果有特殊理由，请及时与 我们沟通获得同意。

四、质量要求细则：

质量要求方面可能比较琐碎，建议您首先仔细阅读一下我们所提供的现有系统库代码，再阅读下面的内容可能感觉会更清晰一些。

提示：最好的快速熟悉类库封装的方法就是结合火山软件开发平台的语法手册将系统中已经封装的类库看懂，然后命名和注释风格都按照已有类库的来，这样质量就很容易达标。

1、功能要求：

封装全面，不存在BUG，功能达到要求。譬如假设 我们提出对指定功能进行封装，不能只选择性地封装其中的一部分，如果确实有难度/无法封装/该功能最终用户很少使用，需要事先与 我们申请同意；

2、接口要求：

所封装出来的功能接口必须充分考虑到普通级别用户的要求和学习掌握能力，尽量清晰、简洁、易于学习和使用。所封装火山程序的所有名称除开无法替换的专业术语外必须全部使用中文；

3、注释要求：

所封装火山程序中表格内所有可以填写注释的位置必须都填写对应注释，火山程序语句的必要位置处也尽量填写注释。注释必须为中文、有意义而且清晰明了，要求最终用户通过阅读注释就能掌握对所封装内容的使用方法。

注释文本中必须使用半角标点符号，如果句子中有逗号或者存在多段文本，必须以句号结束。如果因为太长需要硬断行，在段落的首行首部必须加上两个空格字符。这一切要求是为了让程序结构查看器能够根据注释建立起正确的帮助文本内容。

附：注释相当重要，它是程序结构查看器建立即时帮助文本的来源，是最终用户获得所封装内容使用方法的重要资料，所以必须满足要求；

4、用例要求：

A、最终用户使用方法用例：

您需要为所封装类库提供最终用户使用方法用例，我公司会为此例程支付费用。

例程必须使用火山程序书写，其中不能包括任何java/c++代码。除非必要，其中也不能使用火山程序的系统/项目特定属性（名称以‘@’字符开头的属性）。例程必须具有清晰明了的注释，必须在注释中说明清楚所封装内容的使用方法和注意事项，必须将所封装功能的所有方面均展示到；

B、项目验收测试用例：

如果没有提供最终用户使用方法用例，则必须提供验收用测试用例。该例程除了应该测试到所封装功能的所有方面外，没有其它要求。此例程我公司不会支付费用。

5、尽量使用火山的独有特性：

A、单参数或无参数的方法尽量封装成读/写属性，因为其可以直接在属性表中使用；

B、对外主动提供通知时尽量使用事件而不是虚拟方法，因为前者更容易被用户使用;

C、枚举类型的常量尽量定义在单独的常量类中而不直接定义为某基本数据类型的常量值，因为使用常量类后在编辑相关程序代码时可以支持从列表中直接选择；

D、内容为单一嵌入行的方法尽量封装为嵌入式方法，以提高执行效率；

E、 所使用到的外部资源、外部源代码文件、外部库、权限声明、附加清单等内容尽量定义在方法级别上，避免用户程序在使用所封装接口时关联进不必要的资源或代码；

F、 如果所封装的方法里面会抛出异常，尽可能把异常给截获处理掉(安卓程序可以使用系统类库”j_macro.v”文件里已经定义的宏)，改为返回错误值，或者进行默认处理。因为初级用户可能对异常不了解 。

6、不允许存在的代码：

A、重复性的相同/类似代码，明显能精简而不精简的冗余代码；

B、连续多行的空白行代码（用作让程序结构更清晰的单空白行除外）；

C、与所封装功能无关的代码；

D、啰嗦重复/无意义/为英文的注释代码。除非确有必要，非接口定义位置处不允许出现大段多行的注释代码。

7、其它：

A、如果封装所指定功能的同时，需要先去封装其它不属于该功能的必需依赖功能（譬如封装手势支持功能的时候需要先去封装触摸事件类），必须首先向 我公司申请同意，以便进行协调安排，避免和其它项目的封装造成冲突。如果我公司同意，应当再次协商项目的开发所需周期；

B、封装安卓类库时，所封装代码必须能被安卓4.2版本（API版本17）所支持，而且不能使用在后续更高安卓系统版本中被抛弃或过时的特性或API；封装视窗类库时，所封装代码需要能在Vistual Studio 2015及以上版本正常编译,能够在Windows xp平台上执行。

C、您必须确保独立拥有所封装结果代码的版权，使用第三方公开代码必须确保其不存在商业应用方面的版权问题。您的项目成果如果与第三方产生版权纠纷， 您必须承诺承担一切相关后果。

请同意以上规范且有意合作的朋友联系QQ: 3251044 / 378821858 或者电子邮件 wutao@vip.163.com ,注明事项”兼职开发”,谢谢!