Skip to content

Most visited

Recently visited

navigation

从命令行构建您的应用

您可以使用 Gradle 包装器命令行工具执行您的 Android 项目中可用的所有构建任务。它可作为 Windows 的批处理文件 (gradlew.bat) 和 Linux 与 Mac 的 shell 脚本文件 (gradlew.sh) 使用,可以从您使用 Android Studio 创建的每个项目的根获取。

要使用包装器运行任务,请使用下列命令之一:

要查看您的项目所有可用构建任务的列表,请执行 tasks

gradlew tasks

本页其余部分将介绍使用 Gradle 包装器构建和运行应用的基础知识。如需了解有关如何设置 Android 构建的详细信息,请参阅配置您的构建

如果您更愿意使用 Android Studio 工具,而不是命令行工具,请参阅构建和运行您的应用

关于构建类型

默认情况下,每个 Android 应用可以使用两种构建类型:一种用于调试您的应用 - 调试构建,另一种用于向用户发布您的应用 - 发布构建。您在模拟器或设备上安装之前,必须使用证书签署从每个构建生成的 APK。调试构建通过 SDK 工具提供的调试密钥自动签署(不安全,您无法将此 APK 发布到 Google Play 商店),而发布构建必须使用您自己的私钥签署。

如果您想要构建要发布的 APK,您必须首先阅读签署您的应用。本页面说明了生成私钥以及随后使用它来签署 APK 文件的程序。即使您刚刚开始使用,也可以通过构建调试 APK 在模拟器或连接的设备上快速运行您的应用。

您还可以在 build.gradle 文件中定义自定义构建类型,并通过包含 debuggable true 将其配置为作为调试构建签署。如需了解详细信息,请参阅配置构建变体

构建调试 APK

要想立即测试和调试应用,您可以构建调试 APK。调试 APK 通过 SDK 工具提供的调试密钥签署,并允许通过 adb 调试。

要构建调试 APK,请打开命令行,然后导航至项目目录的根 - 在 Android Studio 中,选择 View > Tool Windows > Terminal。要启动调试构建,请调用 assembleDebug 任务:

gradlew assembleDebug

这将在 project_name/module_name/build/outputs/apk/ 中创建一个名称为 module_name-debug.apk 的 APK。此文件已通过调试密钥签署,并与 zipalign 对齐,因此,您可以在设备上立即安装。

或者要构建 APK,并立即在运行的模拟器或连接的设备上安装,请改为调用 installDebug

gradlew installDebug

上述任务名称中的“调试”部分仅仅是构建变体名称的骆驼拼写法版本,因此,可以使用您想要汇编或安装的任何构建变体替换。例如,如果您有“演示”产品风味,则可以通过 assembleDemoDebug 任务构建调试版本。

要查看每个变体可用的所有构建和安装任务(包括卸载任务),请运行 tasks 任务。

另请参阅有关如何在模拟器上运行您的应用在设备上运行您的应用的部分。

构建发布 APK

准备发布和分发应用时,您必须构建一个使用您的私钥签署的发布 APK。

如需了解详细信息,请参阅签署您的应用

在模拟器上运行您的应用

要使用 Android Emulator,您必须使用 Android Studio 创建 Android Virtual Device (AVD)

有了 AVD 后,请启动 Android Emulator,然后执行以下操作安装您的应用:

  1. 在命令行中,导航至 android_sdk/tools/,然后通过指定您的 AVD 启动模拟器:

    emulator -avd avd_name

    如果您不确定 AVD 名称,请执行 emulator -list-avds

  2. 现在,您可以使用上述 Gradle 安装任务或 adb 工具安装您的应用:
    adb install path/to/your_app.apk
    

    所有构建的 APK 均保存在 project_name/module_name/build/outputs/apk/ 中。

如需了解详细信息,请参阅在 Android Emulator 上运行应用

在设备上运行您的应用

您在设备上运行应用之前,必须在设备上启用 USB debugging。您可以在 Settings > Developer options 中找到该选项。

:在运行 Android 4.2 及更新版本的设备上,Developer options 默认情况下处于隐藏状态。如需将其显示出来,请转到 Settings > About phone 并点按 Build number 七次。返回上一屏幕即可找到 Developer options

对设备完成设置并通过 USB 连接后,您可以使用上述 Gradle 安装任务或 adb 工具安装您的应用:

adb -d install path/to/your_app.apk

所有构建的 APK 均保存在 project_name/module_name/build/outputs/apk/ 中。

如需了解详细信息,请参阅在硬件设备上运行应用

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)