Android 签名和构建

本指南介绍如何在 Android 设备上签名、构建和测试您的应用。

注意事项

Java 包名

使用 Solar2D 构建 Android 应用时,必须指定包名。通常,您可以指定任何您喜欢的包名,但必须谨慎选择,因为它应该对您的应用程序是唯一的。

传统的 Java 方案是使用反向域名格式,例如 com.acme,然后附加部门/产品的名称,最后附加应用的名称。例如,假设您拥有 acme.com 域名,则 com.acme.games.catchafish 将是一个不错的包名。

在某些情况下,使用反向域名格式 生成的包名可能无效,必须先进行修改,Solar2D 才能构建您的 Android 应用。以下情况均属于这种情况:

构建流程

重要
  • 如果您不熟悉应用可用的构建设置,请在继续本节之前先查看它们。

  • 确保您的 Android 设备已启用为开发设备。

  1. 在 Solar2D 模拟器中,选择文件打开… 以加载您要构建的项目。

  2. 选择文件构建Android…

  3. 填写以下信息:

    • 应用程序名称 — 默认情况下,这将与您的项目文件夹匹配;保留此名称或指定其他名称。

    • 版本代码 — 此值必须是整数。每次更新应用时,都必须增加版本代码。它对应于此处详述的 versionCode 项。用户看不到它。

    • 版本名称 — 指定应用的版本名称。

    • — 请参阅上文Java 包名

    • 目标应用商店 — 从下拉列表中选择Google Play

    • 密钥库 / 密钥别名 — 要为 Android 设备构建应用,您必须使用密钥库对应用进行数字签名。请参阅下面的调试构建签名发布构建签名

    • 保存到文件夹 — 指定保存已编译应用的位置。

    • 构建后 — 选择应用构建成功后要执行的操作。

    • 创建实时构建 — 选中此框可创建实时构建以进行闪电般快速的测试。有关详细信息,请参阅生成实时构建

  4. 点击构建,Solar2D 会将应用编译成标准的 .apk 文件。

调试构建签名

对于调试构建,Solar2D 包含一个 debug.keystore 文件,用于在设备上测试您的应用。要使用它,请按照以下步骤操作:

  1. 密钥库菜单中选择调试

  2. 在右侧,浏览… 到 Solar2D SDK 应用程序文件夹中的密钥库文件:

Windows —C:\Program Files (x86)\Corona Labs\Corona\Resources\debug.keystore

macOS —/Applications/Corona/Resources/Resource Library/Android/debug.keystore

  1. 选择该文件并输入 android 作为密码。

  2. 密钥别名菜单中,选择 androiddebugkey

发布构建签名

对于发布构建,您必须使用您的私钥进行签名。您可以使用命令行程序 Keytool 生成此密钥。请按照以下简单步骤操作:

  1. 在 Windows 中打开命令提示符,或在 macOS 中打开终端。然后,使用 cd 命令切换到您将保存密钥库的目录。

  2. 在提示符处键入以下命令,将 mykeystore 替换为您的应用程序名称,将 aliasname 替换为类似或相同的别名。

keytool -genkey -v -keystore mykeystore.keystore -alias aliasname -keyalg RSA -validity 999999 -deststoretype JKS

  1. 系统将提示您输入凭据。提供所请求的信息,然后点击回车键对您的 Android 应用进行签名。

设备安装

有四种方法可以在 Android 设备上安装应用。您不能简单地将 .apk 文件复制到设备上。

复制到设备

如果您使用的是 macOS 版 Solar2D 模拟器,则可以将应用直接复制到连接的设备上。Windows 不支持此功能。

  1. 连接您的设备。

  2. 按照上文构建流程中概述的步骤操作,确保为构建后选项选择复制到设备并启动

Android SDK

如果您已安装 Android SDK,请使用 adb install -r your-app.apk

Web 服务器

.apk 文件上传到 Web 服务器。然后,将 Android 设备的 Web 浏览器指向该文件的 URL,以下载该应用到设备。最后,点击下载历史记录中的文件进行安装。

如果此方法失败,并且应用程序以下载为文本文件,则您可能需要将以下配置行添加到 Web 服务器上应用程序目录中的 .htaccess 文件:

AddType application/vnd.android.package-archive .apk

此外,如果您使用的是 debug.keystore,则应将您的设备设置为安装非市场应用。点击设备上的设置图标,选择应用程序,然后选中未知来源旁边的框。

应用安装程序

从 Google Play 获取应用安装程序以协助完成此过程。

调试

Google 的 Android SDK 提供了一组称为 Android 调试桥 (ADB) 的工具。这些工具可让您查看设备的控制台日志、安装和替换设备上的现有应用。您可以从 macOS 的终端或 Windows 的命令提示符执行 adb 命令。还会安装一个名为 monitor 的 GUI 工具;它可用于检查日志文件并从您的设备捕获屏幕截图。

有关 Android 调试的更多详细信息,请参阅调试指南