使用 Android Lua Helper 在VSCODE中调试安卓Lua应用

创作时间:

作者:

@小白创作中心

使用 Android Lua Helper 在VSCODE中调试安卓Lua应用

引用

来源

https://www.cnblogs.com/flying_bat/p/18399955

在安卓应用开发中，Lua作为一种轻量级脚本语言，被广泛应用于游戏开发等领域。然而，由于Lua的特殊性，相关的开发工具并不像主流语言那样完善。本文将介绍如何在VSCODE中使用Android Lua Helper插件来调试安卓Lua应用，帮助开发者提高开发效率和代码质量。

一、VSCODE 与 Android Lua Helper 的功能特点

Visual Studio Code（VSCODE）是一款功能强大的代码编辑器，它以其高度可定制的界面、强大的扩展生态系统、流畅的性能表现以及对众多编程语言的天然支持而备受开发者青睐。在众多的开发场景中，VSCODE 都展现出了卓越的性能和灵活性。

Lua 作为一种轻量级的脚本语言，在游戏开发、移动应用开发等领域有着广泛的应用。然而，由于Lua是一门小众语言，相关的开发工具并不像主流语言那样完善。

Android Lua Helper 插件的出现，为开发者提供了一系列强大的功能，极大地提高了Lua代码的开发效率和质量。Android Lua Helper 插件具有多种功能，如符号定义跳转、代码格式化、符号查找、全局引用查找以及智能代码补全、语法错误检测、Lua代码片段提示等。这些功能使得开发者在编写Lua代码时更加高效和准确。例如，代码补全功能可以大大减少开发者的输入时间，提高开发速度；语法错误检测功能可以帮助开发者及时发现并修复代码中的错误，避免在运行时出现问题。

Android Lua Helper 插件还拥有低内存消耗和高实时性的优点，即便面对规模庞大的项目，也能流畅运行，毫无卡顿之感。此外，Android Lua Helper 插件还支持多种Lua版本，如Lua 5.1和Lua 5.3，满足了不同项目的需求。插件的不断更新和改进也为开发者提供了更好的开发体验。

Android Lua Helper 支持使用安卓ADB工具连接手机，实现远程调试，安装卸载应用，截屏到本地，启动scrcpy等。

总之，VSCODE与Android Lua Helper的结合为Android开发中的Lua语言项目提供了强大的支持，使得开发者能够更加高效地进行开发工作。

二、VSCODE 与 Android Lua Helper 的集成

首先，我们需要安装VSCODE，然后安装Android Lua Helper插件。点击此链接直接在VSCODE中安装，或在VSCODE的软件商店安装Android Lua Helper插件极为简便。首先打开VSCODE，目光聚焦于侧边栏底部，那里有一个扩展商店入口图标，形似方块。轻轻点击此图标，便会开启一个全新视图，其中罗列着众多插件。接着，在搜索栏中输入Android Lua Helper并按下回车键。随后，在搜索结果里找到Android Lua Helper插件，点击 “安装” 按钮。待安装完成，再点击 “重新加载” 按钮以启用该插件。

插件安装完成后，我们需要配置VSCODE，以支持Android Lua Helper的调试。

三、调试配置全流程

（一）创建 launch.json 文件

在安装好Android Lua Helper插件后，点击运行按钮，接着点击创建launch.json，选择调试器时，我们要选择AndroidLuaHelper：Debug。这个过程就像是为我们的调试之旅搭建起了一座桥梁。它为后续的调试工作提供了基础的配置框架，确保我们能够顺利地进行Lua代码的调试。

在launch.json文件中，我们添加了如下内容：

"connectionPort"字段用于指定调试端口，默认为8818。
stopOnEntry字段尤为关键。通过将其置为false，可以避免在程序入口处进行断点，使得调试过程更加流畅。例如，在一些复杂的项目中，如果stopOnEntry为true，可能会导致调试过程一开始就被中断，难以快速定位到实际的问题点。通过将其置为false，我们可以更加灵活地控制调试的起点，提高调试效率。
enableRemotePath字段用于是否启用远程路径，默认为true。
remotePath字段用于指定远程路径，默认为/sdcard/Download/script.zip。会把本地的工程文件打包成zip包，上传到手机的此目录。APP需要加载此目录的脚本来进行解压，然后运行和调试。

（二）添加LuaPanda.lua文件到项目中

按快捷键Ctrl+Shift+P，输入AndroidLuaHelper：Copy Debug file，再按回车键。选择合适的项目目录后LuaPanda.lua文件会自动复制到目录下，并命名为LuaPanda.lua。

（三）插入调试代码到合适的文件

在合适的文件（如：main.lua）中，按快捷键Ctrl+Shift+P，输入AndroidLuaHelper：Insert Debugger Code，再按回车键。插入如下代码：

默认端口为8818，与launch.json文件中的"connectionPort"要一致。

（四）连接到安卓手机

Android Lua Helper会自动检测手机，如果检测不到，则需要手动输入。点击边栏上的安卓按钮，接着点击Input Device IP Address按钮，或按快捷键Ctrl+Shift+P，输入AndroidLuaHelper：Input Device IP Address，再按回车键，依次输入IP地址和端口号。