CodeLLDB 项目教程

CodeLLDB 项目教程

codelldbA native debugger extension for VSCode based on LLDB项目地址:https://gitcode.com/gh_mirrors/co/codelldb

1. 项目的目录结构及介绍

CodeLLDB 是一个基于 LLDB 的 VSCode 原生调试器扩展。以下是项目的目录结构及其介绍：

codelldb/
├── adapter/
├── cmake/
├── debuggee/
├── extension/
├── formatters/
├── images/
├── lldb/
├── syntaxes/
├── tests/
├── tools/
├── typings/
├── .gitignore
├── BUILDING.md
├── CHANGELOG.md
├── CMakeLists.txt
├── Cargo.lock
├── Cargo.toml
├── LICENSE
├── MANUAL.md
├── README.md
├── azure-pipelines.yml
├── cargo_config.unix.toml
├── cargo_config.windows.toml

目录介绍

• adapter/: 包含调试器适配器的相关文件。
• cmake/: 包含 CMake 构建系统的相关文件。
• debuggee/: 包含调试目标的相关文件。
• extension/: 包含 VSCode 扩展的主要代码。
• formatters/: 包含数据格式化器的相关文件。
• images/: 包含项目使用的图像文件。
• lldb/: 包含 LLDB 调试器的相关文件。
• syntaxes/: 包含语法定义的相关文件。
• tests/: 包含测试脚本和测试数据。
• tools/: 包含开发工具和辅助脚本。
• typings/: 包含类型定义的相关文件。
• .gitignore: Git 忽略文件。
• BUILDING.md: 构建指南。
• CHANGELOG.md: 变更日志。
• CMakeLists.txt: CMake 构建配置文件。
• Cargo.lock: Cargo 锁定文件。
• Cargo.toml: Cargo 配置文件。
• LICENSE: 项目许可证。
• MANUAL.md: 用户手册。
• README.md: 项目自述文件。
• azure-pipelines.yml: Azure Pipelines 配置文件。
• cargo_config.unix.toml: Unix 系统上的 Cargo 配置文件。
• cargo_config.windows.toml: Windows 系统上的 Cargo 配置文件。

2. 项目的启动文件介绍

CodeLLDB 项目的启动文件主要是 extension/src/extension.ts。这个文件是 VSCode 扩展的入口点，负责初始化调试器并注册各种调试功能。

// extension/src/extension.ts
import * as vscode from 'vscode';
import { DebugAdapterDescriptorFactory } from './debugAdapterDescriptorFactory';
import { Logger } from './logger';

export function activate(context: vscode.ExtensionContext) {
    const logger = new Logger();
    context.subscriptions.push(vscode.debug.registerDebugAdapterDescriptorFactory('lldb', new DebugAdapterDescriptorFactory(logger)));
}

export function deactivate() {
    // Clean up resources if necessary
}

启动文件功能

• 激活扩展: activate 函数在扩展被激活时调用，注册调试适配器工厂。
• 注销扩展: deactivate 函数在扩展被停用时调用，进行资源清理。

3. 项目的配置文件介绍

CodeLLDB 项目的配置文件主要包括 Cargo.toml 和 launch.json。

Cargo.toml

Cargo.toml 是 Rust 项目的配置文件，定义了项目的依赖、构建选项和其他元数据。

[package]
name = "codelldb"
version = "1.0.0"
edition = "2018"

[dependencies]
vscode = "1.0.0"

launch.json

launch.json 是 VSCode 的调试配置文件，定义了调试会话的启动配置。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug with CodeLLDB",
            "type": "lldb",
            "request": "launch",
            "program": "${workspaceFolder}/target/debug/my_program",
            "args": [],
            "cwd": "${workspaceFolder}",
            "sourceLanguages": ["rust"]
        }

codelldbA native debugger extension for VSCode based on LLDB项目地址:https://gitcode.com/gh_mirrors/co/codelldb