本指南介绍如何在 Android 设备上签名、构建和测试您的应用。
您无需安装 Android SDK。但是,如果您使用的是 Windows 系统,则需要安装正确版本的 Java 开发工具包 (JDK)。有关详细信息,请参阅Java 开发工具包部分。
Android 构建过程会生成两个文件:一个 .apk
文件和一个 .aab
文件。您无需创建Google 开发者帐户即可在 Android 设备上构建和测试应用,但如果您希望将应用发布到Google Play商店,则需要一个帐户。
构建 Android 应用时,会自动生成 Android 应用包文件 (.aab
)。您可以使用此文件将您的应用或游戏提交到 Google Play。
我们仅支持运行
使用 Solar2D 构建 Android 应用时,必须指定包名。通常,您可以指定任何您喜欢的包名,但必须谨慎选择,因为它应该对您的应用程序是唯一的。
传统的 Java 方案是使用com.acme
,然后附加部门/产品的名称,最后附加应用的名称。例如,假设您拥有 acme.com
域名,则 com.acme.games.catchafish
将是一个不错的包名。
在某些情况下,使用
包名包含连字符或其他特殊字符(例如 com.three-amigos
)。在这种情况下,请将特殊字符转换为下划线:com.three_amigos
。
名称组件之一在标识符开头包含数字或其他无效字符(例如 com.3amigos
)。在这种情况下,请尝试将包名转换为类似 com.threeamigos
的名称。
名称组件之一包含关键字,例如 com.private.idaho
。在这种情况下,请在包名的该部分后面加上下划线:com.private_.idaho
。
如果您不熟悉应用可用的构建设置,请在继续本节之前先查看它们。
确保您的 Android 设备已启用为开发设备。
在 Solar2D 模拟器中,选择文件 → 打开… 以加载您要构建的项目。
选择文件 → 构建 → Android…。
填写以下信息:
应用程序名称 — 默认情况下,这将与您的项目文件夹匹配;保留此名称或指定其他名称。
版本代码 — 此值必须是整数。每次更新应用时,都必须增加版本代码。它对应于此处详述的 versionCode
项。用户看不到它。
版本名称 — 指定应用的版本名称。
包 — 请参阅上文Java 包名。
目标应用商店 — 从下拉列表中选择Google Play。
密钥库 / 密钥别名 — 要为 Android 设备构建应用,您必须使用密钥库对应用进行数字签名。请参阅下面的调试构建签名或发布构建签名。
保存到文件夹 — 指定保存已编译应用的位置。
构建后 — 选择应用构建成功后要执行的操作。
创建实时构建 — 选中此框可创建实时构建以进行
点击构建,Solar2D 会将应用编译成标准的 .apk
文件。
对于调试构建,Solar2D 包含一个 debug.keystore
文件,用于在设备上测试您的应用。要使用它,请按照以下步骤操作:
从密钥库菜单中选择调试。
在右侧,浏览… 到 Solar2D SDK 应用程序文件夹中的密钥库文件:
Windows —C:\Program Files (x86)\Corona Labs\Corona\Resources\debug.keystore
macOS —/Applications/Corona/Resources/Resource Library/Android/debug.keystore
选择该文件并输入 android
作为密码。
在密钥别名菜单中,选择 androiddebugkey
。
对于发布构建,您必须使用您的私钥进行签名。您可以使用命令行程序 Keytool 生成此密钥。请按照以下简单步骤操作:
在 Windows 中打开命令提示符,或在 macOS 中打开终端。然后,使用 cd
命令切换到您将保存密钥库的目录。
在提示符处键入以下命令,将 mykeystore
替换为您的应用程序名称,将 aliasname
替换为类似或相同的别名。
keytool -genkey -v -keystore mykeystore.keystore -alias aliasname -keyalg RSA -validity 999999 -deststoretype JKS
有四种方法可以在 Android 设备上安装应用。您不能简单地将 .apk
文件复制到设备上。
如果您使用的是 macOS 版 Solar2D 模拟器,则可以将应用直接复制到连接的设备上。Windows 不支持此功能。
连接您的设备。
按照上文构建流程中概述的步骤操作,确保为构建后选项选择
如果您已安装 Android SDK,请使用 adb install -r your-app.apk
。
将 .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 调试的更多详细信息,请参阅调试指南。