如何正确配置Gradle项目以生成APK并部署到Android虚拟设备（AVD）

嘿，我看到你手动配置Android Gradle项目时遇到了一堆错误，别慌，咱们一步步把配置理顺，确保能顺利生成APK并部署到你的AVD上。首先得指出你当前配置里的几个关键问题，然后给你一套标准的、适配最新Gradle/AGP的配置方案。

你当前配置的核心问题 #

• 版本不匹配：你用的Gradle是8.2.1，但Android Gradle插件（AGP）选了8.0.0，两者版本需要严格对应，否则会出现兼容性错误
• 依赖库过时：你用的com.android.support系列库已经停止维护，官方现在推荐用AndroidX库
• 配置语法过时：你用的是旧版Groovy风格的apply plugin语法，但你选了Kotlin DSL作为构建脚本语言，应该用更现代的plugins块写法
• SDK版本太老：compileSdk/targetSdk用25已经非常过时，建议升级到较新的版本（比如34），避免兼容性问题

第一步：修正项目结构 #

因为gradle init不会自动生成Android项目的标准目录结构，你需要手动创建以下文件夹和文件：

root/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── AndroidManifest.xml
│   │       ├── java/
│   │       │   └── com/
│   │       │       └── name/
│   │       │           └── myapplication/
│   │       │               └── MainActivity.java
│   │       └── res/
│   │           └── layout/
│   │               └── activity_main.xml
│   └── build.gradle.kts
├── build.gradle.kts
├── settings.gradle.kts
└── gradle/
    └── wrapper/
        └── gradle-wrapper.properties

第二步：替换为正确的配置文件 #

1. 根目录 settings.gradle.kts

rootProject.name = "app"
include(":app")

2. 根目录 build.gradle.kts

plugins {
    // 声明AGP版本，和Gradle版本8.2.1匹配
    id("com.android.application") version "8.2.1" apply false
}

// 保留clean任务
tasks.register("clean", Delete::class) {
    delete(rootProject.buildDir)
}

3. app模块 build.gradle.kts

plugins {
    id("com.android.application")
}

android {
    namespace = "com.name.myapplication"
    // 升级到最新稳定版SDK
    compileSdk = 34

    defaultConfig {
        applicationId = "com.name.myapplication"
        // 建议至少设为21，覆盖99%以上的设备（如果必须支持16也可以保留，但AndroidX对16支持有限）
        minSdk = 21
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }

    // 配置Java兼容性
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
}

dependencies {
    // 使用AndroidX替代旧的support库
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
}

4. AndroidManifest.xml（必须文件）

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.name.myapplication">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AppCompat.Light.DarkActionBar">
        <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>

5. MainActivity.java（示例页面）

package com.name.myapplication;

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);
    }
}

6. activity_main.xml（示例布局）

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

第三步：构建并部署到AVD #

确保你的AVD已经启动，然后在终端执行以下命令：

1. 同步项目配置：./gradlew sync
2. 生成Debug APK：./gradlew assembleDebug，生成的APK路径是 app/build/outputs/apk/debug/app-debug.apk
3. 安装到AVD：./gradlew installDebug，这个命令会自动把APK安装到当前连接的设备（包括运行中的AVD）

如果构建过程中还是有错误，可以执行./gradlew build --stacktrace查看详细的错误堆栈，方便定位问题。

备注：内容来源于stack exchange，提问作者camcam