mulle-objc-debug

🐞 Debug support for the mulle-objc-runtime

Dump runtime classes as HTML or Graphviz dot files. There is also CSV export functionality. This library is used by MulleObjC to provide debugger and debugging support.

Release Version	Release Notes	AI Documentation
	RELEASENOTES	DeepWiki for mulle-objc-debug

Documentation & Guides

• API Summary
• Coder Guide

You are here

Requirements

Requirement	Release Version	Description
mulle-objc-runtime		⏩ A fast, portable Objective-C runtime written 100% in C

Quickstart

mulle-sde init -d my-project -m mulle-objc/objc-developer executable
cd my-project
mulle-sde vibecoding on
mulle-sde run
mulle-sde dependency toc mulle-objc/mulle-objc-debug

You are done, skip the following "Add" step.

Add

Use mulle-sde to add mulle-objc-debug to your project. As long as your sources are using #include "include-private.h" and your headers use #include "include.h", there will nothing more to do:

mulle-sde add github:mulle-objc/mulle-objc-debug

To only add the sources of mulle-objc-debug with all the sources of its dependencies replace "github:" with clib::

Legacy adds

One common denominator is that you will likely have to add #include <mulle-objc-debug/mulle-objc-debug.h> to your source files.

Add sources to your project with clib

clib install --out src/mulle-objc mulle-objc/mulle-objc-debug

Add -isystem src/mulle-objc to your CFLAGS and compile all the sources that were downloaded with your project. (In cmake add include_directories( BEFORE SYSTEM src/mulle-objc) to your CMakeLists.txt file).

Add as subproject with cmake

Add mulle-objc-debug and its dependencies to your CMakeLists.txt with FetchContent:

include( FetchContent)

include_directories( SYSTEM "${CMAKE_BINARY_DIR}/include")

set( MULLE__OBJC__RUNTIME_TAG "master" CACHE STRING "branch or tag to fetch mulle-objc-runtime from")

FetchContent_Declare( MULLE__OBJC__RUNTIME
   GIT_REPOSITORY https://github.com/mulle-objc/mulle-objc-runtime.git
   GIT_TAG        "${MULLE__OBJC__RUNTIME_TAG}")
FetchContent_MakeAvailable( MULLE__OBJC__RUNTIME)

set( MULLE__OBJC__DEBUG_TAG "master" CACHE STRING "branch or tag to fetch mulle-objc-debug from")

FetchContent_Declare( MULLE__OBJC__DEBUG
   GIT_REPOSITORY https://github.com/mulle-objc/mulle-objc-debug.git
   GIT_TAG        "${MULLE__OBJC__DEBUG_TAG}")
FetchContent_MakeAvailable( MULLE__OBJC__DEBUG)

target_link_libraries( ${PROJECT_NAME} PUBLIC mulle-objc-debug)

Install

Use mulle-sde to build and install mulle-objc-debug and all dependencies:

mulle-sde install --prefix /usr/local \
   https://github.com/mulle-objc/mulle-objc-debug/archive/latest.tar.gz

Legacy Installation

Requirements

Install all requirements

Requirements	Description
mulle-objc-runtime	⏩ A fast, portable Objective-C runtime written 100% in C

Download & Install

Download the latest tar or zip archive and unpack it.

Install mulle-objc-debug into /usr/local with cmake:

PREFIX_DIR="/usr/local"
cmake -B build                               \
      -DMULLE_SDK_PATH="${PREFIX_DIR}"       \
      -DCMAKE_INSTALL_PREFIX="${PREFIX_DIR}" \
      -DCMAKE_PREFIX_PATH="${PREFIX_DIR}"    \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK