HarmonyOS Next开发学习手册——LLDB高性能调试器

871 篇文章 15 订阅
504 篇文章 1 订阅

概述

LLDB(Low Level Debugger)是新一代高性能调试器。详细说明参考 LLDB官方文档 。

当前HarmonyOS中的LLDB工具是在 llvm15.0.4 基础上适配演进出来的工具,是HUAWEI DevEco Studio工具中默认的调试器,支持调试C和C++应用。

工具获取

可通过HUAWEI DevEco Studio下载SDK获取LLDB调试工具。

以Windows平台为例,lldb.exe的存放路径为sdk\ HarmonyOS版本 \base\native\llvm\bin。例如“sdk\HarmonyOS-NEXT-DP1\base\native\llvm\bin”。

lldb-server分为user用户工具和root用户工具。适用于user用户的lldb-server是带签名的工具。

路径说明
sdk[HarmonyOS版本]\openharmony\native\llvm\lib\clang\15.0.4\bin\aarch64-linux-ohos\lldb-server适用于root镜像aarch64-linux-ohos架构的lldb-server
sdk[HarmonyOS版本]\openharmony\native\llvm\lib\clang\15.0.4\bin\arm-linux-ohos\lldb-server适用于root镜像arm-linux-ohos架构的lldb-server
sdk[HarmonyOS版本]\openharmony\native\llvm\lib\clang\15.0.4\bin\arm-linux-ohos\lldb-server适用于root镜像x86_64-linux-ohos架构的lldb-server
sdk[HarmonyOS版本]\hms\native\lldb\aarch64-linux-ohos\lldb-server适用于user镜像aarch64-linux-ohos架构的lldb-server
sdk[HarmonyOS版本]\hms\native\lldb\arm-linux-ohos\lldb-server适用于user镜像aarch64-linux-ohos架构的lldb-server
sdk[HarmonyOS版本]\hms\native\lldb\x86_64-linux-ohos\lldb-server适用于user镜像x86_64-linux-ohos架构的lldb-server

功能列表

此处列举LLDB调试器支持的部分功能,更多命令参考: LLDB工具使用指导 。Windows、Linux x86_64和Mac平台的LLDB工具有些许差异,以实际应用为准。

  • 记录日志
  • 断点管理
  • 观察点管理
  • 表达式处理
  • 查看变量
  • 进程/线程管理
  • 汇编处理
  • 源码信息获取
  • 信号处理
  • 进程启动
  • attach进程

应用场景

  • 本地调试

    • Linux x86_64本地调试。
      LLDB支持在Linux x86_64环境上调试C和C++应用。

    • Mac桌面本地调试。
      LLDB支持在Mac桌面(包括Mac x86_64和M1系统)调试C和C++应用。

  • 远程调试

    • 基于HUAWEI DevEco Studio的远程调试。
      LLDB支持基于HUAWEI DevEco Studio在Windows和Mac桌面连接HarmonyOS设备或模拟器远程调试Native C++应用,即使用HUAWEI DevEco Studio的Debug调试功能。

    • 桌面连接HarmonyOS设备远程调试。
      HarmonyOS设备为root镜像,SELinux关闭:LLDB支持在Windows、Mac桌面和Linux x86_64环境直连HarmonyOS设备远程调试C和C++应用以及可执行二进制。
      HarmonyOS设备为root镜像,SELinux开启:LLDB支持在Windows、Mac桌面和Linux x86_64环境直连HarmonyOS设备远程调试C和C++应用以及可执行二进制,但是lldb-server和要调试的应用或可执行二进制只能放在/data/local/tmp/debugserver目录内。
      HarmonyOS设备是user镜像,SELinux开启:LLDB支持在Windows、Mac桌面和Linux x86_64环境直连HarmonyOS设备远程调试基于HUAWEI DevEco Studio编译的带签名的debug版本的hap包,目前仅支持此类调试。

说明
root镜像:使用hdc shell id命令查询到“uid=0(root)”,或执行hdc shell进入交互命令环境,提示符为“#”。
user镜像:使用hdc shell id命令查询到“uid=2000(shell)”,或执行hdc shell进入交互命令环境,提示符为“$”。
SELinux开启模式:使用hdc shell getenforce命令查询到“Enforcing”。
SELinux关闭模式:使用hdc shell getenforce命令查询到“Permissive”。

使用指导-本地调试

说明

Linux x86_64或Mac本地调试步骤一致。

使用LLDB工具启动应用并进行调试

此处以在Linux x86_64环境调试一个使用clang编译器生成的带有调试信息的可执行文件a.out为例。

源文件:hello.cpp

#include <iostream>
using namespace std;
int main() {
    cout << "hello world!" <<endl;
    return 0;
}

编译:

<clang distribution>/bin/clang++ -g hello.cpp -o a.out
  1. 获取到与LLDB同一版本的clang编译器生成的带有调试信息的可执行文件a.out。
  2. 运行LLDB工具,并指定要调试的文件为a.out。
./lldb a.out
  1. 在代码中main函数处设置断点。
(lldb) b main
  1. 运行应用,使其停在断点处。
