Skip to content

mulle-objc/mulle-objc-compat

Repository files navigation

mulle-objc-compat

🍏 Compatibility layer with Apple Objective-C runtime functions

This library maps Apple runtime functions to their mulle-objc counterparts. This makes porting of existing programs that use Apple runtime functions easier. If you can get by with the limited set of functions, these functions are preferable to use over their mulle-objc counterparts for the sake of portability and familiarity.

Release Version Release Notes
Mulle kybernetiK tag Build Status RELEASENOTES

Mental model

This library

  • does not include any other runtime than mulle-objc-runtime.
  • does not define any functionality that is not part of the Apple runtime
  • does not implement everything that's in the Apple runtime

Limitations

  • This library hasn't been scrutinized for thread-safety.
  • Some functionality is missing that mulle-objc does not support. E.g. "weak variables".
  • Message sending via objc_msgSend uses the mulle-objc MetaABI and therefore is only compatible in the case, where there is only one pointer sized parameter and a pointer sized return value.
  • The library must be compiled with mulle-clang (since the multiverse changes)

You are here

Overview

Requirements

Requirement Release Version Description
MulleObjC Mulle kybernetiK tag Build Status πŸ’Ž A collection of Objective-C root classes for mulle-objc

Add

Add as an individual component

Use mulle-sde to add mulle-objc-compat to your project:

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

To only add the sources of mulle-objc-compat with dependency sources use clib:

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

Add -isystem src/mulle-objc to your CFLAGS and compile all the sources that were downloaded with your project.

Install

Install with mulle-sde

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

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

Manual Installation

Install the Requirements and then install mulle-objc-compat with cmake:

cmake -B build \
      -DCMAKE_INSTALL_PREFIX=/usr/local \
      -DCMAKE_PREFIX_PATH=/usr/local \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK