Android&Java代码注释标准规范
Android/Java代码注释标准规范
（软件技术系徐铁强原创）
版权所有谢绝转载
1、文件头注释
每一个文件的文件头都必须做文件头注释。
文件头注释范例如下：
2、方法头注释
每一个成员方法（包括自定义成员方法、覆盖方法、属性方法）的方法头都必须做方法头注释。
自定义成员方法注释范例如下：
覆盖（重写）成员方法注释范例如下：
属性getter和setter成员方法注释范例如下：
3、块注释
在实现一段阶段性功能的代码前做块注释。
块注释的注释范例如下：
4、变量注释
所有的成员变量和大多数局部变量在声明时都需要为其做功能注释。
成员变量注释的注释范例如下：
局部变量注释的注释范例如下：
5、语句注释
在关键语句的右侧要做单条语句注释。
语句注释的注释范例如下：
6、有关注释的其它说明
（1）文件头和方法头注释应该使用/**/形式，变量注释和语句注释应该使用//形式，块注释应尽量使用//形式，当文字较长（单屏横向不能显示完全）时块注释也可以使用
/**/形式；
（2）注释量必须不少于代码总量的三分之一；。
第1章Android简介
1.4 Android体系结构
采用软件堆层的架构，共分为四层
1.4 Android体系结构
Linux内核
硬件和其他软件堆层之间的一个抽象隔离层 提供安全机制、内存管理、进程管理、网络协议堆栈、 和驱动程序等
1.4 Android体系结构
中间件层
由函数库和Android运行时构成 函数库，主要提供一组基于C/C++的函数库
软件厂商：Ascender Corp（美国）、eBay（美国）、 谷歌（美国）、LivingImage（日本）、 NuanceCommunications（美国）、Myraid（瑞士）、 Omron（日本）、PacketVideo（美国）、SkyPop（美国 ）、Svox（瑞士）和SONiVOX（美国）
1.4 Android体系结构
应用程序框架
Resource Manager，允许应用程序使用非代码资源 Location Manager，管理与地图相关的服务功能 Notification Manager，允许应用程序在状态栏中显示提 示信息
1.4 Android体系结构
应用程序
提供一系列的核心应用程序 包括电子邮件客户端、浏览器、通讯录和日历等
1.4 Android体系结构
中间件层
Android运行时
核心库，提供Android系统的特有函数功能和Java语 言函数功能 Dalvik虚拟机，实现基于Linux内核的线程管理和底层内存 管理
1.4 Android体系结构
应用程序框架
提供Android平台基本的管理功能和组件重用机制
Activity Manager，管理应用程序的生命周期 Windows Manager，启动应用程序的窗体 Content Provider，共享私有数据，实现跨进程的数据访问 Package Manager，管理安装在Android系统内的应用程序 Teleghony Manager，管理与拨打和接听电话的相关功能
Android概述
3、Android Runtime（Android 运行时） Android是包含一个核心库的集合，提供大 部分在Java编程语言核心类库中可用的功能。每 一个Android应用程序是Dalvik虚拟机中的实例， 运行在它们自己的进程中。Dalvik虚拟机依赖于 Linux 内核提供基本功能，来实现进程、内存和 文件系统管理等各种服务，可以在一个设备中高 效地运行多个虚拟机，可执行文件格式是.dex。 dex格式是专为Dalvik设计的一种压缩格式，占用 内存非常小，适合内存和处理器速度有限的系统。
2）、绑定服务（bindService）：把这个 Service 和调用 Service 的客户类绑起来，如果调 用这个客户类被销毁，Service 也会被销毁。用这 个方法的一个好处是，bindService() 方法执行后 Service 会回调上边提到的 onBind() 方发，可以 从这里返回一个实现了 IBind 接口的类，在客户 端操作这个类就能和这个服务通信了，比如得到 Service 运行的状态或其他操作。如果 Service 还 没有运行，使用这个方法启动 Service 就会 onCreate() 方法而不会调用 onStart()。
1、活动（Activity） 一个应用程序可能只包含一个活动，也可能 包含几个活动。这些活动是什么，以及有多少， 当然这取决于它的应用和设计。虽然他们一起工 作形成一个整体的用户界面，但是每个活动是独 立于其他活动的，每一个都是作为Activity父类的 一个子类。一般来讲，当应用程序被启动时，被 标记为第一个的活动应该展示给用户，从一个活 动移动到另一个活动由当前的活动完成。
1.2 Android发展历史
2005年Google收购了仅22个月的高科技企 业Android， 2007年正式向外界展示了Android操 作系统，2008年9月23日，谷歌发布Android1.0， 从此就有了今天风靡全球的Android。 Android用甜点作为它们系统版本的代号的 命名方法开始于 Andoird 1.5 发布的时候。作为 每个版本代表的甜点的尺寸越变越大，然后按照 26个字母数序：纸杯蛋糕，甜甜圈，松饼，冻酸 奶，姜饼，蜂巢，冰激凌三明治。
Android安卓是什么,详解安卓
Android安卓是什么，详解安卓Android一词的本义指“机器人”，同时也是Google于2007年11月5日宣布的基于Linux平台的开源手机操作系统的名称，该平台由操作系统、中间件、用户界面和应用软件组成，号称是首个为移动终端打造的真正开放和完整的移动软件。
目前，最新版本为Android 2.4 Gingerbread和Android 3.0 Honeycomb。
Android是基于Linux开放性内核的操作系统，是Google公司在2007年11月5日公布的手机操作系统。
早期由原名为"Android"的公司开发，谷歌在2005年收购"Android.Inc"后，继续进行对Android系统开发运营，它采用了软件堆层（software stack，又名软件叠层）的架构，主要分为三部分。
底层Linux内核只提供基本功能，其他的应用软件则由各公司自行开发，部分程序以Java编写。
2011年初数据显示，仅正式上市两年的操作系统Android已经超越称霸十年的塞班系统，使之跃居全球最受欢迎的智能手机平台。
现在，Android系统不但应用于智能手机，也在平板电脑市场急速扩张。
采用Android系统主要厂商包括台湾的HTC,(第一台谷歌的手机G1由HTC生产代工）美国摩托罗拉,SE等，中国大陆厂商如：华为、中兴、联想等。
系统版本很多玩家用户可能会奇怪：“为什么Android 会用甜点作为它们系统版本的代号？”这个命名方法开始于Andoird 1.5 发布的时候。
作为每个版本代表的甜点的尺寸越变越大，然后按照26个字母数序：纸杯蛋糕，甜甜圈，松饼，冻酸奶，姜饼，蜂巢。
Android 1.1发布时间：发布于2008 年9月Android 1.5 Cupcake纸杯蛋糕发布时间：发布于2009 年 5 月Android 1.6 Donut甜甜圈2009 年9 月发布Android 2.0 Eclair松饼2009 年10 月26 日Android 2.1 Eclair松饼Android 2.1: 2009 年10 月26 日，又一个主要版本升级以创纪录的速度放出。
第1章 Android基础入门(Anddroid)
在XML布局文件中调用名为app_name字符串资源 @string/app_name
✎ 1.5.5 颜色资源
颜色资源
– 定义位置：res/values/文件夹的colors.xml文件中 – colors.xml文件中的颜色资源
用于<定?xm义l 颜ver色sio资n=源"1的.0"标en签coding="utf-8"?>
19.6%
4.5K-6K
0.7%
20K-30K
29.8%
10K-15K
22.3%
6K-8K
2.8%
8K-10K
5.7%
￥18610
取自12554份样本可供参考 截止至2018年12月
数据来源：职友集
✎ 1.1.1 通信技术
通信技术
第一代通信技术（1G）：是指最初的模拟、仅限语音的蜂窝电话 标准。
使用AndroidStudio创建程序， 使用模拟器运行程序。
① 在Android Studio的Welcome to Android Studio窗 口中选择【Start a new Android Studio project】选 项创建项目
② 点击工具栏中【AVD Manager】标签启动模拟器
✎ 1.5.5 颜色资源
颜色资源
– 调用方式
➢ 通过Java代码调用颜色资源
在Activity的onCreate()方法中调用名为colorPrimary的颜色资源 getResources().getColor(R.color.colorPrimary);
➢ 在XML布局文件中调用布局资源文件
//在XML布局文件中调用activity_main.xml布局资源 <include layout="@layout/activity_main"/>
android来龙去脉
• 2008年，Patrick Brady于Google I/O演讲 “Anatomy & Physiology of an Android”，并 提出的Android HAL架构图。HAL以*.so档的 形式存在，可以把Android framework与 Linux kernel隔开，这种中介层的方式使得 Android能在移动设备上获得更高的运行效 率。这种独特的系统结构被Linux内核开发 者Greg Kroah-Hartman和其他内核维护者称 赞。
特点
• 显示布局 • Android操作系统支持更大的分辨率，VGA，2D显示，3D显示都 给予OpenGL ES 2.0标准规格，并且支持传统的智能手机。 • 数据存储 • Android操作系统内置SQLite小型关联式资料库管理系统来负责 存储数据。 • 网络 • Android操作系统支持所有的网络制式，包括GSM/EDGE、IDEN、 CDMA、EV-DO、UMTS、Bluetooth、Wi-Fi、LTE、NFC和WiMAX。 • 信息 • 作为原设计给智能手机使用的操作系统，Android操作系统原生 支持短信和邮件，并且支持所有的云信息和服务器信息。
• Android系统最初由安迪· 鲁宾（Andy Rubin）开 发制作，最初主要支持手机，于2005年8月被 美国科技企业Google收购。 • 2007年11月，Google与84家硬件制造商、软件 开发商及电信营运商成立开放手持设备联盟来 共同研发改良Android系统. • 随后，Google以Apache免费开源许可证的授权 方式，发布了Android的源代码。 • 让生产商推出搭载Android的智能手机， Android操作系统后来更逐渐拓展到平板电脑 及其他领域上。
第1章 Android基础入门
July 2012
KitKat
4.4 - 4.4.4
Oct 2013
Lollipop
5.0 - 5.1.1
Nov 2014
Marshmallow
6.0 - 6.0.1
Oct 2015
Nougat
7.0 - 7.1
Sept 2016
Oreo
8.0 - 8.1
Sept 2017
Pie
9.0
Aug 2018
2021/10/19
第1章 Android基础入门
7
智能手机操作系统市场份额
数据来源：https:///cn/smartphone-os-market-share/
2021/10/19
第1章 Android基础入门
8
Android的优势
基于开源技术 自由度高 选择多样化 广泛的开发群体
2021/10/19
第1章 Android基础入门
6
Android和iOS的区别
对比项目
Android
iOS
开发语言
Java、Kotlin
Objective-c、Swift
系统开放性 Android源码开放，开放性更好 封闭操作系统，开放性较差
系统安全性 源代码开放，安全性较差
封闭操作系统，安全性更高
Dalvik通过一组C核心库调用Linux内核的功能，同时基于Dalvik向上提供了一个 功能完备的SDK
为了能充分利用已有的基础，Android SDK尽量与Java SE保持一致，这使得 Android应用的开发与普通Java应用程序的开发高度类似
2021/10/19
第1章 Android基础入门
android工作职责(万能18篇)
android工作职责（万能18篇）android工作职责篇11、熟悉Java开发语言和环境，熟悉常用的网站开发架构和流程。
2、熟悉UI图形编程、基本算法和数据结构，熟悉基于TCP/UDP/HTTP的网络协议，了解HTML5技术;3、熟悉常用数据库软件的原理和使用，熟悉常用连接池组件，对数据库的优化有一定的理解。
具备良好合作态度及团队精神，并富有工作激情、创新欲望和责任感。
android工作职责篇21、广告前端SDK编程。
2、apk自动化打包工具编写。
职位要求：1、技术功底扎实，有2年及以上Android实际项目编程经验，有大型项目开发经验者优先。
2、理解apk打包原理，了解android工作基本原理，深入理解系统底层机制者优先。
3、了解系统api，对自定义通知栏，桌面悬浮窗口，gps，wifi热点列表抓取等功能实现熟悉并有实战经验。
4、具有良好的编辑风格和习惯，要求结构清晰，逻辑性强，代码冗余低。
5、有良好的沟通能力与理解能力，对工作有责任心。
6、有代码混淆及加密经验者优先。
android工作职责篇31、对Android的整体架构有较为深入的了解;2、精通Java开发语言，Eclipse开发工具，熟悉面向对象编程设计;3、熟悉AndroidUI控件编程，熟悉JNI/NDK，有过第三方库平台移植经验，有FFmpeg 开发经验者优先;4、熟悉Android下网络通信机制，对Socket、http通信有深刻的理解，熟悉Sqlite 数据库;5、熟悉Android多线程开发。
android工作职责篇41.半年以上的全职安卓开发经验2.熟悉安卓市场app上架流程,以及根据驳回理由处理app包问题3.精通安卓四大组件4.对androidui设计有丰富的经验,熟悉自定义控件,有ui优化实践更佳5.熟悉android网络开发,熟悉网络协议,熟悉sqlite数据库6.可以熟练处理各种机型、终端、os版本的适配的问题7.有较强的责任感和良好的团队合作精神及沟通能力android工作职责篇51.计算机相关专业毕业,本科及以上学历;2.熟练掌握java语言,有丰富的java项目开发经验;3.两年以上android软件全职开发工作经验,熟练掌握androidsdk,熟练掌握android 各种ui布局和控件;4.有c/c++使用经验、熟悉androidjni开发的优先。
《Android入门》课件
CHAPTER 04
Android用户界面设计
XML布局
01 线性布局（LinearLayout）：用于将子视 图按照垂直或水平方向排列。
02
相对布局（RelativeLayout）：允许子视 图相对于彼此或父视图进行定位。
03
框架布局（FrameLayout）：将子视图堆 叠在顶部，从左到右依次排列。
数据类型
网络存储可以保存任意类型 的数据，如文本、图片、音 频、视频等。
使用方法
使用网络存储需要先建立网 络连接，然后使用HTTP协 议进行数据的上传和下载操 作。
优点
数据可共享，可备份，对于 需要将数据保存在云端或者 与其他设备共享的场景非常 适用。
CHAPTER 06
调试和优化
Logcat的使用
123 4
概述
使用方法
过滤和搜索
Logcat是Android开发中 用于查看应用程序日志信 息的工具，可以帮助开发 者调试和优化应用程序。
通过Android Studio的 Logcat窗口查看日志信 息，包括Log级别（如 Verbose、Debug、Info 、Warningห้องสมุดไป่ตู้Error、 Fatal、Assert）、应用 程序标签和日志消息。
03
数据模型
Content Provider使用标准的数 据模型，如URI、Cursor等，来定
义和操作数据。
02
功能
Content Provider可以提供对数 据库、文件或其他类型数据的访
问。
04
安全性
Content Provider提供了数据访 问的安全性控制，只有具有相应
权限的应用才能访问数据。
安卓名词解释
另外还有一些热心网友自己进行美化或修改的 ROM ，一般都是基于原生 ROM 制作，也很受大家欢迎。
12：ROM 的选择
不同版本的 ROM 有不同的特点，稳定型，速度型，美观型，自己喜欢什么就选择什么，正所谓萝卜青菜各有所爱。
需要注意的是，同学们在刷机之前，要认真地查阅 此版本 ROM 的注意事项，个别情况下会出现不同 ROM 之间互不兼容的现象。
14：ROM（固件）版本
由于是谷歌公司在专门开发这个系统，官方放出的话必然是所有G友手机升级的风向标。
固件版本就是官方制定的基础系统，所有的改包都 会从官方的包开始改。
所以官方的一次升级必然会影响整个手机系统的使用情况。
就像现在大家都在用XP，微软放出了一个补丁包，于 是大家都去升级了。
2：电子市场(Android Market)
Android电子市场(Android Market)是Google为Android设备开发的在线应用程序商店。它和苹果的App Store类似，用户可以在此浏览、下载、安装使用到成千上万的各式应用程序，有软件，有游戏，有免费程序，也有收费程序。与微软和苹果应用市场不同，Android电子市场可以为用户提供多样化的内容，既有来自各大媒体公司的内容，也有来自业余个人开发者的程序。
什么是android系统
什么是android系统什么是android系统？它的特征有哪些？安卓系统早期由原名为"Android"的公司开发，谷歌在 2005年收购"Android.Inc"后，继续对安卓系统开发运营，它采用了软件堆层(software stack，又名软件叠层)的架构，主要分为三部分。
底层Linux内核只提供基本功能，其他的应用软件则由各公司自行开发，部分程序以Java编写。
安卓系统特征主要如下：1、开放性。
在优势方面，安卓平台首先就是其开放性，开放的平台允许任何移动终端厂商加入到Android联盟中来。
显著的开放性可以使其拥有更多的开发者，随着用户和应用的日益丰富，一个崭新的平台也将很快走向成熟。
2、挣脱束缚。
在过去很长的一段时间，特别是在欧美地区，手机应用往往受到运营商制约，使用什么功能接入什么网络，几乎都受到运营商的控制。
自从 iPhone上市，用户可以更加方便地连接网络，运营商的制约减少。
随着EDGE、HSDPA这些2G至3G移动网络的逐步过渡和提升，手机随意接入网络已不是运营商口中的笑谈。
3、丰富的硬件。
这一点还是与安卓平台的开放性相关，由于Android的开放性，众多的厂商会推出千奇百怪，功能特色各具的多种产品。
4、开发商。
安卓平台提供给第三方开发商一个十分宽泛、自由的环境。
因此不会受到各种条条框框的阻挠，可想而知，会有多少新颖别致的软件会诞生。
但也有其两面性，血腥、暴力、**方面的程序和游戏如何控制正是留给Android难题之一。
5、Google应用。
从搜索巨人到全面的互联网渗透，Google服务如地图、邮件、搜索等已经成为连接用户和互联网的重要纽带，而安卓平台手机将无缝结合这些优秀的Google服务。
安卓详细内容介绍：Android是一种以Linux为基础的开放源代码操作系统，主要使用于便携设备。
中国地区较多人使用“安卓”。
Android 操作系统最初由Andy Rubin开发，最初主要支持手机。