个人笔记整理
Android基础、项目目录结构
项目结构
Project
-
.gradle和.idea:这两个目录下放置的都是Android Studio自动生成的一些文件,我们无须关心,也不要去手动编辑。
-
app:项目中的代码、资源等内容几乎都是放置在这个目录下的,开发工作也基本都是在这个目录下进行的。
-
build:这个目录你也不需要过多关心,它主要包含了一些在编译时自动生成的文件。
-
gradle:这个目录下包含了gradle wrapper的配置文件,使用gradle wrapper的方式不需要提前将gradle下载好,而是会自动根据本地的缓存情况决定是否需要联网下载gradle。Android Studio默认没有启用gradlewrapper的方式,如果需要打开,可以点击Android Studio导航栏→File→Settings→Build, Execution,Deployment→Gradle,进行配置更改。
-
.gitignore:这个文件是用来将指定的目录或文件排除在版本控制之外的
-
build.gradle:这是项目全局的gradle构建脚本,通常这个文件中的内容是不需要修改的。
-
gradle.properties:这个文件是全局的gradle配置文件,在这里配置的属性将会影响到项目中所有的gradle编译脚本。
-
gradlew和gradlew.bat:这两个文件是用来在命令行界面中执行gradle命令的,其中gradlew是在Linux或Mac系统中使用的,gradlew.bat是在Windows系统中使用的。
-
HelloWorld.iml:
iml文件是所有IntelliJ IDEA项目都会自动生成的一个文件(Android Studio是基于IntelliJ IDEA开发的),用于标识这是一个IntelliJ IDEA项目,我们不需要修改这个文件中的任何内容。 -
local.properties:这个文件用于指定本机中的Android SDK路径,通常内容都是自动生成的,我们并不需要修改。除非你本机中的Android SDK位置发生了变化,那么就将这个文件中的路径改成新的位置即可。
-
settings.gradle:
这个文件用于指定项目中所有引入的模块。由于HelloWorld项目中就只有一个app模块,因此该文件中也就只引入了app这一个模块。通常情况下模块的引入都是自动完成的,需要我们手动去修改这个文件的场景可能比较少。
app目录
-
build:这个目录和外层的build目录类似,主要也是包含了一些在编译时自动生成的文件,不过它里面的内容会更多更杂,我们不需要过多关心。
-
libs:如果你的项目中使用到了第三方jar包,就需要把这些jar包都放在libs目录下,放在这个目录下的jar包都会被自动添加到构建路径里去。
-
androidTest:此处是用来编写Android Test测试用例的,可以对项目进行一些自动化测试。
-
java:毫无疑问,java目录是放置我们所有Java代码的地方,展开该目录,你将看到我们刚才创建的HelloWorldActivity文件就在里面。
-
res:这个目录下的内容就有点多了。简单点说,就是你在项目中使用到的所有图片、布局、字符串等资源都要存放在这个目录下。当然这个目录下还有很多子目录,图片放在
drawable目录下,布局放在layout目录下,字符串放在values目录下,所以你不用担心
会把整个res目录弄得乱糟糟的。 -
AndroidManifest.xml:这是你整个Android项目的配置文件,你在程序中定义的所有四大组件都需要在这个文件里注册,另外还可以在这个文件中给应用程序添加权限声明。
-
test:此处是用来编写Unit Test测试用例的,是对项目进行自动化测试的另一种方式。
-
.gitignore:这个文件用于将app模块内的指定的目录或文件排除在版本控制之外,作用和外层的.gitignore文件类似。
-
app.iml:IntelliJ IDEA项目自动生成的文件,我们不需要关心或修改这个文件中的内容。
-
build.gradle:这是app模块的gradle构建脚本,这个文件中会指定很多项目构建相关的配置。
-
proguard-rules.pro:这个文件用于指定项目代码的混淆规则,当代码开发完成后打成安装包文件,如果不希望代码被别人破解,通常会将代码进行混淆,从而让破解者难以阅读。
build.gradle文件
HelloWorld项目中有两个build.gradle文件,一个是在最外层目录下的,一个是在app目录下的。
最外层目录build.gradle
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.0'
}
}
allprojects {
repositories {
jcenter()
}
}
两处repositories
的闭包中都声明了jcenter()
jcenter是一个代码托管仓库,很多Android开源项目都会选择将代码托管到jcenter上,声明了这行配置之后,我们就可以在项目中轻松引用任何jcenter上的开源项目。
dependencies 闭包中使用classpath声明了一个Gradle插件来构建Android项目,声明
com.android.tools.build:gradle:2.2.0
这个插件。其中,最后面的部分是插件的版本号,为2.2.0
app内部build.gradle
apply plugin: 'com.android.application' // 应用插件
android {
compileSdkVersion 24 // 指定项目的编译版本
buildToolsVersion "24.0.2" // 指定项目构建工具的版本
defaultConfig {
applicationId "com.example.helloworld" // 指定项目的包名
minSdkVersion 15 // 指定项目最低兼容的Android系统版本
targetSdkVersion 24 // 指定的值表示你在该目标版本上已经做过了充分的测试,会启用该版本的新特性(目标版本)
versionCode 1 // 指定项目的版本号
versionName "1.0" // 指定项目的版本名
}
buildTypes {
release {
minifyEnabled false // 指定是否对项目的代码进行混淆,true 表示混淆,false 表示不混淆
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
// proguardFiles 用于指定混淆时使用的规则文件,这里指定了两个文件
// 第一个proguard-android.txt 是在Android SDK目录下的,里面是所有项目通用的混淆规则;
// 第二个proguard-rules.pro 是在当前项目的根目录下的,里面可以编写当前项目特有的混淆规则
}
}
}
dependencies { // 指定当前项目所有的依赖关系
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:24.2.1'
testCompile 'junit:junit:4.12'
}
-
第一行
apply plugin
应用了一个插件,一般有两种值可选:com.android.application
表示这是一个应用程序模块,com.android.library
表示这是一个库模块。应用程序模块和库模块的最大区别在于,一个是可以直接运行的,一个只能作为代码库依附于别的应用程序模块来运行 -
dependencies
依赖:-
通常Android Studio项目一共有3种依
赖方式:本地依赖、库依赖和远程依赖。- 本地依赖可以对本地的Jar包或目录添加依赖关系
- 库依赖可以对项目中的库模块添加依赖关系
- 远程依赖则可以对jcenter库上的开源项目添加依赖关系。
-
观察一下
dependencies
闭包中的配置,第一行的compile fileTree
就是一个本地依赖声明,它表示将libs
目录下所有.jar后缀的文件都添加到项目的构建路径当中。 -
而第二行的compile则是远程依赖声明,
com.android.support:appcompat-v7:24.2.1
就是一个标准的远程依赖库格式,其中com.android.support
是域名部分,用于和其他公司的库做区分;appcompat-v7
是组名称,用于和同一个公司中不同的库做区分;24.2.1
是版本号,用于和同一个库不同的版本做区分。加上这句声明后,Gradle在构建项目时会首先检查一下本地是否已经有这个库的缓存,如果没有的话则会去自动联网下载,然后再添加到项目的构建路径当中。
-
库依赖声明这里没有用到,它的基本格式是
compile project 后面加上要依赖的库名称
,比如说有一个库模块的名字叫helper,那么添加这个库的依赖关系只需要加入compile project(':helper')
这句声明即可。 -
另外剩下的一句testCompile 是用于声明测试用例库的,这个我们暂时用不到,先忽略它就可以了
-
res资源目录
- 所有以drawable开头的文件夹都是用来放图片的
- 所有以mipmap开头的文件夹都是用来放应用图标的
- 所有以values开头的文件夹都是用来放字符串、样式、颜色等配置的
- layout文件夹是用来放布局文件的
mipmap开头的文件夹,其实主要是为了让程序能够更好地兼容各种设备。drawable文件夹也是相同的道理,虽然Android Studio没有帮我们自动生成,但是我们应该自己创建drawable-hdpi、drawable-xhdpi、drawable-xxhdpi等文件夹
string.xml字符串资源
<resources>
<string name="app_name">HelloWorld</string>
</resources>
当需要引用时
- 在代码中通过
R.string.app_name
可以获得该字符串的引用。 - 在XML中通过
@string/app_name
可以获得该字符串的引用。
日志工具使用
使用Android的日志工具Log
Android中的日志工具类是Log(android.util.Log),这个类中提供了如下5个方法来供我们打印日志。
Log.v()
。用于打印那些最为琐碎的、意义最小的日志信息。对应级别verbose
,是Android日志里面级别最低的一种。Log.d()
。用于打印一些调试信息,这些信息对你调试程序和分析问题应该是有帮助的。对应级别debug
,比verbose高一级。Log.i()
。用于打印一些比较重要的数据,这些数据应该是你非常想看到的、可以帮你分析用户行为数据。对应级别info
,比debug高一级。Log.w()
。用于打印一些警告信息,提示程序在这个地方可能会有潜在的风险,最好去修复一下这些出现警告的地方。对应级别warn
,比info高一级。Log.e()
。用于打印程序中的错误信息,比如程序进入到了catch语句当中。当有错误信息打印出来的时候,一般都代表你的程序出现严重问题了,必须尽快修复。对应级别error
,比warn高一级