小程序嵌入h5项目总结（一）——开发经验

小程序嵌入h5项目总结

从h5到小程序再到小程序嵌入h5，几个项目陆陆续续做了几个月了，今天就抽个时间对这几个月的项目做个总结吧，结构组织并不怎么规范，边写边完善吧

开发前准备

这里主要讲述，项目开发前对项目的了解，参与产品讨论，理解业务需求，功能需求，思考实现方案评估实现难度及风险，考虑与后端接口的对接，需要哪些接口，接口需要哪些参数，什么样的数据结构（尽最大可能的避免后期加接口加参数的问题），最后估算项目完成时间

沟通协作

沟通对象涉及产品、设计、同组人员、后端、测试。
**产品**：当业务需求不明确要及时询问，若需求难以实现需要改需求时，要说明难以实现的原因，并且考虑好一到三个实现方案，供产品选择。宗旨：给他选择题而不是给他解答题
**同组人员**：共同开发难免遇到业务相互调用，修改代码等一系列操作，沟通原则秉承：提出而不是职责，询问而不是质问，责任担当，讨论问题控制情绪
**后端**：与后端人员沟通，最多的无非接口、参数添加和接口出现问题，前者首先要自己想明白是否必须添加，不添加业务实现的难易程度。对于后者首先尽一切手段排查问题是否是自身原因造成，然后再找后端，沟通中抓住问题的重点说明，保证简洁高效

代码规范

1、规范的代码注释：每一个方法都要有规范的代码注释，每一个变量都要进行注释
2、语义化：语义化的方法名或变量名，能够使阅读者通过名称就能大概理解，功能或变量的意义
3、代码简短：避免一个方法有太多行代码，当方法过长时，要把代码分解成更小的方法，通常一段代码控制在30行左右。即便于阅读也便于维护
4、便以阅读为主：同样一行或一段代码，可能有不同的写法，但要用便以阅读理解的方式去书写
5、对其去空行：每行代码都要有整齐的对齐，对于没有意义的空行、打印、debugger、注释等要及时删除，使代码看上去清洁干爽
6、合并规整：一段代码定义变量，统一写在一块，方便查找避免冲突。对于多个变量有共同联系的，可以合并到一个对象中去，便于使用也便于以后理解

BUG规避

1、不管任务的紧急与否，开发中不可急乱，不能开发完成不检测
2、写功能：首先要理解透功能需求，考虑到所有可能出现的情况，当功能完成后要对每一种情况进行验证，保证确实没有问题后再进入下一个功能开发
3、写接口：对于需要调用接口的方法，要考虑到分别对接口请求成功和接口请求失败的处理，然后是接口请求成功后返回的状态有哪些，返回的有结果和没结果对应的处理，再后是实现逻辑，对于结构中的参数也要考虑到是否存在，如果因为数据不存在，会导致报错。开发结束要对接口成功、失败、发生错误及该接口所有的所有状态进行测试，注意：不能臆测或通过其他情况侧面反映接口的功能是否完善