企业官网建设流程全解析

• 文档
• 教程
• 移动开发

导读

本文是 Android 官方培训课程（Android Training）中文版《建立第一个 App》系列的第一课，讲解如何在项目 android-training-course-in-chinese 的指导下，从零创建一个 Android 项目：既可以用 Android Studio 图形化向导完成，也可以在不依赖 IDE 的情况下用 SDK Tools 的命令行完成。读完本文，你将掌握一个 Android 项目的完整骨架——布局文件、Java 源码、Manifest 清单、Gradle 构建配置与资源目录分别承担什么职责，并能在创建项目后无缝衔接到运行程序与构建用户界面的后续课程。

前置条件：先准备好开发环境

一个 Android 项目包含了所有构成 Android 应用的源代码文件。在动手创建之前，请先确认以下环境已经就绪：

• 已安装 Android SDK；如果使用 Android Studio 开发，还需安装 Android Studio 本体（本课程所属的入门篇也明确建议用 SDK Manager 下载最新的 SDK tools 与 platforms）。
• 命令行方式创建项目时，需要能访问<sdk>/tools/与<sdk>/platform-tools/目录下的可执行文件。

提示：本系列课程虽然大多假设你使用 Android Studio，但 SDK tools 提供的命令行同样可以完成创建、编译与安装等操作，两种方式本文都会覆盖。

方式一：使用 Android Studio 创建项目

Android Studio 提供了可视化的新建项目向导，按以下步骤操作即可得到一个基础可运行的 Hello World 工程。

1. 启动向导：如果尚未用 Android Studio 打开任何项目，欢迎页会显示Start a new Android Studio project按钮，点击进入；如果已经打开了其他项目，则通过菜单File > New Project创建新项目。

2. 配置新项目（Configure your new project）：在弹出的窗口填入以下内容后点击Next。按下列值填写，可以使后续课程（编写 UI、启动 Activity）的操作不易出错：

   • Application Name：展示给用户的应用名称，本教程使用My First App；
   • Company domain：包名限定符，Android Studio 会将此限定符应用到每个新建项目，本教程使用example.com；
   • Package Name：应用的包命名空间，语义与 Java 包一致；它在同一台 Android 系统上所有已安装的应用中必须唯一，由包名限定符推导而来；
   • Project location：操作系统上存放项目文件的路径。

3. 选择运行形态：在Select the form factors your app will run on窗口勾选Phone and Tablet。

4. 选择最低支持版本（Minimum SDK）：选择API 15: Android 4.0.3 (IceCreamSandwich)。Minimum Required SDK 表示应用支持的最低 Android 版本；为了覆盖尽可能多的设备，应将其设置为「支持你应用核心功能所需的最低 API 级别」。如果某些非核心功能只在更高版本 API 上可用，可以只在高版本上开启这些功能，具体策略参考兼容不同的系统版本。此处采用默认值即可。

5. 不要勾选其他形态（TV、Wear、Glass），点击Next。

6. 添加 Activity：在Add an activity to Mobile窗口选择Empty Activity，点击Next。Empty Activity 会生成最精简的 Activity 与对应布局，适合作为入门起点。

7. 自定义 Activity（Customize the Activity）：保持默认设置（Activity 与布局的默认命名即可满足后续课程需要）。

8. 点击Finish完成创建。

创建完成后，Android Studio 会生成一个基础 Hello World 项目。在进入下一步之前，花一点时间认识其中最重要的几个文件。

默认项目的关键文件

app/res/layout/activity_main.xml

新建 Activity 对应的 XML 布局文件。按照创建新项目的流程，Android Studio 会同时展示该文件的文本视图与图形化预览。文件包含默认设置和一个显示内容为Hello world!的TextView元素。

app/java/com.example.myfirstapp/MainActivity.java

创建完成后，Android Studio 中会打开对应代码文件的选项卡，其中是新创建的 Activity 类定义。编译并运行项目后，该 Activity 启动并加载布局文件activity_main.xml，在屏幕上显示Hello world!文本。需要说明的是：在标准的 Gradle 工程目录结构中，Java 源码的完整路径实际为app/src/main/java/com/example/myfirstapp/MainActivity.java，清单文件完整路径为app/src/main/AndroidManifest.xml（原文档采用简化写法）。

app/manifest/AndroidManifest.xml

Manifest 清单文件描述了项目的基本特征，并列出了组成应用的各个组件（Activity、Service、BroadcastReceiver、ContentProvider 等）。后续课程会深入学习该文件并不断向其中添加组件。

app/build.gradle

Android Studio 使用 Gradle 编译运行 Android 工程；工程的每个模块以及整个工程都各有一个build.gradle文件。通常只需关注模块级（app/下）的build.gradle，其中存放编译依赖设置，核心是defaultConfig块（详见下文）。

