最近在学习《第一行代码 Android》,两天看书把所有代码都敲了一遍。由于之前没有接触过 Kotlin,导致了囫囵吞枣,跟着书会敲,离开就忘了。Android 大佬开发的各种框架、控件好像大部分都用了 Kotlin。看他们的源码,理解起来很困难。所以好记性不如烂笔头,还是得整理笔记,形成全局思维,才能解决开发项目中出的各种问题。
Android 开发最麻烦的一件事就是版本问题,基本上打开第三方项目,很难一键运行起来,在此记录下配置,方便后续迷糊的时候翻看。
+ Activity, Service, BroadcastReceiver, ContentProvider
这里由于某些原因,需要配置国内源
settings.gradle(project)中添加:
pluginManagement {
repositories {
google()
mavenCentral()
gradlePluginPortal()
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven {
url 'https://maven.aliyun.com/repository/google'
}
maven {
url 'https://maven.aliyun.com/repository/jcenter'
}
maven {
url "https://maven.aliyun.com/repository/public"
}
maven {
url 'https://developer.huawei.com/repo/'
}
maven {
url "https://jitpack.io"
}
google()
mavenCentral()
}
}
rootProject.name = "LoginDemo"
include ':app'
在 Android Studio 2022(Flamingo),创建项目时,如果使用“Empty Activity”,会给你加 compose 类的东西,没怎么用过,只能使用“No Activity”,之后再手动添加 Activity。
项目结构
- .gradle 和 .idea
.gradle 和 .idea 是 Android Studio 创建的项目中的两个隐藏文件夹,它们的作用如下:
.gradle 文件夹:这个文件夹是 Gradle 构建系统的一部分,用于存储与 Gradle 构建相关的临时文件。这包括构建脚本的缓存、下载的依赖项的缓存、构建的临时文件等。这个文件夹的内容通常不需要手动管理,Gradle 会自动处理。
.idea 文件夹:这个文件夹是 IntelliJ IDEA(Android Studio 的基础)的项目配置文件夹。它包含了许多与项目设置、模块、代码样式、版本控制等相关的配置文件。这个文件夹的内容通常也不需要手动管理,Android Studio 会自动处理。
这两个文件夹通常不会被包含在版本控制系统中,因为它们包含的是特定于本地环境的信息.
- app
app:这是项目的主模块目录,它包含了应用程序的源代码、资源文件、构建脚本等。
- gradle
gradle:这个目录包含了 Gradle Wrapper 的 JAR 文件和属性文件。
Gradle Wrapper 是一个独立的小型程序,它可以自动下载和安装正确版本的 Gradle。
- .gitignore
.gitignore:这个文件是 Git 版本控制系统的配置文件,它定义了哪些文件或目录不应被添加到 Git 仓库中。
- build.gradle
这个文件定义了对所有模块都有效的构建配置,例如 Gradle 插件版本、仓库地址等。此外,它还可以定义一些在所有模块中共享的变量。
- gradle.properties
gradle.properties:这个文件是 Gradle 的配置文件,它可以包含一些用于配置 Gradle 构建环境的属性。
- gradlew 和 gradlew.bat
gradlew 和 gradlew.bat:这两个文件是 Gradle Wrapper 的脚本,分别用于 Unix/Linux 和 Windows 系统。通过这些脚本,你可以在没有安装 Gradle 的情况下运行 Gradle 构建。
- local.properties
local.properties:这个文件包含了本地环境特定的设置,如 Android SDK 的路径。这个文件通常不应被添加到版本控制系统中。
- settings.gradle
settings.gradle:这个文件定义了哪些模块应该被包含在构建中。在一个多模块的项目中,每个模块都应该在这个文件中被声明
- build
app 模块编译时自动生成的文件- libs
第三方jar包,放在这个目录下的jar包会被自动添加到项目的构建路径里- src/androidTest
编写测试用例- src/java
主战场,都是在这写代码- res
资源目录包括布局、主题、图片、字符串等。- AndroidManifest.xml
整个Android项目的配置文件。在这可以添加权限声明、四大组件注册等。- test
用来编写 Unit Test测试用例。- gitignore
git 版本控制忽略的文件配置- build.gradle
app 模块的gradle构建脚本- proguard-rules.pro
配置项目代码的混淆规则
在 Android 项目中,res 目录是用于存放所有的资源文件,包括图片、布局文件、字符串、样式等。以下是 res 目录下的一些常见子目录及其作用:
const val TAG:String = "MainActivity"
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// 日志工具
Log.v(TAG,"MainActivity 执行 onCreate 方法")
Log.i(TAG,"MainActivity 执行 onCreate 方法")
Log.d(TAG,"MainActivity 执行 onCreate 方法")
Log.w(TAG,"MainActivity 执行 onCreate 方法")
Log.e(TAG,"MainActivity 执行 onCreate 方法")
}
}
app/src/androidTest 和 app/src/test 是 Android 项目中的两个目录,它们分别用于存放 Android Instrumented 测试和单元测试的代码。
app/src/androidTest:这个目录用于存放 Android Instrumented 测试的代码。这些测试运行在 Android 设备或模拟器上,它们可以访问 Android 系统服务,可以测试 Android 的用户界面交互,也可以测试与 Android 系统交互的代码。由于这些测试需要 Android 环境,所以运行它们需要启动 Android 设备或模拟器。
app/src/test:这个目录用于存放单元测试的代码。这些测试运行在 JVM 上,不需要 Android 环境。它们通常用于测试不依赖 Android 系统的代码,例如你的业务逻辑、数据处理等。由于这些测试不需要 Android 环境,所以运行它们不需要启动 Android 设备或模拟器,速度通常会比 Android Instrumented 测试快。
这就是 app/src/androidTest 和 app/src/test 的主要区别。
pluginManagement 和 dependencyResolutionManagement 都是 Gradle 的配置块,它们的 repositories 配置块用于指定仓库源,但是它们的作用范围和用途有所不同。
pluginManagement 中的 repositories 是用来配置 Gradle 插件的仓库源。当你在 plugins 块中使用插件时,Gradle 会从这些仓库中查找和下载插件。这个配置对所有的项目(包括子项目)都有效。
dependencyResolutionManagement 中的 repositories 是用来配置项目依赖的仓库源。当你在 dependencies 块中声明依赖时,Gradle 会从这些仓库中查找和下载依赖。这个配置在 Gradle 7.0 中引入,用于统一管理多项目构建中的仓库配置,避免在每个子项目中重复配置仓库。
总的来说,pluginManagement 中的 repositories 用于管理插件的仓库,而 dependencyResolutionManagement 中的 repositories 用于管理依赖的仓库。
- 引入了 dependencyResolutionManagement 配置块:这是一个新的配置块,用于统一管理多项目构建中的仓库配置,避免在每个子项目中重复配置仓库。在这个配置块中,你可以设置 repositories 来指定项目依赖的仓库源,Gradle 会从这些仓库中查找和下载依赖。
- 引入了 repositoriesMode 配置:这是一个新的配置项,用于控制项目仓库的行为。它有两个可选值:RepositoriesMode.FAIL_ON_PROJECT_REPOS 和 RepositoriesMode.PREFER_PROJECT. 前者表示如果在项目中发现了仓库配置,那么构建将会失败;后者表示如果在项目中发现了仓库配置,那么这些仓库将会被添加到解析依赖时使用的仓库列表中。
- pluginManagement 配置块的行为没有变化:这个配置块用于配置 Gradle 插件的仓库源。当你在 plugins 块中使用插件时,Gradle 会从这些仓库中查找和下载插件。这个配置对所有的项目(包括子项目)都有效。
以上就是 Gradle 8.0 相比于 Gradle 7.0 在 settings.gradle 文件中的主要变化。
- com.android.application: 这是 Android 应用程序的主要插件,它提供了用于构建 Android 应用程序的所有必要功能:编译代码、打包资源、签名 APK 等。
- com.android.library:这个插件用于构建 Android 库。与 com.android.application 插件不同,他不会生成 APK,而是生成 AAR 文件,这是一个包含编译的代码和资源的库文件,可以在其他 Android 项目中使用。
- org.jetbrains.kotlin.android:用于支持 Kotlin 语言在 Android 项目中使用。它提供了 Kotlin 语言特性的支持,包括编译 Kotlin 代码、Kotlin语言的特性支持等。
Gradle 8.0 和 5.4.1 版本的 build.gradle 文件之间的主要区别在于插件和依赖项的管理方式,以及一些新的配置选项。
在 Gradle 5.4.1 的 build.gradle 文件中,插件和依赖项是在 buildscript 和 allprojects 块中定义的。buildscript 块用于配置构建脚本自身需要的类路径,allprojects 块用于配置所有项目的仓库和依赖项。
在 Gradle 8.0 的 build.gradle 文件中,插件是在 plugins 块中定义的,这是一种更简洁的方式,可以直接指定插件的 ID 和版本。此外,Gradle 8.0 还引入了 dependencyResolutionManagement 块,用于统一管理所有项目的仓库和依赖项解析。
以下是两者的主要区别:
- 插件管理:在 Gradle 8.0 中,插件是在 plugins 块中定义的,而在 Gradle 5.4.1 中,插件是在 buildscript 块中定义的。
- 仓库管理:在 Gradle 8.0 中,仓库是在 dependencyResolutionManagement 块中定义的,而在 Gradle 5.4.1 中,仓库是在 allprojects 块中定义的。
- 依赖项解析:Gradle 8.0 引入了 dependencyResolutionManagement 块,用于统一管理所有项目的依赖项解析。
- Kotlin 插件版本:在 Gradle 5.4.1 的 build.gradle 文件中,Kotlin 插件的版本是在 buildscript 块中定义的,而在 Gradle 8.0 的 build.gradle 文件中,Kotlin 插件的版本是在 plugins 块中定义的。
- 清理任务:在 Gradle 5.4.1 的 build.gradle 文件中,定义了一个 clean 任务,用于删除项目的构建目录。在 Gradle 8.0 的 build.gradle 文件中,没有定义这个任务,因为 Gradle 默认提供了这个任务。
Android Studio、Gradle、JDK、Andrroid Gradle Plugin版本问题