JUCE Toys 开源项目使用教程

JUCE Toys 开源项目使用教程

juce-toysDebugging utilities in a JUCE Module, plus NatVis and LLDB customizations项目地址:https://gitcode.com/gh_mirrors/ju/juce-toys

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

JUCE Toys 项目的目录结构如下：

juce-toys/
├── juce_lldb_xcode.py
├── LICENSE
├── README.md
├── juce_natvis
│   ├── juce_core.natvis
│   ├── juce_data.natvis
│   ├── juce_events.natvis
│   ├── juce_graphics.natvis
│   ├── juce_gui_basics.natvis
│   └── juce_gui_extra.natvis
└── juce_module
    ├── jcf_debug
    │   ├── ComponentDebugger.cpp
    │   ├── ComponentDebugger.h
    │   ├── README.md
    │   └── screenshot.png
    ├── adsr_editor.cpp
    ├── adsr_editor.h
    └── jcf_debug.cpp

目录结构介绍

• juce_lldb_xcode.py: LLDB 自定义脚本文件。
• LICENSE: 项目许可证文件，采用 MIT 许可证。
• README.md: 项目说明文档。
• juce_natvis: 包含多个 NatVis 文件，用于在 Visual Studio 中自定义 JUCE 类型的显示。
• juce_module: 包含 JUCE 模块和调试工具。
  • jcf_debug: 包含组件调试工具的源代码和头文件。
  • adsr_editor.cpp 和 adsr_editor.h: 一个基本的但外观不错的包络编辑器。
  • jcf_debug.cpp: JUCE 调试模块的源代码。

2. 项目的启动文件介绍

JUCE Toys 项目没有明确的启动文件，因为它主要提供调试工具和自定义显示功能。如果需要使用其中的调试工具，可以在自己的 JUCE 项目中包含 juce_module 目录，并根据需要引入相应的源文件和头文件。

例如，要使用 ComponentDebugger，可以在项目中包含 juce_module/jcf_debug/ComponentDebugger.cpp 和 juce_module/jcf_debug/ComponentDebugger.h。

3. 项目的配置文件介绍

JUCE Toys 项目没有传统的配置文件，但提供了一些自定义的调试工具和 NatVis 文件。以下是一些关键的配置和使用说明：

NatVis 文件

juce_natvis 目录下的 NatVis 文件用于在 Visual Studio 中自定义 JUCE 类型的显示。这些文件需要在 Visual Studio 中进行配置，具体步骤如下：

1. 打开 Visual Studio。
2. 进入 工具 -> 选项 -> 调试 -> NatVis。
3. 添加 juce_natvis 目录下的所有 NatVis 文件。

LLDB 自定义脚本

juce_lldb_xcode.py 文件是一个 LLDB 自定义脚本，用于在 Xcode 中自定义 JUCE 类型的显示。使用方法如下：

1. 打开 Xcode。
2. 进入 Preferences -> Behaviors -> Edit。
3. 添加一个新的行为，并在 Run 中选择 Run Script。
4. 输入以下命令：

   command script import /path/to/juce-toys/juce_lldb_xcode.py
   

调试工具

juce_module/jcf_debug 目录下的 ComponentDebugger 是一个组件调试工具，可以用于调试 JUCE 组件。使用方法如下：

1. 在项目中包含 juce_module/jcf_debug/ComponentDebugger.cpp 和 juce_module/jcf_debug/ComponentDebugger.h。
2. 在需要调试的组件中实例化 ComponentDebugger 并附加到目标组件上。

#include "ComponentDebugger.h"

class MyComponent : public juce::Component
{
public:
    MyComponent()
    {
        addAndMakeVisible(debugger);
        debugger.attachToComponent(this);
    }

private:
    ComponentDebugger debugger;
};

通过以上步骤，可以在项目中使用 JUCE Toys 提供的调试工具和自定义显示功能。

juce-toysDebugging utilities in a JUCE Module, plus NatVis and LLDB customizations项目地址:https://gitcode.com/gh_mirrors/ju/juce-toys