[最新] Android 代码规范大全(Android开发速看),2024年最新最新Android开发进阶

资源文件命名为全部小写,采用下划线命名法。

3.5.1 动画资源文件(anim/ 和 animator/)

安卓主要包含属性动画和视图动画,其视图动画包括补间动画和逐帧动画。属性动画文件需要放在 res/animator/ 目录下,视图动画文件需放在 res/anim/ 目录下。命名规则:{模块名_}逻辑名称

说明:{} 中的内容为可选,逻辑名称 可由多个单词加下划线组成。例如:refresh_progress.xmlmarket_cart_add.xmlmarket_cart_remove.xml

如果是普通的补间动画或者属性动画,可采用:动画类型_方向 的命名方式。

例如:

| 名称 | 说明 |

| — | — |

| fade_in | 淡入 |

| fade_out | 淡出 |

| push_down_in | 从下方推入 |

| push_down_out | 从下方推出 |

| push_left | 推向左方 |

| slide_in_from_top | 从头部滑动进入 |

| zoom_enter | 变形进入 |

| slide_in | 滑动进入 |

| shrink_to_middle | 中间缩小 |

3.5.2 颜色资源文件(color/)

color/ 是专门用于存放颜色相关资源的文件夹。命名规则:类型{_模块名}_逻辑名称

说明:{} 中的内容为可选。例如:sel_btn_font.xml

颜色资源也可以放于 res/drawable/ 目录,引用时则用 @drawable 来引用,但不推荐这么做,最好还是把两者分开。

3.5.3 图片资源文件(drawable/ 和 mipmap/)

res/drawable/ 目录下放的是位图文件(.png、.9.png、.jpg、.gif)或编译为可绘制对象资源子类型的 XML 文件,而 res/mipmap/ 目录下放的是不同密度的启动图标,所以 res/mipmap/ 只用于存放启动图标,其余图片资源文件都应该放到 res/drawable/ 目录下。

命名规则:类型{_模块名}_逻辑名称类型{_模块名}_颜色

说明:{} 中的内容为可选;类型 可以是可绘制对象资源类型,也可以是控件类型最后可加后缀 _small 表示小图,_big 表示大图。

例如:

| 名称 | 说明 |

| — | — |

| btn_main_about.png | 主页关于按键 类型_模块名_逻辑名称 |

| btn_back.png | 返回按键 类型_逻辑名称 |

| divider_maket_white.png | 商城白色分割线 类型_模块名_颜色 |

| ic_edit.png | 编辑图标 类型_逻辑名称 |

| bg_main.png | 主页背景 类型_逻辑名称 |

| btn_red.png | 红色按键 类型_颜色 |

| btn_red_big.png | 红色大按键 类型_颜色 |

| ic_avatar_small.png | 小头像图标 类型_逻辑名称 |

| bg_input.png | 输入框背景 类型_逻辑名称 |

| divider_white.png | 白色分割线 类型_颜色 |

| bg_main_head.png | 主页头部背景 类型_模块名_逻辑名称 |

| def_search_cell.png | 搜索页面默认单元图片 类型_模块名_逻辑名称 |

| ic_more_help.png | 更多帮助图标 类型_逻辑名称 |

| divider_list_line.png | 列表分割线 类型_逻辑名称 |

| sel_search_ok.xml | 搜索界面确认选择器 类型_模块名_逻辑名称 |

| shape_music_ring.xml | 音乐界面环形形状 类型_模块名_逻辑名称 |

如果有多种形态,如按钮选择器:sel_btn_xx.xml,采用如下命名:

| 名称 | 说明 |

| — | — |

| sel_btn_xx | 作用在 btn_xx 上的 selector |

| btn_xx_normal | 默认状态效果 |

| btn_xx_pressed | state_pressed 点击效果 |

| btn_xx_focused | state_focused 聚焦效果 |

| btn_xx_disabled | state_enabled 不可用效果 |

| btn_xx_checked | state_checked 选中效果 |

| btn_xx_selected | state_selected 选中效果 |

| btn_xx_hovered | state_hovered 悬停效果 |

| btn_xx_checkable | state_checkable 可选效果 |

| btn_xx_activated | state_activated 激活效果 |

| btn_xx_window_focused | state_window_focused 窗口聚焦效果 |

注意:使用 Android Studio 的插件 SelectorChapek 可以快速生成 selector,前提是命名要规范。

3.5.4 布局资源文件(layout/)

命名规则:类型_模块名{模块名_}类型_逻辑名称。(也采用 PBF,方便查看,尤其在大项目中)

说明:{} 中的内容为可选。

例如:

| 类型 | 名称 | 说明 |

| — | — | — |

| Activity | main_activity.xml | 主窗体 模块名_类型 |

| Fragment | music_fragment.xml | 音乐片段 模块名_类型 |

| Dialog | loading_dialog.xml | 加载对话框 逻辑名称_类型 |

| PopupWindow | info_ppw.xml | 信息弹窗(PopupWindow) 逻辑名称_类型 |

| adapter 的列表项 | main_song_item.xml | 主页歌曲列表项 模块名_类型_逻辑名称 |

3.5.5 布局资源 id 命名

命名规则:{模块名_}_逻辑名_view 缩写(功能),例如: main_search_btnback_btn。此外,采用 Kotlinx 直接获取布局文件的时候,id 命名采用驼峰样式。

说明:{} 中的内容为可选。参考 GoogleSamples Demo:https://github.com/android/architecture-samples

例如:

| 类型 | 规范 | 命名示例 |

| — | — | — |

| TextView | xxx_text | user_login_text |

| EditText | xxx_edit | user_login_edit |

| ImageView | xxx_iv | user_login_iv |

| Button | xxx_btn | user_login_btn |

| CheckBox | xxx_cb | user_login_cb |

| GridView | xxx_gv | user_login_gv |

| ListView | xxx_lv | user_login_lv |

| RecyclerView | xxx_rv | user_login_rv |

| RadioButton | xxx_rb | user_login_rb |

| LinearLayout | xxx_ll | user_login_ll |

| RelativeLayout | xxx_rl | user_login_rl |

| FrameLayout | xxx_fl | user_login_fl |

| GridLayout | xxx_gl | user_login_gl |

| ConstraintLayout | xxx_cl | user_login_cl |

3.5.6 菜单资源文件(menu/)

菜单相关的资源文件应放在该目录下。命名规则:{模块名_}逻辑名称

说明:{} 中的内容为可选。例如:main_drawer.xmlnavigation.xml

3.5.7 colors.xml

<color>name 命名使用下划线命名法,在你的 colors.xml 文件中应该只是映射颜色的名称一个 ARGB 值,而没有其它的。不要使用它为不同的按钮来定义 ARGB 值。

例如,不要像下面这样做:

#FFFFFF

#2A91BD

#5F5F5F

#939393

#FFFFFF

#FF9D2F

#323232

使用这种格式,会非常容易重复定义 ARGB 值,而且如果应用要改变基色的话会非常困难。同时,这些定义是跟一些环境关联起来的,如 button 或者 comment,应该放到一个按钮风格中,而不是在 colors.xml 文件中。

相反,应该这样做:

#FFFFFF

#DBDBDB

#939393

#5F5F5F

#323232

#27D34D

#2A91BD

#FF9D2F

#FF432F

向应用设计者那里要这个调色板,名称不需要跟 "green""blue" 等等相同。"brand_primary""brand_secondary""brand_negative" 这样的名字也是完全可以接受的。像这样规范的颜色很容易修改或重构,会使应用一共使用了多少种不同的颜色变得非常清晰。通常一个具有审美价值的 UI 来说,减少使用颜色的种类是非常重要的。

注意:如果某些颜色和主题有关,那就单独写一个 colors_theme.xml

3.5.8 strings.xml

<string>name 命名使用下划线命名法,采用以下规则:{模块名_}逻辑名称,这样方便同一个界面的所有 string 都放到一起,方便查找。

| 名称 | 说明 |

| — | — |

| main_menu_about | 主菜单按键文字 |

| friend_title | 好友模块标题栏 |

| friend_dialog_del | 好友删除提示 |

| login_check_email | 登录验证 |

| dialog_title | 弹出框标题 |

| button_ok | 确认键 |

| loading | 加载文字 |

3.5.9 styles.xml

<style>name 命名使用大驼峰命名法,几乎每个项目都需要适当的使用 styles.xml 文件,因为对于一个视图来说,有一个重复的外观是很常见的,将所有的外观细节属性(colorspaddingfont)放在 styles.xml 文件中。在应用中对于大多数文本内容,最起码你应该有一个通用的 styles.xml 文件,例如:

应用到 TextView 中:

<TextView

android:layout_width=“wrap_content”

android:layout_height=“wrap_content”

android:text=“@string/price”

style=“@style/ContentText”/>

或许你需要为按钮控件做同样的事情,不要停止在那里,将一组相关的和重复 android:xxxx 的属性放到一个通用的 <style> 中。

4. Android 的注释规范

====================================================================================

4.1 类注释


每个类完成后应该有作者姓名和联系方式的注释,对自己的代码负责。

/**

  • author : nanchen
    
  • e-mail : xxx@xx
    
  • time   : 2021/01/18
    
  • desc   : xxxx 描述
    
  • version: 1.0
    

*/

public class WelcomeActivity {

}

具体可以在 AS 中自己配制,进入 Settings -> Editor -> File and Code Templates -> Includes -> File Header,输入

/**

  • author : ${USER}
    
  • e-mail : xxx@xx
    
  • time   : ${YEAR}/${MONTH}/${DAY}
    
  • desc   :
    
  • version: 1.0
    

*/

这样便可在每次新建类的时候自动加上该头注释。

4.2 方法注释


每一个成员方法(包括自定义成员方法、覆盖方法、属性方法)的方法头都必须做方法头注释,在方法前一行输入 /** + 回车 或者设置 Fix doc comment(Settings -> Keymap -> Fix doc comment)快捷键,AS 便会帮你生成模板,我们只需要补全参数即可,如下所示。@param , @return , @throws , @deprecated 这 4 种标记出现的时候,描述都不能为空。当描述无法在一行中容纳,连续行至少需要再缩进 4 个空格。

/**

  • Report an accessibility action to this view’s parents for delegated processing.

  • Implementations of {@link #performAccessibilityAction(int, Bundle)} may internally

  • call this method to delegate an accessibility action to a supporting parent. If the parent

  • returns true from its

  • {@link ViewParent#onNestedPrePerformAccessibilityAction(View, int, android.os.Bundle)}

  • method this method will return true to signify that the action was consumed.

  • This method is useful for implementing nested scrolling child views. If

  • {@link #isNestedScrollingEnabled()} returns true and the action is a scrolling action

  • a custom view implementation may invoke this method to allow a parent to consume the

  • scroll first. If this method returns true the custom view should skip its own scrolling

  • behavior.

  • @param action Accessibility action to delegate

  • @param arguments Optional action arguments

  • @return true if the action was consumed by a parent

*/

public boolean dispatchNestedPrePerformAccessibilityAction(int action, Bundle arguments) {

for (ViewParent p = getParent(); p != null; p = p.getParent()) {

if (p.onNestedPrePerformAccessibilityAction(this, action, arguments)) {

return true;

}

}

return false;

}

4.3 块注释


块注释与其周围的代码在同一缩进级别。它们可以是 /* ... */ 风格,也可以是 // ... 风格(// 后最好带一个空格)。对于多行的 /* ... */ 注释,后续行必须从 * 开始, 并且与前一行的 * 对齐。以下示例注释都是 OK 的。

/*

  • This is okay.

*/

// And so

// is this.

/* Or you can

  • even do this. */

注释不要封闭在由星号或其它字符绘制的框架里。

Tip:在写多行注释时,如果你希望在必要时能重新换行(即注释像段落风格一样),那么使用

/* ... */

比如:

4.4 全局变量的注释


全局变量的注释样式如下(注意注释之间有空格):

/**

  • The next available accessibility id.

*/

private static int nextAccessibilityViewId;

/**

  • The animation currently associated with this view.

*/

protected Animation currentAnimation = null;

4.5 其他一些注释


