【小米App】Abdroid Studio中Kotlin应用项目结构及详细说明

最新推荐文章于 2025-07-05 15:31:46 发布

原创最新推荐文章于 2025-07-05 15:31:46 发布 · 601 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#windows #android studio #kotlin

移动APP 专栏收录该内容

267 篇文章

订阅专栏

在 Android Studio 中开发 Kotlin 安卓应用时，项目结构包含多个文件和目录，每个文件都有其特定的作用。下面我将 详细解释每个核心文件的作用，并逐行分析代码逻辑。

1. 项目结构概览

app/
├── manifests/
│   └── AndroidManifest.xml          # 应用配置清单
├── java/
│   └── com.example.myapp
│       └── MainActivity.kt          # 主 Activity 逻辑
├── res/
│   ├── layout/
│   │   └── activity_main.xml        # 主界面布局
│   ├── values/
│   │   ├── strings.xml              # 字符串资源
│   │   └── colors.xml               # 颜色资源
│   └── mipmap/                      # 应用图标
└── Gradle Scripts/
    ├── build.gradle (Project)       # 项目级配置
    └── build.gradle (Module: app)   # 模块级配置

2. 核心文件详解

(1) `AndroidManifest.xml`

位于 manifests/AndroidManifest.xml，定义应用的基本信息：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.xiaomiphoneinfo">  <!-- 应用包名，唯一标识 -->

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"  <!-- 应用图标 -->
        android:label="@string/app_name"    <!-- 应用名称（引用 strings.xml） -->
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.MyApplication">  <!-- 主题样式 -->
        <activity
            android:name=".MainActivity"   <!-- 主 Activity 类名 -->
            android:exported="true">       <!-- 允许其他应用启动 -->
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />  <!-- 入口 Activity -->
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

关键点：

package：应用唯一标识，与 Gradle 配置一致。
android:icon：应用图标，放在 res/mipmap 中。
<activity>：声明一个 Activity，android:name 对应 Kotlin 类名。
<intent-filter>：指定该 Activity 为应用入口。

(2) `MainActivity.kt`

位于 java/com.example.myapp/MainActivity.kt，主逻辑代码：

package com.example.xiaomiphoneinfo  // 包名，与 Manifest 一致

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import android.widget.TextView

class MainActivity : AppCompatActivity() {
    // 当 Activity 创建时调用
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)  // 调用父类初始化
        setContentView(R.layout.activity_main)  // 加载布局文件

        // 获取布局中的 TextView
        val modelTextView: TextView = findViewById(R.id.modelTextView)
        val batteryTextView: TextView = findViewById(R.id.batteryTextView)

        // 模拟数据
        val phoneModel = "Xiaomi 14 Pro"
        val batteryLevel = 85

        // 更新 UI
        modelTextView.text = "设备型号：$phoneModel"
        batteryTextView.text = "电池电量：$batteryLevel%"
    }
}

逐行解释：

package：声明类所属包，必须与 AndroidManifest.xml 中的 package 一致。
import：导入依赖库（如 AppCompatActivity、TextView）。
class MainActivity : AppCompatActivity()：继承 AppCompatActivity（兼容旧版 Android）。
onCreate()：Activity 生命周期方法，初始化 UI。
- super.onCreate()：调用父类方法。
- setContentView(R.layout.activity_main)：绑定布局文件。
findViewById()：通过 ID 获取布局中的控件。
textView.text = "..."：设置控件文本，$var 是 Kotlin 字符串模板。

(3) `activity_main.xml`

位于 res/layout/activity_main.xml，定义界面布局：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"   <!-- 宽度填满父容器 -->
    android:layout_height="match_parent" <!-- 高度填满父容器 -->
    android:orientation="vertical"       <!-- 子控件垂直排列 -->
    android:gravity="center"             <!-- 子控件居中 -->
    android:padding="16dp">              <!-- 内边距 -->

    <!-- 标题 -->
    <TextView
        android:id="@+id/titleTextView"   <!-- 控件 ID，用于代码引用 -->
        android:layout_width="wrap_content"  <!-- 宽度自适应内容 -->
        android:layout_height="wrap_content"
        android:text="小米手机信息"       <!-- 显示文本 -->
        android:textSize="24sp"          <!-- 字体大小 -->
        android:textStyle="bold"         <!-- 加粗 -->
        android:layout_marginBottom="24dp"/>  <!-- 底部外边距 -->

    <!-- 设备型号 -->
    <TextView
        android:id="@+id/modelTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="设备型号："
        android:textSize="18sp"
        android:layout_marginBottom="16dp"/>

    <!-- 电池电量 -->
    <TextView
        android:id="@+id/batteryTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="电池电量："
        android:textSize="18sp"/>
</LinearLayout>

关键属性：

android:id：控件唯一标识，代码中通过 findViewById(R.id.xxx) 引用。
android:layout_width/height：
- match_parent：填满父容器。
- wrap_content：自适应内容大小。
android:orientation：LinearLayout 的子控件排列方向。
android:gravity：控件内部内容对齐方式。
android:padding：内边距，android:layout_margin：外边距。

(4) `strings.xml`

位于 res/values/strings.xml，集中管理字符串资源：

<resources>
    <string name="app_name">小米手机信息展示器</string>
</resources>

作用：

避免硬编码，方便多语言适配。
在代码或布局中用 @string/app_name 引用。

(5) `build.gradle (Module: app)`

位于 Gradle Scripts/build.gradle (Module: app)，配置模块依赖：

plugins {
    id("com.android.application")  // 声明是应用模块
    id("org.jetbrains.kotlin.android")  // Kotlin 支持
}

android {
    compileSdk 34  // 编译 SDK 版本

    defaultConfig {
        applicationId "com.example.xiaomiphoneinfo"  // 应用包名
        minSdk 24    // 最低支持的 Android 版本
        targetSdk 34 // 目标 SDK 版本
        versionCode 1  // 内部版本号
        versionName "1.0"  // 用户可见版本号
    }

    buildTypes {
        release {
            minifyEnabled false  // 是否启用代码混淆
            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
        }
    }
}

dependencies {
    implementation("androidx.core:core-ktx:1.12.0")  // Kotlin 扩展库
    implementation("androidx.appcompat:appcompat:1.6.1")  // 兼容库
    implementation("com.google.android.material:material:1.11.0")  // Material 组件
}