请使用 UTF-8 格式来查看代码,避免出现中文乱码。
至于注释应该使用中文还是英文,请自己行决定,根据公司或项目的要求而定,推荐使用英文。
1. 整理代码
1.1. Java 代码中不允许出现警告,无法消除的警告要用 @SuppressWarnings。
1.2. 去掉无用的包、方法、变量等,减少僵尸代码。
1.3. 使用 Lint 工具来查看并消除警告和错误。
1.4. 使用 Ctrl+Shift+F 来格式化代码,然后再进行调整。
1.5. 使用 Ctrl+Shift+O 来格式化 Import 包。
2. 命名规则
2.1. 基本原则
2.1.1. 变量,方法,类命名要表义,严格禁止使用 name1, name2 等命名。
2.1.2. 命名不能太长,适当使用简写或缩写。(最好不要超过 25 个字母)
2.1.3. 方法名以小写字母开始,以后每个单词首字母大写。
2.1.4. 避免使用相似或者仅在大小写上有区别的名字。
2.1.5. 避免使用数字,但可用 2 代替 to,用 4 代替 for 等,如 go2Clean。
2.2. 类、接口
2.2.1. 所有单词首字母都大写。使用能确切反映该类、接口含义、功能等的词。一般采用名词。
2.2.2. 接口带 I 前缀,或able, ible, er等后缀。如ISeriable。
2.3. 字段、常量
2.3.1. 成员变量以 m 开头,静态变量以 s 开头,如 mUserName, sInstance。
2.3.2. 常量全部大写,在词与词之前用下划线连接,如 MAX_NUMBER。
2.3.3. 代码中禁止使用硬编码,把一些数字或字符串定义成常用量。
2.3.4. 对于废弃不用的函数,为了保持兼容性,通常添加 @Deprecated
3. 注释
请参考 下面示例类的注释。
4. Class 内部顺序和逻辑
4.1. 每个 class 都应该按照一定的逻辑结构来排列基成员变量、方法、内部类等, 从而达到良好的可读性。
4.2. 总体上来说,要按照先 public, 后 protected, 最后 private, 函数的排布 也应该有一个逻辑的先后顺序,由重到轻。
4.3. 以下顺序可供参考:
定义TAG,一般为 private(可选)
定义 public 常量
定义 protected 常量、内部类
定义 private 变量
定义 public 方法
定义 protected 方法
定义 private 方法
5. 表达式与语句
5.1. 基本原则:采用紧凑型风格来编写代码
5.2. 细则请参见示例类CodingRuler
代码如下 | 复制代码 |
/** * 文件名(可选),如 xxx.java * * 版本信息(可选),如:@version 1.0.0 * * 版权申明(开源代码一般都需要添加),如:Copyright (C) 2010-2014 xxx Corporation. */ package com.ntes.ruler; /** * 类的大体描述放在这里。 * * * @author 作者名 * @since 2014-XX-XX */ @SuppressWarnings("unused") public class CodingRuler { /** 公有的常量注释 */ public static final String ACTION_MAIN = "android.intent.action.MAIN"; /** 私有的常量注释(同类型的常量可以分块并紧凑定义) */ private static final int MSG_AUTH_NONE = 0; private static final int MSG_AUTH_SUCCESS = 1; private static final int MSG_AUTH_FAILED = 2; /** 保护的成员变量注释 */ protected Object mObject0; /** 私有的成员变量 mObject1 注释(同类型的成员变量可以分块并紧凑定义) */ private Object mObject1; /** 私有的成员变量 mObject2 注释 */ private Object mObject2; /** 私有的成员变量 mObject3 注释 */ private Object mObject3; /** * 对于注释多于一行的,采用这种方式来 定义该变量 */ private Object mObject4; /** * 公有方法描述... * * @param param1 * 参数1描述... * @param param2 * 参数2描述... * @param paramXX * 参数XX描述... (注意:请将参数、描述都对齐) */ public void doSomething(int param1, float param2, String paramXX) { // 以下注释标签可以通过Eclipse内置的Task插件看到 // TODO 使用TODO来标记代码,说明标识处有功能代码待编写 // FIXME 使用FIXME来标记代码,说明标识处代码需要修正,甚至代码是 // 错误的,不能工作,需要修复 // XXX 使用XXX来标记代码,说明标识处代码虽然实现了功能,但是实现 // 的方法有待商榷,希望将来能改进 } /** * 保护方法描述... */ @Deprecated protected void doSomething() { // ...implementation } /** * 私有方法描述... * * @param param1 * 参数1描述... * @param param2 * 参数2描述... */ private void doSomethingInternal(int param1, float param2) { // ...implementation } /** * 条件表达式原则。 */ private void conditionFun() { boolean condition1 = true; boolean condition2 = false; boolean condition3 = false; boolean condition4 = false; boolean condition5 = false; boolean condition6 = false; // 原则: 1. 所有 if 语句必须用 {} 包括起来,即便只有一句,禁止使用不带{}的语句 // 2. 在含有多种运算符的表达式中,使用圆括号来避免运算符优先级问题 // 3. 判断条件很多时,请将其它条件换行 if (condition1) { // ...implementation } if (condition1) { // ...implementation } else { // ...implementation } if (condition1) /* 禁止使用不带{}的语句 */ condition3 = true; if ((condition1 == condition2) || (condition3 == condition4) || (condition5 == condition6)) { } } /** * Switch语句原则。 */ private void switchFun() { // 原则: 1. switch 语句中,break 与下一条 case 之间,空一行 // 2. 对于不需要 break 语句的,请使用 /* Falls through */来标注 // 3. 请默认写上 default 语句,保持完整性 int code = MSG_AUTH_SUCCESS; switch (code) { case MSG_AUTH_SUCCESS: break; case MSG_AUTH_FAILED: break; case MSG_AUTH_NONE: /* Falls through */ default: break; } } /** * 循环表达式。 */ private void circulationFun() { // 原则: 1. 尽量使用for each语句代替原始的for语句 // 2. 循环中必须有终止循环的条件或语句,避免死循环 // 3. 循环要尽可能的短, 把长循环的内容抽取到方法中去 // 4. 嵌套层数不应超过3层, 要让循环清晰可读 int array[] = { 1, 2, 3, 4, 5 }; for (int data : array) { // ...implementation } int length = array.length; for (int ix = 0; ix < length; ix++) { // ...implementation } boolean condition = true; while (condition) { // ...implementation } do { // ...implementation } while (condition); } /** * 异常捕获原则。 */ private void exceptionFun() { // 原则: 1. 捕捉异常是为了处理它,通常在异常catch块中输出异常信息。 // 2. 资源释放的工作,可以放到 finally 块部分去做。如关闭 Cursor 等。 try { // ...implementation } catch (Exception e) { e.printStackTrace(); } finally { } } /** * 其它原则(整理中...)。 */ private void otherFun() { // TODO } } |
无觅相关文章插件,快速提升流量
由于Android的免费开源,使得Android手机快速占领市场,所以Android开发也如雨后春笋涌出,本人也想学学Android开发,所以在windows下找搭建个Android开发环境,不懂就问百度或Google,现在把搭建的过程写下做学习笔记,方便以后查看。一、下载相应的文件
1.android-sdk-windows
下载地址:http://developer.android.com/sdk/index.html
2.Eclipse IDE for Java EE Developers
下载地址:http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/heliossr1
二、安装
1.将android-sdk-windows解压到E:Program Filesandroid-sdk-windows。
2.将Eclipse IDE for Java EE Developers解压到E:Program FilesEclipse。
3.配置Eclipse
打开Eclipse,Help->Install New Software->Add
Name=Android Development Tools (ADT)
Location=http://dl-ssl.google.com/android/eclipse/
当安装完ADT插件后,在Eclipse的window菜单下会多出一个Android SDK And AVD Manager菜单项,在这个里你可以管理你的“虚拟设备”和“SDK包”。
android手机在获得root权限之后,可以调用命令的方式静默安装软件,这一点体验是很不错,但是目前网络上关于android静默安装app的代码均出自一人之手,其中有一个非常sb的bug,借用代码的人居然都没有发现,导致网络上几乎所有关于android app静默安装的代码都是错误的。
代码如下 | 复制代码 |
new Thread() { |
这个代码实际上也可以运行起来,在root的手机中,也可以静默安装成功,但是代码有问题就是bug,不知道哪一天这个有问题的代码就会出现错误
下面是修改之后的代码,修改了上面的bug
代码如下 | 复制代码 |
new Thread() { |
修改的地方就在于从输出流中读取输出数据,可以看出如果输出的数据大于缓存区大小(256),就会导致安装后的操作多次执行,上面这段错误的代码之所以可以运行,是在于输出流的输出为Success ,小于256,但是如果运行指令出错,返回一大推的错误,那么上面的那一段将读取所有的数据,读逐一进行比较。
iPhone6 plus来电闪光灯怎么设置呢,这个来电闪光灯功能默认是没有开启了,只有我们打开它之后才有这个功能,此功能也是非常的个性化的哦,下面一聚教程小编就为各位果粉介绍一下iPhone6 plus来电闪光灯设置方法吧。
好了到这里iPhone6 plus开关来电闪光灯教程就介绍到这里了,希望能帮助到各位。
在我安装、配置好PhoneGap项目的所有依赖后,试图执行
$ cordova run android
命令时,出现过如下错误。
Error: /home/sam/front/redwine/platforms/android/cordova/run: Command failed with exit code 8
at ChildProcess.whenDone (/usr/lib/node_modules/cordova/node_modules/cordova-lib/src/cordova/superspawn.js:135:23)
at ChildProcess.EventEmitter.emit (events.js:98:17)
at maybeClose (child_process.js:743:16)
at Process.ChildProcess._handle.onexit (child_process.js:810:5)
view rawphonegapError hosted with ❤ by GitHub
cordova build android或cordova emulate android的结果也是一样。
但其实真正的问题在上面几行:
[aapt] (skipping file '.jshintrc' due to ANDROID_AAPT_IGNORE pattern '.*')
[aapt] (skipping file '.bower.json' due to ANDROID_AAPT_IGNORE pattern '.*')
[aapt] (skipping file '.directory' due to ANDROID_AAPT_IGNORE pattern '.*')
[aapt] Unable to add '/home/sam/front/redwine/platforms/android/assets/www/bower_components/jquery-mobile/node_modules/grunt-bowercopy/node_modules/bower/node_modules/semver/semver.browser.js.gz': file already in archive (try '-u'?)
[aapt] ERROR: unable to process assets while packaging '/home/sam/front/redwine/platforms/android/ant-build/wine.ap_'
[aapt] ERROR: packaging of '/home/sam/front/redwine/platforms/android/ant-build/wine.ap_' failed
BUILD FAILED
/home/sam/bin/android-sdk-linux/tools/ant/build.xml:932: The following error occurred while executing this line:
/home/sam/bin/android-sdk-linux/tools/ant/build.xml:950: null returned: 1
view rawphonegapError2 hosted with ❤ by GitHub
这是因为项目下有多个node_modules目录,被重复打包而引发的Command failed with exit code 8问题。
解决办法是修改platforms/android/build.xml:
<property name="aapt.ignore.assets" value="<dir>node_*" />
将node_modules目录排除掉,就可以正常执行cordova命令。