AS 已帮你集成了一些注释模板,我们只需要直接使用即可,在代码中输入 TODOFIXME 等这些注释模板,回车后便会出现如下注释。

// TODO: 17/3/14 需要实现,但目前还未实现的功能的说明

// FIXME: 17/3/14 需要修正,甚至代码是错误的,不能工作,需要修复的说明

4.5 注释必须遵守的规范


4.5.1 不言自明的方法不要加注释。

比如 Item getItem(int index) 是一段自说明的代码,我们可以直接从方法的命名就能知道它是干嘛的,所以不需要增加注释。

4.5.2 提测的代码不应该有 TODO 这样的注释

5. 代码样式规范

=============================================================================

5.1 使用标准大括号样式


左大括号不单独占一行,与其前面的代码位于同一行:

class MyClass {

int func() {

if (something) {

// …

} else if (somethingElse) {

// …

} else {

// …

}

}

}

我们需要在条件语句周围添加大括号。例外情况:如果整个条件语句(条件和主体)适合放在同一行,那么您可以(但不是必须)将其全部放在一行上。例如,我们接受以下样式:

if (condition) {

body();

}

同样也接受以下样式:

if (condition) body();

但不接受以下样式:

if (condition)

body(); // bad!

5.2 编写简短方法


在可行的情况下,尽量编写短小精炼的方法。我们了解,有些情况下较长的方法是恰当的,因此对方法的代码长度没有做出硬性限制。如果某个方法的代码超出 40 行,请考虑是否可以在不破坏程序结构的前提下对其拆解。

5.3 类成员的顺序


这并没有唯一的正确解决方案,但如果都使用一致的顺序将会提高代码的可读性,推荐使用如下排序:

  1. 常量(Kotlin 伴生对象放在开头)

  2. 字段

  3. 构造函数

  4. 重写函数和回调

  5. 公有函数

  6. 私有函数

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
img
img
img
img
img
img
img

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!

由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新

如果你觉得这些内容对你有帮助,可以添加V获取:vip204888 (备注Android)
img

最后

感谢您的阅读,在文末给大家准备一个福利。本人从事Android开发已经有十余年,算是一名资深的移动开发架构师了吧。根据我的观察发现,对于很多初中级Android工程师而言,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长且无助。

所以在此将我十年载,从萌新小白一步步成长为Android移动开发架构师的学习笔记,从Android四大组件到手写实现一个架构设计,我都有一一的对应笔记为你讲解。

当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯,一定要学会把好的东西,归纳整理,然后系统的消化吸收,这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西,我觉得最没有价值的。就好比你给我一张扑克牌,我只会觉得它是一张废纸,但如果你给我一副扑克牌,它便有了它的价值。这和我们收集资料就要收集那些系统化的,是一个道理。

最后,赠与大家一句诗,共勉!

不驰于空想,不骛于虚声。不忘初心,方得始终。

一个人可以走的很快,但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎扫码加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
img
本涵盖了95%以上Android开发知识点,真正体系化!**

由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新

如果你觉得这些内容对你有帮助,可以添加V获取:vip204888 (备注Android)
[外链图片转存中…(img-KQwBXn7f-1712679498484)]

最后

感谢您的阅读,在文末给大家准备一个福利。本人从事Android开发已经有十余年,算是一名资深的移动开发架构师了吧。根据我的观察发现,对于很多初中级Android工程师而言,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长且无助。

所以在此将我十年载,从萌新小白一步步成长为Android移动开发架构师的学习笔记,从Android四大组件到手写实现一个架构设计,我都有一一的对应笔记为你讲解。

当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯,一定要学会把好的东西,归纳整理,然后系统的消化吸收,这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西,我觉得最没有价值的。就好比你给我一张扑克牌,我只会觉得它是一张废纸,但如果你给我一副扑克牌,它便有了它的价值。这和我们收集资料就要收集那些系统化的,是一个道理。

[外链图片转存中…(img-coCi4jhT-1712679498484)]

最后,赠与大家一句诗,共勉!

不驰于空想,不骛于虚声。不忘初心,方得始终。

一个人可以走的很快,但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎扫码加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
[外链图片转存中…(img-eymoqcUt-1712679498485)]

  • 13
    点赞
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值