Android Studio 会自动下载安装版本较低的 Gradle,故不需要 gradlew。
app/src/main/java/com/example/myapplication/MainActivity.java
package com.example.myapplication;
import android.os.Bundle;
import androidx.activity.EdgeToEdge;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
EdgeToEdge.enable(this); // [可选] Android 15+ 启用全面屏,导航条会自动取反色,使其看着明显些。
setContentView(R.layout.activity_main);
// [可选] 启用全面屏后,系统框可能会跟操作按钮重叠,故规避下:
ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
var systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
return insets;
});
}
}
app/src/main/res/layout/activity_main.xml
说明 - 若想使用 android:onClick="method" 则应指定所属上下文 xmlns:tools="http://schemas.android.com/tools" tools:context=".MainActivity"
约束属性用 - xmlns:app="http://schemas.android.com/apk/res-auto" app:layout_constraintTop_toTopOf="parent"
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/main"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!" />
</androidx.constraintlayout.widget.ConstraintLayout>
app\build.gradle.kts
plugins {
alias(libs.plugins.android.application)
}
android {
namespace = "com.example.myapplication"
compileSdk = 34
defaultConfig {
applicationId = "com.example.myapplication"
minSdk = libs.versions.minSdk.get().toInt() // minSdk = 28
targetSdk = 34 // library 项目似乎将该属性迁移到了 lint{ targetSdk = 34 }
versionCode = 1
versionName = "1.0"
}
buildTypes {
release {
isMinifyEnabled = false
proguardFiles( // 注意 - isMinifyEnabled = true 方进行混淆,光指定规则文件没用。
getDefaultProguardFile("proguard-android-optimize.txt"),
//"proguard-rules.pro"
)
}
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
}
dependencies {
implementation(libs.appcompat) // 不想用老旧的 appcompat 可从 extends AppCompatActivity 换为继承 android.app.Activity + material,同时 android:theme 也成可选了。
implementation(libs.material)
implementation(libs.activity)
implementation(libs.constraintlayout)
}
app/src/main/AndroidManifest.xml
说明 - AppCompatActivity 依赖了 android:theme="@style/Theme.Material3.DayNight.NoActionBar" 否则报:You need to use a Theme.AppCompat theme (or descendant) with this activity.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<application android:theme="@style/Theme.Material3.DayNight.NoActionBar">
<activity
android:name=".MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
settings.gradle.kts
pluginManagement {
repositories {
google {
content {
includeGroupByRegex("com\\.android.*")
includeGroupByRegex("com\\.google.*")
includeGroupByRegex("androidx.*")
}
}
mavenCentral()
gradlePluginPortal()
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
}
versionCatalogs { // 提示不支持但实际可用:Android Studio does not support Version Catalog entries defined in Gradle Settings DSL
create("libs") {
version("minSdk","28")
library("appcompat", "androidx.appcompat", "appcompat").version("1.7.0")
library("material", "com.google.android.material", "material").version("1.12.0")
library("activity", "androidx.activity", "activity").version("1.9.3")
library("constraintlayout", "androidx.constraintlayout", "constraintlayout").version("2.2.0")
plugin("android-application", "com.android.application").version("8.7.3")
// 若为 android library 项目,则必须移除 defaultConfig 的 applicationId、versionCode、versionName;
// 同时将 com.android.application 换为:
//plugin("android-application", "com.android.library").version("8.7.3")
}
}
}
rootProject.name = "My Application"
include(":app")
gradle.properties
说明 - 项目根右键进入 Open Module Settings 会自动生成 local.properties
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
android.useAndroidX=true
android.nonTransitiveRClass=true
以下均为可选文件:
build.gradle.kts
plugins {
alias(libs.plugins.android.application) apply false
}
.gitignore
*.iml
.gradle
/local.properties
/.idea/caches
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
/.idea/navEditor.xml
/.idea/assetWizardSettings.xml
.DS_Store
/build
/captures
.externalNativeBuild
.cxx
local.properties
app\.gitignore - 根目录 .gitignore 的 /build 管不了子项目。
/build
[未定义 versionCatalogs 则取该配置文件/可通过 generateCatalogAsToml 任务生成] gradle\libs.versions.toml
[versions]
minSdk = "28"
agp = "8.7.3"
appcompat = "1.7.0"
material = "1.12.0"
activity = "1.9.3"
constraintlayout = "2.2.0"
[libraries]
appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
material = { group = "com.google.android.material", name = "material", version.ref = "material" }
activity = { group = "androidx.activity", name = "activity", version.ref = "activity" }
constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "constraintlayout" }
[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }