三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

Android Studio新手入门：从零创建项目到生成APK的完整指南

发布时间：2026/8/13 5:09:57 三亩地 编程学习日记
Android Studio新手入门：从零创建项目到生成APK的完整指南

1. 从零到一：Android Studio项目创建与APK生成全流程

刚接触Android开发，面对Android Studio这个庞然大物，很多人第一步就卡住了。看着别人手机上运行着自己写的APP，感觉遥不可及。其实，从创建一个空白工程到生成能在手机上安装的APK文件，整个过程就像搭积木，只要步骤清晰，一步一个脚印，半小时内你就能看到自己的第一个“Hello World”应用在模拟器里跑起来。这篇文章，我会以一个过来人的身份，带你走一遍最标准、最详细的新建工程到打包APK的流程，过程中我会穿插那些官方文档不会告诉你的细节和踩坑点，确保你一次成功。

2. 环境准备与工程创建：奠定稳固的基石

万事开头难，但开头的工作做扎实了，后面就能省去无数麻烦。在点击“New Project”之前，有几项准备工作必须到位。

2.1 安装与环境校验：确保工具链完整

首先，你得确保你的Android Studio是正确安装且可用的。很多新手卡在第一步，就是因为JDK（Java Development Kit）环境没配好。Android Studio通常自带一个JDK，但对于想使用特定版本或进行更复杂开发的你，我建议手动管理。

注意：从Android Studio Arctic Fox（2020.3.1）版本开始，IDE内置了JetBrains Runtime (JBR)，但编译Android应用仍需JDK。在File->Project Structure->SDK Location中，你可以查看和修改JDK location。我个人的习惯是下载并指定一个独立的JDK 11或JDK 17路径，这样当Android Studio升级时，不会影响到我的编译环境。

验证安装是否成功，打开Android Studio，欢迎界面应该能正常显示。然后，我们需要检查SDK（Software Development Kit）管理器。点击欢迎界面右下角的Configure->SDK Manager，或者进入IDE后通过File->Settings->Appearance & Behavior->System Settings->Android SDK打开。

在这里，你需要确保至少安装了一个版本的Android SDK Platform。对于第一个应用，我推荐选择当前相对稳定且设备覆盖率高的API级别，比如API 34 (Android 14)或API 33 (Android 13)。同时，务必安装对应版本的SDK Platform和System Image（如果你打算使用模拟器的话）。Android SDK Build-Tools也是必须的，通常SDK管理器会推荐安装最新版本，跟着装就行。

2.2 创建新工程：选择适合的起点

准备工作做完，现在可以正式开始了。在欢迎界面点击New Project，你会看到一个项目模板选择窗口。这里的选择会影响初始工程的复杂程度。

对于纯粹的新手，我强烈建议选择Empty Views Activity（在较新版本中，它可能就叫Empty Activity）。这个模板生成最干净的代码结构，只有一个主界面（Activity），非常适合用来理解基础。像Basic Views Activity或Bottom Navigation Activity等模板会引入更多高级组件（如Fragment、ViewBinding等），虽然功能更丰富，但也会带来额外的学习复杂度，容易让初学者迷失在框架细节里，忘了学习主线。

选定Empty Views Activity后，点击Next，进入项目配置页面。这里的每一项配置都至关重要：

  1. Name: 你的应用名称，会显示在手机桌面上。可以先用MyFirstApp这样的名字。
  2. Package name: 包名，这是应用的唯一标识，遵循Java包名的反向域名规则，例如com.example.myfirstapp。一旦发布，包名几乎无法更改，所以即便是个练习项目，也建议起个规范的名字。
  3. Save location: 项目保存路径。切记路径中不要包含中文或特殊字符！这是无数血泪教训的总结，否则在后续构建时可能遇到各种编码错误。
  4. Language: 选择Java或Kotlin。如果你是零基础，我建议从Java开始，它的语法和更多传统编程语言相似，资料也极其丰富。Kotlin虽然是谷歌官方推荐的语言，更现代简洁，但初期可能会被其独特的语法糖困扰。当然，如果你有明确意向学习Kotlin，直接选它也没问题。
  5. Minimum SDK: 应用支持的最低Android版本。这里有个权衡：版本设得太低（如API 21），能兼容更多老设备，但无法使用很多新系统的酷炫特性；设得太高（如API 33），则可能放弃一部分用户。对于学习项目，可以设置为API 24 (Android 7.0)或API 26 (Android 8.0)，这是一个比较折中的选择，既能覆盖大部分设备，又能使用相对现代的API。

配置完成后，点击Finish按钮。Android Studio会开始构建项目，这个过程会下载Gradle构建工具和项目依赖，耗时取决于你的网络速度。第一次创建可能会比较慢，请耐心等待。

3. 项目结构解析与核心文件初探

工程创建成功后，你会看到Android Studio的主界面，左侧是项目文件树。理解这个结构，是你后续开发的基础。默认视图是Android模式，它按文件类型进行了归类，对新手比较友好。但我更推荐你切换到Project模式，它能让你看到项目的真实物理结构。

3.1 核心目录与文件详解

在Project视图下，我们关注以下几个核心部分：

  • app/: 这是应用模块的根目录，我们绝大部分工作都在这里进行。
    • manifests/AndroidManifest.xml: 应用的“身份证”和“总说明书”。它声明了应用包含的组件（如Activity）、所需的权限、应用图标、主题等信息。打开它，你会看到我们刚才创建的MainActivity已经被声明在其中。
    • java/com.example.myfirstapp/: 这里是Java（或Kotlin）源代码的存放处。包名路径下的MainActivity.java就是我们应用的主入口界面。
    • res/: 资源目录，所有非代码资源都放在这里，采用目录分类。
      • layout/: 存放界面布局文件。activity_main.xml定义了MainActivity的界面长什么样。
      • values/: 存放字符串、颜色、样式等定义。strings.xml里定义了所有文本，这样做有利于国际化。
      • drawable/: 存放图片、形状定义等可绘制资源。
      • mipmap/: 专门存放应用图标，系统会根据不同屏幕密度自动选择合适尺寸的图标。
  • Gradle Scripts/: 这里存放项目的构建脚本，是Android Studio构建系统的核心。
    • build.gradle (Project: MyFirstApp): 项目级别的构建配置，通常用来定义所有模块共用的仓库和依赖。
    • build.gradle (Module: app):应用模块级别的构建配置，这是我们的重中之重！应用的SDK版本、依赖库、签名配置等都在这里定义。

3.2 初识Gradle构建脚本

双击打开build.gradle (Module: app)文件。我们重点关注两个部分：

  1. android {}闭包：这里定义了编译相关的所有参数。

    android { compileSdk 34 // 编译时使用的SDK版本，应与你安装的SDK Platform版本一致或更低 defaultConfig { applicationId "com.example.myfirstapp" // 包名，与创建时填写的一致 minSdk 24 // 最低支持SDK版本 targetSdk 34 // 目标SDK版本，通常与compileSdk相同，表示你已针对该版本优化 versionCode 1 // 内部版本号，整数，每次发布新APK必须递增 versionName "1.0" // 对用户显示的版本名称 } ... }

    versionCode和versionName是你未来发布应用时需要频繁修改的。versionCode是给系统识别更新用的，必须递增；versionName是给用户看的，可以是“1.2.3”这样的格式。

  2. dependencies {}闭包：这里声明项目所依赖的所有库。模板工程已经包含了一些基础依赖，如appcompat（兼容库）、material（Material Design组件库）。当你需要添加新功能，比如网络请求、图片加载时，就需要在这里添加对应的依赖坐标。

实操心得：每次修改build.gradle文件后，Android Studio右上角会同步出现一个“大象”图标（Sync Now），必须点击它同步项目，更改才会生效。如果同步失败，仔细查看报错信息，通常是网络问题导致依赖下载失败，或版本号冲突。

4. 运行与调试：在模拟器或真机上看到你的应用

代码和配置都有了，是时候让应用跑起来了。你需要一个设备来运行它——可以是Android Studio自带的虚拟设备（AVD），也可以是连接电脑的实体手机。

4.1 创建与管理安卓虚拟设备（AVD）

如果你没有安卓手机，或者想测试不同型号、版本的设备，AVD是最佳选择。点击工具栏中Device Manager的图标（一个手机和播放键），然后点击Create device。

  1. 选择硬件：新手建议选择Pixel系列，这是谷歌的亲儿子，兼容性最好。比如选Pixel 7。
  2. 选择系统镜像：选择一个你已下载的SDK版本对应的系统镜像。推荐选择Release Name带有Google Play标志的版本，这意味着镜像里包含了Google Play服务，更接近真实手机环境。点击下载，等待完成。
  3. AVD配置：可以给设备起个名字，并调整一些选项。对于性能，Graphics（图形渲染）选项，如果你的电脑支持，选择Hardware - GLES 2.0性能会更好；如果不支持或遇到问题，可以回退到Software。Enable Device Frame可以勾选，这样模拟器会有手机边框，看起来更真实。

创建完成后，在Device Manager列表中选中它，点击绿色的播放按钮启动。首次启动像开机一样，需要一点时间。

4.2 连接真机进行调试

使用真机能获得最真实的体验。操作步骤如下：

  1. 开启开发者选项：在手机的设置->关于手机里，连续点击版本号7次，直到提示“您已处于开发者模式”。
  2. 开启USB调试：返回设置，进入系统和更新->开发人员选项，找到并开启USB调试。
  3. 连接电脑：用USB数据线连接手机和电脑。手机会弹出“是否允许USB调试”的授权对话框，勾选“始终允许”并确认。
  4. 在Android Studio中识别：连接成功后，在Android Studio工具栏的运行设备选择下拉框中，你应该能看到你的手机型号。

4.3 运行你的应用

确保设备（无论是AVD还是真机）已经就绪，并且项目没有同步错误。在Android Studio中，找到工具栏上的“运行”按钮（绿色的三角形），或者使用快捷键Shift + F10（Windows/Linux）或Control + R（Mac）。Android Studio会开始编译项目，构建APK，并将其安装到目标设备上运行。

如果一切顺利，你将在设备上看到一个白色的应用界面，中间显示着“Hello World!”字样。恭喜你，你的第一个Android应用已经成功运行了！

常见问题：如果运行按钮是灰色的，通常是因为没有正确选中设备，或者当前编辑的文件不是.java或.kt源码文件。请点击设备选择下拉框，确认设备已连接并选中。如果提示“ADB not responding”或“device unauthorized”，尝试重启ADB（在终端输入adb kill-server然后adb start-server）或在手机上重新授权USB调试。

5. 生成发布版APK安装包

在设备上运行成功，生成的是一个调试版（Debug）APK，它包含了调试信息，体积较大，且无法发布到应用商店。要分享给朋友安装，或者为发布做准备，我们需要生成一个发布版（Release）APK。

5.1 生成签名密钥（Keystore）

这是最关键的一步，也是安全底线。Android系统要求所有APK都必须被签名才能安装。发布版APK必须用一个私有的密钥文件（Keystore）进行签名，这个文件一旦丢失或密码遗忘，你将永远无法更新这个应用（因为更新包必须用同一个密钥签名）。

我们可以通过Android Studio可视化生成：

  1. 在菜单栏选择Build->Generate Signed Bundle / APK。
  2. 在弹出的对话框中，选择APK，点击Next。
  3. 如果你还没有密钥库，点击Create new...。
  4. 填写密钥库创建信息：
    • Key store path: 选择密钥库文件（.jks）的保存路径和文件名。务必将其保存在安全且不会丢失的地方！
    • Password/Confirm: 为密钥库设置高强度密码。
    • Alias: 密钥别名，可以理解为密钥库里的一个钥匙的名字。
    • Password/Confirm: 为这个别名密钥再设置一个密码（可以与密钥库密码不同，但建议区分）。
    • Validity (years): 密钥有效期，默认25年，对于个人应用足够了。
    • Certificate: 填写你的名字、组织单位等信息。对于个人项目，可以简单填写。

重要警告：请务必将生成的.jks文件和密码妥善备份！最好使用密码管理器记录，并存储在多个安全位置。丢失它们意味着你无法对应用进行任何官方更新，只能以全新的包名重新发布一个“新应用”。

5.2 配置构建变体并生成APK

创建好密钥库后，回到Generate Signed Bundle or APK向导，选择你刚才创建的密钥库路径，并输入对应的密码和别名密码。

  1. 选择构建变体：在Build Variants中选择release。Debug是调试版，Release是发布版。
  2. 选择签名版本：勾选V2 (Full APK Signature)。这是Android 7.0引入的更安全、更快的签名方案，务必勾选。
  3. 点击Finish：Android Studio会开始编译并签名你的发布版APK。构建完成后，会提示APK生成的位置，通常在app/build/outputs/apk/release/目录下，文件名类似app-release.apk。

5.3 优化与混淆（ProGuard/R8）

在生成发布版APK的配置中，你可能会看到Signature Versions下面有一个Run ProGuard或Enable code shrinking and obfuscation的选项。对于第一个应用，我建议先不要勾选。

这是代码混淆和优化功能，它通过移除未使用的代码、重命名类和方法名来减小APK体积并增加反编译难度。但对于新手项目，它可能会把一些必要的类或方法错误地移除，导致应用崩溃，而崩溃日志会变得难以阅读，增加调试难度。等你对项目结构更熟悉后，再开启这个功能。

6. 安装与测试发布版APK

生成的app-release.apk文件，你可以通过USB数据线、网盘、蓝牙等方式发送到安卓手机上进行安装。

在手机上安装时，可能会遇到“禁止安装来自未知来源的应用”的提示。你需要到手机的设置->安全（或应用与权限）中，开启允许安装未知来源应用的权限（通常是对应于“文件管理”或“浏览器”这类应用）。安装完成后，就可以像其他应用一样打开和使用了。

为了确保万无一失，在将APK分享给他人前，请务必在自己手机上完整测试一遍核心功能。因为发布版（Release）和调试版（Debug）的运行环境存在细微差异，有些在调试模式下正常的问题，可能在发布版中暴露出来。

7. 进阶配置与常见问题深度排查

走完上述流程，你已经掌握了最基础的路径。但在实际开发中，总会遇到一些“拦路虎”。下面我分享几个高频问题和进阶配置点。

7.1 构建失败：Gradle同步与编译错误

这是新手最常遇到的噩梦。错误信息通常出现在Android Studio底部的Build窗口。

  • 错误类型一：网络问题导致依赖下载失败。

    • 现象：同步失败，提示Connection timed out或Could not download xxx.jar。
    • 解决：这是因为Gradle在从国外仓库下载依赖。最根本的解决方法是配置国内镜像。修改项目根目录的build.gradle文件，在repositories闭包内添加阿里云镜像。
      // 在allprojects的repositories里 allprojects { repositories { google() mavenCentral() // 添加阿里云镜像 maven { url 'https://maven.aliyun.com/repository/public' } maven { url 'https://maven.aliyun.com/repository/google' } // 如果用了JCenter，也可以添加其镜像（但JCenter已停止服务，建议迁移） // maven { url 'https://maven.aliyun.com/repository/jcenter' } } }
      修改后，点击Sync Now重新同步。也可以尝试使用科学的上网工具。

  • 错误类型二：版本冲突。

    • 现象：提示Conflict with dependency xxx或Program type already present。
    • 解决：这是不同的库依赖了同一个库的不同版本。可以在app/build.gradle的dependencies中使用exclude排除特定模块，或使用resolutionStrategy强制指定版本。
      android { ... configurations.all { resolutionStrategy { // 强制所有依赖使用指定版本的某个库 force 'com.squareup.okhttp3:okhttp:4.11.0' } } }
      更优雅的方式是检查并统一你直接引入的库的版本，避免传递依赖冲突。

  • 错误类型三：SDK路径或版本错误。

    • 现象：提示Failed to find target with hash string ‘android-xx’或SDK location not found。
    • 解决：打开File->Project Structure->SDK Location，检查Android SDK location路径是否正确。然后打开SDK Manager，确认对应的SDK Platform和Build-Tools是否已经安装。

7.2 APK安装失败：签名与设备兼容性

  • 问题一：无法安装，提示“应用未安装”或“安装包损坏”。

    • 排查：
      1. 检查APK文件是否传输完整。可以对比一下文件大小和电脑上的是否一致。
      2. 检查手机存储空间是否充足。
      3. 最关键的一点：如果你手机上已经有一个同名但签名不同的应用（比如之前安装了调试版），直接安装发布版会失败。你必须先卸载旧版本，再安装新版本。

  • 问题二：在低版本手机上安装失败，提示“解析安装包时出现问题”。

    • 排查：检查app/build.gradle中的minSdkVersion。如果你生成的APK的minSdkVersion是24（Android 7.0），那么它无法安装在系统版本低于7.0的手机上。确保你的minSdkVersion设置符合目标用户设备的系统版本。

7.3 为APK“瘦身”：减少安装包体积

随着项目变大，APK体积会膨胀。对于第一个应用可能不必要，但了解这些技巧对未来有益。

  1. 启用资源压缩和混淆：在app/build.gradle的release构建类型中启用。

    android { buildTypes { release { minifyEnabled true // 启用代码混淆和优化 shrinkResources true // 启用资源压缩，移除未使用的资源 proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } }

    启用前，务必在proguard-rules.pro文件中为需要保留的类（如实体类、被反射调用的类）添加规则，例如-keep class com.example.myfirstapp.model.** { *; }。

  2. 使用WebP图片格式：Android Studio支持将PNG、JPG图片转换为WebP格式，体积更小。右键点击res/drawable目录下的图片，选择Convert to WebP...。

  3. 移除未使用的语言资源：如果你的应用只支持中文，可以在build.gradle中配置只打包中文资源。

    android { defaultConfig { ... resConfigs "zh", "zh-rCN" // 只保留中文和简体中文资源 } }

从打开Android Studio时的一片空白，到最终生成一个可以独立安装、运行的APK文件，这个过程本身就是一个完整的微型项目周期。它涵盖了环境搭建、项目创建、代码理解、构建配置、打包签名和基础测试。我建议你不要止步于此，尝试去修改activity_main.xml里的文字，或者改变一下背景颜色；再到MainActivity.java里，找到设置文字的那行代码，把它改成一句欢迎语。这些微小的改动，并再次运行、打包，会让你对“代码-界面-应用”这个链条有最直观的感受。开发之路，就是这样从一个又一个的“第一个”开始的。当你成功把APK发到朋友手机上，并看到他打开时，那种成就感就是坚持下去的最好动力。记住，遇到问题多查（官方文档、Stack Overflow）、多试，每一个错误信息都是你进步的阶梯。

编程学习 学习日记 实战经验
← 返回列表