项目结构与清单文件
理解 Android 项目布局、build.gradle 和资源的作用，以及向 OS 声明应用的 AndroidManifest.xml 文件。
项目结构与清单文件 是 CoddyKit 上的免费 Android Academy 课时。 这是第 1 节课，共 7 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 7 节课。
您的第一个 Android 项目
在 Android Studio 中创建新的 Android 项目时，系统会生成特定的文件夹结构。了解这一结构是高效进行 Android 开发的第一步。
每个 Android 应用都有相同的顶层布局——让我们一起来了解它。
顶层结构
Android 项目包含两个主要模块：
- app/——您的应用模块（代码、资源、清单文件）
- Gradle 文件——构建系统配置
在 app/src/main/ 中，您将花费大部分时间：
- java/（或 kotlin/）——Kotlin 源文件
- res/——布局、图像、字符串
- AndroidManifest.xml——应用的配置文件
res/ 目录
res/ 文件夹存放所有非代码资源：
res/layout/——XML 屏幕布局res/drawable/——图像和图标res/values/strings.xml——文本字符串res/values/colors.xml——颜色定义res/mipmap/——应用启动器图标
Android 会生成一个名为 R 的类，将资源映射为代码中的引用。
AndroidManifest.xml
AndroidManifest.xml 是最重要的配置文件。它会告知 Android：
- 应用的软件包名称（唯一标识符）
- 应用中有哪些活动
- 哪个活动是启动屏幕
- 应用所需的权限（相机、网络等）
- 最低 Android API 级别和目标 Android API 级别
清单文件结构
最小的 AndroidManifest.xml 如下所示：
<!-- AndroidManifest.xml -->
<manifest
xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission
android:name="android.permission.INTERNET" />
<application
android:label="@string/app_name"
android:icon="@mipmap/ic_launcher">
<activity android:name=".MainActivity"
android:exported="true">
<intent-filter>
<!-- This is the launch activity -->
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>build.gradle 文件
Gradle 是构建系统。项目中有两个 build.gradle 文件：
- 项目级——全局设置、仓库配置
- 应用级（app/build.gradle）——应用的依赖项、SDK 版本和插件
您可以在此处添加库：implementation "com.google.code.gson:gson:2.10.1"
app/build.gradle 的关键字段
app/build.gradle 中最重要的字段：
compileSdk——用于编译的 Android APIminSdk——您支持的最旧 Android 版本targetSdk——您针对其进行测试的 Android 版本versionCode——每次发布时递增的整数versionName——便于用户阅读的版本号（例如 "1.2.0"）
R 类
Android 会自动生成一个 R 类，将每个资源映射到一个整数 ID：
R.layout.activity_main——您的 XML 布局R.id.tvTitle——布局中的一个视图R.string.app_name——字符串资源R.drawable.ic_logo——图像
Kotlin 代码正是通过这种方式连接到 XML 资源。
使用 strings.xml 实现本地化
请始终将面向用户显示的文本放入 res/values/strings.xml，而不要将其硬编码。这样可以实现本地化——Android 会根据设备的区域设置自动选择正确语言的字符串。
例如，创建 res/values-tr/strings.xml 来存放土耳其语翻译。
快速检查
您应在哪里声明应用首次启动时显示哪个活动？
回顾：项目结构
现在您已经了解 Android 项目的组成：
- app/src/main/kotlin/——您的代码
- app/src/main/res/——布局、图像、字符串
- AndroidManifest.xml——权限、活动和启动配置
- build.gradle——依赖项和 SDK 版本
R类——连接代码与资源
下一步：每个 Android 屏幕的核心——活动及其生命周期。
常见问题解答
「项目结构与清单文件」课时是免费的吗？
是的 — 「项目结构与清单文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 7 节课。
「项目结构与清单文件」这节课中我会学到什么？
理解 Android 项目布局、build.gradle 和资源的作用，以及向 OS 声明应用的 AndroidManifest.xml 文件。 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Android Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 7 节。
「项目结构与清单文件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Android Academy 课中编写并运行代码吗？
能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。