从命令行构建您的应用
要使用包装器运行任务,请使用下列命令之一:
- 在 Windows 上:
- 在 Mac 或 Linux 上:
要查看您的项目所有可用构建任务的列表,请执行 tasks
:
本页其余部分将介绍使用 Gradle 包装器构建和运行应用的基础知识。如需了解有关如何设置 Android 构建的详细信息,请参阅。
如果您更愿意使用 Android Studio 工具,而不是命令行工具,请参阅构建和运行您的应用。
默认情况下,每个 Android 应用可以使用两种构建类型:一种用于调试您的应用 - 调试构建,另一种用于向用户发布您的应用 - 发布构建。您在模拟器或设备上安装之前,必须使用证书签署从每个构建生成的 APK。调试构建通过 SDK 工具提供的调试密钥自动签署(不安全,您无法将此 APK 发布到 Google Play 商店),而发布构建必须使用您自己的私钥签署。
如果您想要构建要发布的 APK,您必须首先阅读。本页面说明了生成私钥以及随后使用它来签署 APK 文件的程序。即使您刚刚开始使用,也可以通过构建调试 APK 在模拟器或连接的设备上快速运行您的应用。
您还可以在 build.gradle
文件中定义自定义构建类型,并通过包含 debuggable true
将其配置为作为调试构建签署。如需了解详细信息,请参阅配置构建变体。
要想立即测试和调试应用,您可以构建调试 APK。调试 APK 通过 SDK 工具提供的调试密钥签署,并允许通过 调试。
- gradlew assembleDebug
这将在 project_name/module_name/build/outputs/apk/
中创建一个名称为 module_name-debug.apk
的 APK。此文件已通过调试密钥签署,并与 zipalign
对齐,因此,您可以在设备上立即安装。
或者要构建 APK,并立即在运行的模拟器或连接的设备上安装,请改为调用 installDebug
:
上述任务名称中的“调试”部分仅仅是名称的骆驼拼写法版本,因此,可以使用您想要汇编或安装的任何构建变体替换。例如,如果您有“演示”产品风味,则可以通过 assembleDemoDebug
任务构建调试版本。
要查看每个变体可用的所有构建和安装任务(包括卸载任务),请运行 任务。
另请参阅有关如何在模拟器上运行您的应用和的部分。
准备发布和分发应用时,您必须构建一个使用您的私钥签署的发布 APK。
如需了解详细信息,请参阅签署您的应用。
要使用 Android Emulator,您必须使用 Android Studio 。
- 在命令行中,导航至
android_sdk/tools/
,然后通过指定您的 AVD 启动模拟器:
- emulator -avd avd_name
如果您不确定 AVD 名称,请执行 emulator -list-avds
。
所有构建的 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 -d install path/to/your_app.apk
所有构建的 APK 均保存在 中。
如需了解详细信息,请参阅在硬件设备上运行应用。