(lldb) run
  1. 继续运行应用。
(lldb) continue
  1. 列出所有断点。
(lldb) breakpoint list
  1. 显示当前帧的参数和局部变量。
(lldb) frame variable
  1. 按需执行调试命令进行后续调试操作。
  2. 退出调试。
(lldb) quit

使用LLDB工具调试已经启动的应用

此处以在Mac环境调试一个使用clang编译器生成的带有调试信息和用户输入的可执行文件a.out为例。

源文件:hello.cpp

#include <iostream>
using namespace std;

int main() {
    int i = 0, j = 5, sum = 0;
    cout << "Please input a number of type int”" <<endl;
    cin >> i;
    cout << i;
    sum = i + j;
    cout << sum <<endl;
    return 0;
}

编译:

<clang distribution>/bin/clang++ -g hello.cpp -o a.out
  1. 在终端窗口1启动应用。(窗口会返回一条信息“Please input a number of type int”)
./a.out
  1. 在终端窗口2运行LLDB工具。
./lldb
  1. attach应用。
(lldb) process attach --name a.out
  1. 在hello.cpp的第10行设置断点。
(lldb) breakpoint set --file hello.cpp --line 10
  1. 在终端窗口1,输入一个int类型的数。
88
  1. 在终端行窗口2继续运行应用,使应用停在断点处。
(lldb) continue
  1. 按需执行调试命令进行后续调试操作。
  2. detach应用。
(lldb) detach
  1. 退出调试。
(lldb) quit

说明
步骤 attach应用 和 设置断点 可以调换顺序执行。

使用指导-远程调试

说明

  • 基于HUAWEI DevEco Studio的远程调试参考官方调试指导
  • 远程调试时需要lldb-server和lldb配合使用。注意根据设备镜像选择user或root版的lldb-server。详情参考表1 lldb-server工具目录
  • Windows,Linux x86_64和Mac远程调试步骤一致。

Windows平台连接aarch64-linux-ohos架构root镜像SELinux关闭的Harmony设备进行远程调试

源文件:hello.cpp

#include <iostream>
using namespace std;
int main() {
    cout << "hello world!" <<endl;
    return 0;
}

编译:

<clang distribution>/bin/clang++ --target=aarch64-linux-ohos --sysroot=<sysroot distribution> -g hello.cpp -o a.out
  1. 打开命令行窗口1,将lldb-server和可执行文件a.out推送到设备。
hdc file send lldb-server /data/local/tmp
hdc file send a.out /data/local/tmp
hdc shell chmod 755 /data/local/tmp/lldb-server /data/local/tmp/a.out
  1. 运行lldb-server。(8080为有效且当前未被占用的端口号,用户可自定义)
hdc shell ./data/local/tmp/lldb-server p --server --listen "*:8080"
  1. 打开命令行窗口2,运行二进制文件lldb。
lldb
  1. 在LLDB命令行窗口进行远端选择与连接。
(lldb) platform select remote-ohos
(lldb) platform connect connect://localhost:8080 
  1. 指定要调试的设备上的二进制文件a.out。
(lldb) target create /data/local/tmp/a.out
  1. 在代码中main函数处设置断点。
(lldb) b main
  1. 启动应用。
(lldb) run
  1. 查看当前目标进程的源码。
(lldb) source list
  1. 按需执行调试命令进行后续调试操作。
  2. 退出调试。
(lldb) quit

Windows平台连接aarch64-linux-ohos架构user镜像SELinux开启的HarmonyOS设备进行远程调试

说明

  • 调试过程中需保持设备在非锁屏状态,锁屏不允许启动调试器调试。
  • 基于HUAWEI DevEco Studio调试user镜像SELinux开启的HarmonyOS设备的hap包。

FAQ

  • 当在lldb命令行窗口执行run返回信息为:“error:‘A’ packet returned an error: 8”或类似信息,则意味着不允许调试器启动用于调试的进程,一般都是因为没有权限导致的,请确认调试设备是否限制调试。
  • 运行lldb-server,报错“Permission denied”。一般是lldb-server无可执行文件导致的,添加权限即可。

鸿蒙全栈开发全新学习指南

之前总有很多小伙伴向我反馈说,不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以这里为大家准备了一份实用的鸿蒙(HarmonyOS NEXT)学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。

本路线共分为四个阶段

第一阶段:鸿蒙初中级开发必备技能

在这里插入图片描述

第二阶段:鸿蒙南北双向高工技能基础:gitee.com/MNxiaona/733GH

第三阶段:应用开发中高级就业技术

第四阶段:全网首发-工业级南向设备开发就业技术:gitee.com/MNxiaona/733GH

《鸿蒙 (Harmony OS)开发学习手册》(共计892页)

如何快速入门?

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识:gitee.com/MNxiaona/733GH

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开发

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

鸿蒙开发面试真题(含参考答案):gitee.com/MNxiaona/733GH

鸿蒙入门教学视频:

美团APP实战开发教学:gitee.com/MNxiaona/733GH

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
  • 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:gitee.com/MNxiaona/733GH

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值