Android Gradle Java App 模板使用指南
1. 项目目录结构及介绍
本节将详细介绍Android Gradle Java App Template项目的目录结构及其主要组成部分。
.
├── app # 主要的应用模块
│ ├── src # 源代码目录
│ │ ├── main # 主要源码,包括Java源码和资源文件
│ │ │ ├── java # Java源码文件夹,存放所有.java文件
│ │ │ └── res # 资源文件夹,包括布局文件、图片等
│ │ ├── androidTest # 单元测试和UI测试的代码
│ │ └── test # JUnit测试代码
│ ├── build.gradle # 应用模块构建脚本
│ └── manifest.xml # AndroidManifest.xml,声明应用基本信息
├── gradlew* # Gradle wrapper脚本,用于下载并运行Gradle
├── gradle # Gradle配置目录
│ └── wrapper # 包含Gradle Wrapper的详细配置
├── build.gradle.kts # 顶级构建脚本,配置整个项目的构建规则
└── settings.gradle.kts # 项目设置文件,定义了要构建的模块
项目以app
作为核心模块,集成了应用的所有业务逻辑与UI组件。其他部分如build.gradle.kts
和settings.gradle.kts
负责整体的构建和项目配置。
2. 项目的启动文件介绍
在Android应用程序中,通常由MainActivity
作为启动活动(Activity)。在本模板中,此文件位于src/main/java/com/example/androidtemplate/MainActivity.java
路径下。
package com.example.androidtemplate;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main); // 设置主布局
// 初始化和其他启动逻辑可能放在这里
}
}
MainActivity
继承自AppCompatActivity
,并在onCreate
方法中加载指定的布局文件,这里是activity_main.xml
,这是应用启动时展示的第一个界面。
3. 项目的配置文件介绍
3.1 build.gradle.kts
(Module Level)
位于'app'模块下,它定义了该模块的依赖、编译选项等构建配置。
plugins {
id('com.android.application')
id('kotlin-android')
}
android {
compileSdkVersion(31) // 编译SDK版本
defaultConfig {
applicationId = "com.example.androidtemplate"
minSdkVersion(21)
targetSdkVersion(31)
versionCode = 1
versionName = "1.0"
}
buildTypes {
getByName("release") {
isMinifyEnabled = false
proguardFiles.add(file("proguard-android-optimize.txt"))
}
}
}
dependencies {
implementation("org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version")
implementation("androidx.core:core-ktx:1.6.0")
...
}
3.2 AndroidManifest.xml
位于app/src/main
内,是Android应用的基本配置文件,声明了应用的权限、主题以及默认启动Activity等重要信息。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.androidtemplate">
<application
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!-- 其他Activities, Services, etc. -->
</application>
</manifest>
这个文件明确了应用如何启动,哪个Activity是入口点,以及其他元数据。
通过上述概览,开发者可以快速理解此模板的基础框架,进而进行开发定制。