关于 Gradle 构建的更多知识，以及后续课程会用到的gradlew/gradlew.bat脚本（Gradle Wrapper），见《执行 Android 程序》中通过./gradlew assembleDebug命令行编译 APK 的部分。

深入解析 build.gradle 的四个核心配置项

模块级build.gradle的defaultConfig中，有四个配置项直接决定了应用「用什么编译、以什么身份发布、支持到哪些设备」：

说明：原文档中的compiledSdkVersion是compileSdkVersion的笔误，实际 Gradle 配置属性名为compileSdkVersion。后三者（applicationId、minSdkVersion、targetSdkVersion）在工程构建配置中与 Manifest 的<uses-sdk>声明相互配合，其中minSdkVersion与targetSdkVersion的语义对应关系可参考适配不同的系统版本中的<uses-sdk android:minSdkVersion="4" android:targetSdkVersion="15" />示例：Android 用这两个级别标注应用兼容范围的下限与「经过测试」的上限，并借此决定新版本平台行为变更是否生效。

除上述四项外，实际工程中defaultConfig通常还包含versionCode（整型，用于内部版本号递增）与versionName（面向用户显示的版本号），它们同样服务于应用的发布与更新。

认识 /res 资源目录

新建项目的res/目录下按类别存放着各类资源，Android 框架会在运行时按资源 ID 引用它们：

• drawable<density>/：存放各种屏幕密度（mdpi、hdpi 等）图像的文件夹；应用运行时的默认图标文件ic_launcher.png就在这里。
• layout/：存放用户界面文件，如前文提到的activity_my.xml，描述了对应 Activity 的用户界面。
• menu/：存放应用内定义菜单项的文件。
• values/：存放其他 XML 资源文件，如字符串、颜色定义；其中strings.xml定义了运行应用时显示的文本Hello world!，后续建立简单的用户界面课程会把edit_message、button_send等字符串统一收敛到该文件，以便查找、修改与本地化。

方式二：使用命令行创建项目

如果不使用 Android Studio，可以改用 SDK 提供的tools命令行工具创建项目。命令行方式在自动化构建、持续集成或无法使用 IDE 的环境下尤其有用。

1. 打开命令行，切换到 SDK 根目录下（即包含tools/子目录的目录）。

2. 执行以下命令，列出当前 SDK 中已下载的全部可用 Android 平台：

   tools/android list targets

   该命令会在屏幕上打印所有可用 platform，找到想要创建项目的目标 platform，并记录其对应的Id。推荐使用最新的 platform——虽然仍可让应用支持较老版本的 platform，但设置为最新版本允许我们为最新的 Android 设备优化应用。如果屏幕没有任何可用 platform，需要使用 Android SDK Manager 下载安装（参见「Adding Platforms and Packages」流程）。

3. 执行创建命令：

   android create project --target <target-id> --name MyFirstApp \ --path <path-to-workspace>/MyFirstApp --activity MyActivity \ --package com.example.myfirstapp

   将<target-id>替换为上一步记录的平台 Id，将<path-to-workspace>替换为希望保存项目的路径。各参数含义如下：

   • --target：指定编译目标平台 Id；
   • --name：项目名称；
   • --path：项目在磁盘上的存放位置；
   • --activity：默认启动 Activity 的类名；
   • --package：应用的包名（保持与 Android Studio 向导中 Package Name 相同的唯一性要求）。

   Tip：把platform-tools/和tools/添加到环境变量PATH，之后可以直接使用android、adb等命令，开发更方便。

命令执行完毕后，项目即成为一个基本的 Hello World 程序，包含与 Android Studio 方式等价的一套默认文件。

创建完成之后：下一步做什么

无论通过哪种方式，刚创建的项目都只是起点。紧接着需要：

• 在真实设备或模拟器上编译、安装并运行应用——见执行 Android 程序（其中会用到gradlew assembleDebug、adb install以及 AVD 模拟器创建流程）；
• 编写第一个界面——用布局编辑器为应用添加文本框与按钮，见建立简单的用户界面；
• 让按钮真正响应点击、启动另一个 Activity，见启动其他的 Activity。

小结

本文完整覆盖了 Android 官方培训课程《创建 Android 项目》的全部内容：在 Android Studio 中按 8 步向导完成项目配置（应用名、公司域名、包名、项目路径、Phone and Tablet 形态、API 15 最低版本、Empty Activity 模板），剖析了新建项目的四大默认文件（布局、Activity 源码、Manifest、Gradle 配置），重点解读了compileSdkVersion、applicationId、minSdkVersion、targetSdkVersion四个配置项的用途与取值策略，并给出了res/资源目录（drawable、layout、menu、values）的职责划分；对于无 IDE 场景，也完整演示了tools/android list targets与android create project的命令行建项目流程。掌握这些基础后，即可沿着本系列课程继续完成「运行程序 → 构建界面 → 启动 Activity」的完整首个 App 之旅。

• 文档
• 教程
• 移动开发