本帖最后由 创世魂 于 2019-2-27 21:46 编辑
首先欢迎加入为中文编程语言添砖加瓦的行列,您所参与的这项工作是非常有意义的,它将致力于帮助千千万万的普通人迈进软件开发的大门,让他们能够真正彻底地融入当今这个数字化时代,充分挥洒自己的聪明才智。这是我的梦想,相信也是您的! 我们特意推出了一个名为“火伴”的词汇,用来献给那些支持火山中文编程平台、帮助火山中文编程平台以及使用火山中文编程平台的朋友们。
下面是火山平台封装类项目外包规范:
火山平台封装类项目外包规范
一、 项目发包方为武汉递归软件开发有限公司(本人 易语言作者吴涛所有的公司),简称甲方;项目承接方是您,简称乙方。 二、 对您的前提要求: 1、 熟悉安卓系统的java程序开发,有安卓程序的开发经验; 3、 您应该是我们的“火伴”。 三、 项目外包流程: 1、 乙方向甲方申请承接项目,甲方认可乙方的资格后,向乙方发布火山封装项目具体外包需求(此需求也可以来自乙方的建议); 2、 乙方根据该项目的大小和难度估算出所需开发周期时间提交甲方同意; 3、 乙方进行开发; 4、 甲方评估工作量并验收项目成果,然后付款给乙方。自付款之时起,项目成果的版权归属甲方(乙方个人依旧允许使用)。 四、 费用评估及交付方法: 1、 项目验收合格后,甲方按照每行0.7元(根据武汉地区通常兼职月薪、每月22天工作日、每天工作量500行有效代码、封装类项目开发难度系数综合得出)的价格付款,总付款金额=0.7 x项目结果总行数。甲方必须在验收通过后三日之内全额付款; 2、 付费行数的具体界定方法: A、 火山程序部分:在火山IDE中打开用作封装的程序,以该程序最后一行在窗口左侧所显示的行号为准; B、 Java程序部分:用文本编辑器打开,以最后一行的行号为准; C、 为所封装内容所书写的用户使用方法用例包括在有效付费行数内; D、 用作提供给甲方验收功能时使用的测试用例不包括在付费行数计算范围之内; E、 所使用的任何第三方(即非您所亲自书写的)代码不在付费行数计算范围之内。 3、 超时处理: 如果项目花费时间超出商定时间7天,此项目中止作废,不再合作。如果有特殊理由,请及时与甲方沟通获得同意。 附:最好是按时完成,不然可能影响下次继续合作。 4、 项目预付款: 由于项目成果行数在完成前无法界定,因此目前没有预付款,请认可甲方(易语言作者吴涛)的信誉。 五、 质量要求细则: 质量要求方面可能比较琐碎,建议您首先仔细阅读一下我们所提供的现有系统库代码,再阅读下面的内容可能感觉会更清晰一些。 1、 功能要求: 封装全面,不存在BUG,功能达到要求。譬如假设甲方提出对指定功能进行封装,不能只选择性地封装其中的一部分,如果确实有难度/无法封装/该功能最终用户很少使用,需要事先与甲方申请同意; 2、 接口要求: 所封装出来的功能接口必须充分考虑到普通级别用户的要求和学习掌握能力,尽量清晰、简洁、易于学习和使用。所封装火山程序的所有名称除开无法替换的专业术语外必须全部使用中文; 3、 注释要求: 所封装火山程序中表格内所有可以填写注释的位置必须都填写对应注释,火山程序语句的必要位置处也尽量填写注释。注释必须为中文、有意义而且清晰明了,要求最终用户通过阅读注释就能掌握对所封装内容的使用方法。 注释文本中必须使用半角标点符号,如果句子中有逗号或者存在多段文本,必须以句号结束。如果因为太长需要硬断行,在段落的首行首部必须加上两个空格字符。这一切要求是为了让程序结构查看器能够根据注释建立起正确的帮助文本内容。 附:注释相当重要,它是程序结构查看器建立即时帮助文本的来源,是最终用户获得所封装内容使用方法的重要资料,所以必须满足要求; 4、 用例要求: A、 最终用户使用方法用例: 在发包项目时,如甲方有要求,则需要为所封装内容提供最终用户使用方法用例,甲方会为此例程支付费用。 例程必须使用火山程序书写,其中不能包括任何java代码。除非必要,其中也不能使用火山程序的系统/项目特定属性(名称以‘@’字符开头的属性)。例程必须具有清晰明了的注释,必须在注释中说明清楚所封装内容的使用方法和注意事项,必须将所封装功能的所有方面均展示到; B、 项目验收测试用例: 如果没有提供最终用户使用方法用例,则必须为甲方验收项目提供测试用例。该例程除了应该测试到所封装功能的所有方面外,没有其它要求。此例程甲方不会支付费用。 5、 尽量使用火山的独有特性: A、 单参数或无参数的方法尽量封装成读/写属性,因为其可以直接在属性表中使用; B、 对外主动提供通知时尽量使用事件而不是虚拟方法,因为前者更容易被用户使用; C、 枚举类型的常量尽量定义在单独的常量类中而不直接定义为某基本数据类型的常量值,因为使用常量类后在编辑相关程序代码时可以支持从列表中直接选择; D、 内容为单一嵌入行的方法尽量封装为嵌入式方法,以提高执行效率; E、 所使用到的外部资源、外部源代码文件、权限声明、附加清单等内容尽量定义在方法级别上,避免用户程序在使用所封装接口时关联进不必要的资源或代码; F、 如果所封装的方法里面会抛出异常,尽可能把异常给截获处理掉(可以使用系统类库”j_macro.v”文件里已经定义的宏),改为返回错误值,或者进行默认处理。因为初级用户可能对异常不了解; G、 能使用火山程序本身封装的功能尽量使用火山程序本身封装,尽可能减少Java本地代码的使用量; H、 类与类之间使用双横线行(“=”)分隔,类中各类成员之间使用单横线行(“-”)分隔,以保持程序结构清晰。 6、 不允许存在的代码: A、 重复性的相同/类似代码,明显能精简而不精简的冗余代码; B、 连续多行的空白行代码(用作让程序结构更清晰的单空白行除外); C、 与所封装功能无关的代码; D、 啰嗦重复/无意义/为英文的注释代码。除非确有必要,非接口定义位置处不允许出现大段多行的注释代码。 7、 其它: A、如果封装所指定功能的同时,需要先去封装其它不属于该功能的必需依赖功能(譬如封装手势支持功能的时候需要先去封装触摸事件类),必须首先向甲方申请同意,以便甲方进行协调安排,避免和其它项目的封装造成冲突。如果甲方同意,应当再次协商项目的开发所需周期; B、所封装代码必须能被安卓4.2版本(API版本17)所支持,而且不能使用在后续更高安卓系统版本中被抛弃或过时的特性或API; C、您必须确保独立拥有所封装结果代码的版权,使用第三方公开代码必须确保其不存在商业应用方面的版权问题。我们购买您的项目成果后如果与第三方产生版权纠纷,你必须承诺承担一切相关后果。
资深合作火伴: 作为软件开发平台,火山将有大量的封装项目外包。在成功合作累计采用代码量达到五千行以上后,您将成为资深合作火伴,资深合作火伴拥有以下特权: 1、 优先获得后续封装项目; 2、 可以在所封装成果中署名; 3、 在火山安卓开发平台正式版发布后,获赠一套个人版; 4、 在火山的用户QQ群和用户论坛中,您将获得类似“中文编程资深火伴“这样的头衔; 5、 您将获得在本公司的良好信誉,公司以后有类似项目合作或者有更大发展机会的时候,会优先考虑和您合作!
|