01_手机游戏编码技术规范.docVIP

Java 游戏编码规范 开发人员在编写JAVA程序时，主要遵守以下规则： 整个项目的结构与程序的结构应合理、清晰，便于升级扩展 程序易于维护，具有良好的编码风格 整个项目的结构与程序的结构应合理、清晰，便于升级扩展 1、整个项目（目前一般来说是一个游戏）具有合理的目录结构与文件的组织形式。 2、对于程序来说，应有合理的类的划分，函数的划分，类之间的调用关系。 程序易于维护，具有良好的编码风格 JAVA程序按照模板的格式编写，各个程序段划分清楚。不属于一个功能模块的变量与函数不要放在一起，设计与实现的时候要思路清晰。 命名规则。 函数与变量名称应使用有意义的单词组成的名字，名字与功能相符。 final变量全部大写，各单词之间使用“_”分割。例如 private final int CANVAS_WIDTH = getWidth(); 函数成员变量使用g_typeName的形式。其中Name中如果有多个单词，每个单词的首字母大写。以g_开头，表示全局变量。其中的type为变量的类型的简称，含义如下： 类型 简称 备注 boolean bln byte byte int n long l short sh char ch String str Image img 自定义的类 c 局部变量除了没有g_，其他与类的成员变量命名规则一致。 函数名使用有意义的单词组成，函数的名称与功能必须一致。一般一个函数完成一件工作，总体上函数名称采用一个动词（+ 一个名词）的方式组成，如果函数的功能无法用一个动词描述，建议分解该函数为多个函数。函数名称的第一个单词全部小写，后面的单词首字母大写，其余小写。 注释。在程序中使用注释解释变量与函数的功能与使用时的注意事项。否则过一段时间，编写代码的人也没法确认各个变量的含义与使用注意事项。在修改程序时要花费大量的时间研究代码。 程序段落。在函数内，不同的功能之间应有空行作为分割，便于阅读与修改。 修改程序。修改别人的程序时，即使是拷贝后再修改，也应在修改的地方注释，便于别人以后的工作。 在编写代码的时候，尽量不要在一个类中出现重复的或结构功能极相似的代码，这样的代码应提取出来写成子函数调用。 对于不变的变量，应定义成final型的宏的形式。 编码风格。 在每行的开头只使用Tab，不使用空格，除非为了函数换行时与上一个函数的括号对其。每个Tab为4个空格长度。 每一行单独的语句之后换行，不要出现几个语句写在一行的情况。对于if/else/else if/for/switch等语句，即使只有一行语句，也应使用大括号，并换行。 每个大括号占用一行，并且每一层嵌套有一个Tab的缩进。 在if/else/else if/for/switch等语句与其后的大括号之间应使用空格分割；在运算符与赋值符得前后应使用空格分割。 每一行语句不要超过100个字符，以便在阅读代码的时候不用使用左右滚动。如果超过100个字符，在操作符、分隔符之类的地方换行，下一行开头与上一行的相同的功能的变量或符号对齐。 对于本规则不明确或没有提到的地方，可以参考模板的编程风格。 模板是为了更快速/标准的开发程序，如果发现模板或本规则有不合理的地方，可以提出来讨论，并更改模板或规则。不要被模板或规则束缚住。  游戏编程时的注意事项与技巧 程序主要分4个主要的部分：游戏状态变量、run()、paint()、UI。基本其他函数都是实现这3个函数的具体功能，在各自的部分实现不同功能。游戏状态变量是一批标志游戏状态的变量，去掉所有其它部分，游戏状态变量的集合就能够独立的表示游戏中的任何一个状态，其他的所有的函数都是针对这些变量进行不同情况的处理或显示。Run()是程序的主体，基本大部分游戏的逻辑都是在Run()里实现，例如敌人的所有动作，游戏的进行中判断碰撞，判断游戏的状态并刷新屏幕；UI是指与用户的的交互，包括Key_____()等函数，在这里接受用户的输入，然后修改游戏状态；paint()函数是游戏的显示函数，当刷新屏幕时，Paint()被调用，将当前游戏的状态用某种方式显示出来，反馈给用户。所以在编写游戏的时候，应将不同的功能放在相应的模块内，否则可能引起程序异常，或难以维护。例如在UI的部分中不能使用repaint()，该函数只能在Run()里被调用，否则游戏刷新可能异常。 需要实现程序的PauseApp方法，处理接打电话的问题。 程序中尽量使用简洁、清晰的算法，不要使用复杂、冗长的算法与代码。 在提交程序的时候，应把一切不必要的输出、检测等语句注释掉，以加快程序速度，并减小程序容量。 游戏中有STATE_XX状态表示APP状态，有GAME_STATE_XX表示游戏中的状态，大家应尽量清楚的使用这些状态。同时