Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/showxu/objc4

A latest buildable and debuggable Objective-C runtime (objc4-818.2) project.
https://github.com/showxu/objc4

dyld objc objc-723 objc-779 objc-781 objc-787 objc-818 objc-818-2 objc-runtime objc4 objc4-723 objc4-779 objc4-781 objc4-787 objc4-818 objc4-818-2 objc4-runtime runtime xnu

Last synced: about 12 hours ago
JSON representation

A latest buildable and debuggable Objective-C runtime (objc4-818.2) project.

Host: GitHub
URL: https://github.com/showxu/objc4
Owner: showxu
License: mit
Created: 2017-12-12T08:32:36.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2022-05-14T10:22:50.000Z (over 2 years ago)
Last Synced: 2024-08-10T14:11:40.071Z (3 months ago)
Topics: dyld, objc, objc-723, objc-779, objc-781, objc-787, objc-818, objc-818-2, objc-runtime, objc4, objc4-723, objc4-779, objc4-781, objc4-787, objc4-818, objc4-818-2, objc4-runtime, runtime, xnu
Language: Objective-C++
Homepage: https://opensource.apple.com/tarballs/objc4/
Size: 1.22 MB
Stars: 533
Watchers: 13
Forks: 89
Open Issues: 6
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# objc4 runtime

### [简体中文](README_zh-CN.md)

![build_status](https://github.com/showxu/objc4/workflows/build/badge.svg) 

[![Join the chat at https://gitter.im/showxu/objc4](https://badges.gitter.im/showxu/objc4.svg)](https://gitter.im/showxu/objc4?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 

![support](https://img.shields.io/badge/support-macOS%20%7C%20iOS-orange.svg)

This project is a buildable and debuggable version of latest Objective-C runtime (**objc4-818.2**) on [Apple Open Source](https://opensource.apple.com/tarballs/objc4/)

- [Which version to use](#Which-Version-To-Use)

- [Installation](#Installation)

- [Usage](#Usage)

- [objc4 tarballs](#objc4-tarballs)

- [Build Phases](#Build-Phases)

- [Build Setting](#build-setting)

- [License](#license)

## **Which Version To Use**

| macOS | macOS Version | Xcode Version | objc4 tarball version |

| - | - | - | - |

| [![macOS Big Sur](https://img.shields.io/badge/macOS-Big%20Sur-blue?colorA=d23a70&colorB=181B2D)](https://developer.apple.com/macos/) | ![macOS Version](https://img.shields.io/badge/-11.0.1%20-181B2D) | [![Xcode 12.3](https://img.shields.io/badge/Xcode-12.3-blue?colorA=1A5DE3&colorB=2A2C3A)](https://developer.apple.com/xcode/) | [objc4-818.2](https://github.com/showxu/objc4/releases/tag/objc4-818.2) |

| [![macOS Catalina](https://img.shields.io/badge/macOS-Catalina-blue?colorA=314C78&colorB=181B2D)](https://developer.apple.com/macos/) | ![macOS Version](https://img.shields.io/badge/-10.15.4%20~%2010.15.6-181B2D) | [![Xcode 12.0](https://img.shields.io/badge/Xcode-12.0-blue?colorA=1A5DE3&colorB=2A2C3A)](https://developer.apple.com/xcode/) | [objc4-787.1](https://github.com/showxu/objc4/releases/tag/objc4-787.1) |

| [![macOS Catalina](https://img.shields.io/badge/macOS-Catalina-blue?colorA=314C78&colorB=181B2D)](https://developer.apple.com/macos/) | ![macOS Version](https://img.shields.io/badge/-10.15.1-181B2D) | [![Xcode 11.1](https://img.shields.io/badge/Xcode-11.1-blue?colorA=1A8DF8&colorB=2A2C3A)](https://developer.apple.com/xcode/) | [objc4-781](https://github.com/showxu/objc4/releases/tag/objc4-781) | 

| [![macOS High Sierra](https://img.shields.io/badge/macOS-High%20Sierra-blue?colorA=CC4027&colorB=181B2D)](https://developer.apple.com/macos/) | ![macOS Version](https://img.shields.io/badge/-10.13.x-181B2D) | [![Xcode 10.1](https://img.shields.io/badge/Xcode-10.1-blue?colorA=1A8DF8&colorB=2A2C3A)](https://developer.apple.com/xcode/) | [objc4-723](https://github.com/showxu/objc4/releases/tag/objc4-723) |

## **Installation**

#### Manually

Download zip or clone this repo, select **objc scheme** and build.

## **Usage**

After building the **objc scheme**, manually integrate generated `libobjc.A.dylib` into your project manually. Or you can use **objc-inspect** scheme which is a preset inspector for debugging objc4 runtime.

## **objc4 tarballs**

- [objc4-818.2](https://opensource.apple.com/tarballs/objc4/objc4-818.2.tar.gz)

- [xnu-7195.50.7.100.1](https://opensource.apple.com/tarballs/xnu/xnu-7195.50.7.100.1.tar.gz)

- [Libc-1439.40.11](https://opensource.apple.com/tarballs/Libc/Libc-1439.40.11.tar.gz)

- [dyld-832.7.1](https://opensource.apple.com/tarballs/dyld/dyld-832.7.1.tar.gz)

- [libauto-187.tar.gz](https://opensource.apple.com/tarballs/libauto/libauto-187.tar.gz)

- [libclosure-74](https://opensource.apple.com/tarballs/libclosure/libclosure-74.tar.gz)

- [libdispatch-1173.40.5](https://opensource.apple.com/tarballs/libdispatch/libdispatch-1173.40.5.tar.gz)

- [libplatform-220](https://opensource.apple.com/tarballs/libplatform/libplatform-220.tar.gz)

- [libpthread-416.40.3](https://opensource.apple.com/tarballs/libpthread/libpthread-416.40.3.tar.gz)

## **Build Phases**

#### Private Header 

| objc header | #include | tarball |

|------|--------|---------|

| objc-os.h | `#include ` | /xnu-6153.41.3/bsd/sys/reason.h |

| objc-os.h | `#include ` | /dyld-733.6/include/mach-o/dyld_priv.h |

| objc-os.h | `#include ` | /libplatform-220/private/os/lock_private.h |

| lock_private.h | `#include ` | /libplatform-220/private/os/base_private.h |

| objc-os.h | `#include ` | removed in latest Libc tarball (Libc-1353.41.1), this header should be commented-out |

| objc-class.mm | `#include ` | /xnu-7195.50.7.100.1/os/linker_set.h |

| pthread_machdep.h | `#include ` | /xnu-6153.41.3/osfmk/machine/cpu_capabilities.h |

| objc-os.h | `#include ` | /libpthread-416.40.3/private/workqueue_private.h | 

| objc-os.h | `#include ` | /dyld-733.6/include/objc-shared-cache.h | 

| objc-errors.mm | `#include <_simple.h>` | /libplatform-220/private/_simple.h | 

| objc-block-trampolines.mm | `#include ` | /libclosure-74/Block_private.h |

| objc-os.h | `#include ` | /Libc-1353.41.1/include/crt_externs.h |

| objc-runtime-new.mm | `#include ` | /xnu-6153.41.3/osfmk/mach/shared_region.h |

| objc-cache.mm  | `#include ` | /xnu-6153.41.3/osfmk/mach/restartable.defs, build from xnu kernel |

| objc-os.h | `#include_next ` => `#include ` | /Libc-825.24/include/CrashReporterClient.h | 

| NSObject.mm | `#include ` | /xnu-7195.50.7.100.1/os/reason_private |

| NSObject.mm | `#include ` | /xnu-7195.50.7.100.1/os/reason_private |

| objc-exception.mm | `#include ` | removed |

| objc-gdb.h | `#include ` | removed |

#### Private Header Included Header

| private header | #include | tarball |

|------|--------|---------|

| tsd_private.h | `#include ` | /xnu-6153.41.3/libsyscall/os/tsd.h |

| tsd_private.h | `#include ` | /libpthread-416.40.3/private/spinlock_private.h |

| lock_private.h | `#include ` | /libpthread-416.40.3/private/tsd_private.h |

| workqueue_private.h | `#include ` | /llibpthread-416.40.3/private/qos_private.h |

| qos_private.h | `#include `  | /libpthread-416.40.3/sys/qos_private.h |

#### Bridge OS

In public macosx sdk (latest Xcode 12.3), bridgeos (e.g. `__has_feature(attribute_availability_bridgeos)`) is unavailable, bridgeos availability should be removed or commented-out.

#### dyld

In latest dyld-733.6 (dyld-421.2 later), apple use this [ruby script](https://opensource.apple.com/source/dyld/dyld-733.6/bin/expand.rb) to expand versions, platfrom versions from a `versionSets` which defined in a YAML file, code generated by this script will be inserted after `@MAC_VERSION_DEFS@`, `@IOS_VERSION_DEFS@`, `@WATCHOS_VERSION_DEFS@`, `@TVOS_VERSION_DEFS@` and `@BRIDGEOS_VERSION_DEFS@` in `dyld_priv.h`. For more detail please refer to [dyld](https://opensource.apple.com/source/dyld).

#### XNU

`` is generated form `restartable.defs` in xnu tarball during building xun kernel, which is a little different from the one that shipped with public sdk that located in `/Library/Developer/CommandLineTools/SDKs/MacOSX10.15.sdk/System/Library/Frameworks/Kernel.framework/Versions/A/Headers/kern/restartable.h`.

#### Cambria framework

Have no idea about this framework so far, maybe related with `-loah` for lib `oah`. Related Code should be commented out for now.

```objc

// File objc-cache.mm

// 

// Line 87 ~ 88

#include 

#include 

// 

// ···

//

// Line 1121 ～ 1128 

if (oah_is_current_process_translated()) {

    kern_return_t ret = objc_thread_get_rip(threads[count], (uint64_t*)&pc);

    if (ret != KERN_SUCCESS) {

        pc = PC_SENTINEL;

    }

} else {

    pc = _get_pc_for_thread (threads[count]);

}

```

#### `#include `

Have no idea about this haeder so far. Related Code should be commented out for now.

```objc

// File objc-runtime.mm

// 

// ···

//

// Line 36

#include  // os_feature_enabled_simple()

//

// ···

//

// Line 444 ～ 446

if (!os_feature_enabled_simple(objc4, preoptimizedCaches, true)) {

    DisablePreoptCaches = true;

}

// 

```

#### `dyld_fall_2020_os_versions`, `dyld_fall_2018_os_versions`

Found releated source in `xnu-7195.50.7.100.1/bsd/kern/kern_mman.c`. 

```c

static uint32_t

proc_2020_fall_os_sdk(void)

```

Maybe these function is releated to dyld build-scripts. Comment out for now.

#### `dyld_platform_version_macOS_`, `dyld_platform_version_iOS_`, `dyld_platform_version_tvOS_`, `dyld_platform_version_watchOS_`, `dyld_platform_version_bridgeOS_`

This Marco is generated by [dyld build-scripts](https://opensource.apple.com/source/dyld/dyld-832.7.1/build-scripts/), comment out for now.

#### `STATIC_ASSERT`

```bash

objc4/runtime/objc-runtime-new.mm:176:1: '_static_assert' declared as an array with a negative size

```

Comment out for now.

## **Build Setting**

| Declaration | Value |

|-------------|-------|

| `HEADER_SEARCH_PATHS` | $(SRCROOT)/../macosx.internal/System/Library/Frameworks/System.framework/PrivateHeaders, also append `$(inherited)` to target objc |

| `GCC_PREPROCESSOR_DEFINITIONS` | LIBC_NO_LIBCRASHREPORTERCLIENT, also append `$(inherited)` to target objc |

| `ORDER_FILE` | $(SRCROOT)/libobjc.order |

| `OTHER_LDFLAGS[sdk=macosx*]` | -lc++abi -Xlinker -sectalign -Xlinker __DATA -Xlinker __objc_data -Xlinker 0x1000 -Xlinker -interposable_list -Xlinker interposable.txt, remove build setting in target objc |

| `OTHER_LDFLAGS[sdk=iphoneos*][arch=*]` | -lc++abi -Wl,-segalign,0x4000 -Xlinker -sectalign -Xlinker __DATA -Xlinker __objc_data -Xlinker 0x1000 -Xlinker -interposable_list -Xlinker interposable.txt, remove build setting in target objc |

| `OTHER_LDFLAGS[sdk=iphonesimulator*][arch=*]` | -lc++abi -Xlinker -interposable_list -Xlinker interposable.txt, remove build setting in target objc |

### Run Script

Evidently public macosx sdk is our only choice, we need to update value of parameter `-sdk` from `macosx.internal` to `macosx` in run script of objc target. 

## License

This project is released under the **MIT License**. The objc4 project is released under the **APPLE PUBLIC SOURCE LICENSE Version 2.0**.