Rococoa

 Rococoa is a generic Java binding to the Mac Objective-C object system. It allows the creation and use of Objective-C objects in Java, and the implementation of Objective-C interfaces in Java.

⚠ Caution

• this project will quit supporting intel chips
• supported macos will be after Ventura also

Limitation

• obj-c class's method call with float argument doesn't work works → new limitation: arguments should be less equal 8
  • the reason -> actually https://github.com/java-native-access/jna/issues/1476#issuecomment-1292804072
  • https://www.mikeash.com/pyblog/objc_msgsends-new-prototype.html
• obj-c block
• methods have varargs don't work (works less equal 8?)

Install

• https://jitpack.io/#umjammer/rococoa

Usage

How To

• Basics
• CIFilter Java2D BufferedImageOp
• CoreML
• iTunes Library
• AudioUnit Java MIDI SPI synthesizer
• CoreMidi Java MIDI SPI
• AVSpeechSynthesizer Java Speech API
• HEIF Java ImageIO SPI
• MTLibrary
• KeyChain Java crypto Keystore SPI
• Vision Detecting Human Body Poses in Images

References

• https://github.com/ibinti/bugvm
• https://gitlab.com/axet/apple
• https://github.com/multi-os-engine/moe-mac-core
• https://github.com/dthommes/jcocoa
• https://github.com/allertonm/Couverjure
• https://github.com/shannah/Java-Objective-C-Bridge (minecraft uses)
• gamepad
  • http://eleccelerator.com/wiki/index.php?title=DualShock_4
  • https://github.com/born2snipe/gamepad4j/blob/master/gamepad4j-desktop/src/main/c/macos/Gamepad_macosx.c
  • back port hidapi mac part
• obj-block
  • https://github.com/nativelibs4java/BridJ/
  • http://cocoawithlove.com/2009/10/how-blocks-are-implemented-and.html
  • http://www.opensource.apple.com/source/libclosure/libclosure-38/BlockImplementation.txt
  • https://clang.llvm.org/docs/Block-ABI-Apple.html
  • https://github.com/ronaldoussoren/pyobjc/blob/77b98382e52818690449111cd2e23cd469b53cf5/pyobjc-core/Modules/objc/block_support.m
  • PyObjCFFI_MakeBlockFunction
  • https://docs.rs/block/latest/block/
  • https://github.com/mikeash/MABlockClosure
  • https://github.com/PsychoH13/C-ObjC-Blocks
  • alternative
  • https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/CustomizingExistingClasses/CustomizingExistingClasses.html

TODO

• NSUrl tags (wip)
• obj-block (wip)
  • how about panama?
• CIFilter (done)
  • CGImage fails around density related
  • tall free bridging? none
• cglib is mostly suspended
  • cglib recommends ByteBuddy that is based on asm same as the cglib (done)
  • cache classes (ByteBuddy)
• clean up logging
• native library loading
  • https://github.com/scijava/native-lib-loader
  • i don't like to locate librococoa.dylib at src/main/resources for jitpack
  • copy to like src/main/native-resource (on only local not ci)
  • include it in jar-plugin (on jitpack)
  • OR set it as asset on github actions 🎯
  • retrieve the asset by ant task?
• dynamic method creation
  • invokedinamic?
  • ByteBuddy's method interception???
• CGController
  • https://stackoverflow.com/a/65999820
  • works on 14.3.1
  • using block? avoidable?
• activate application
  • https://developer.apple.com/documentation/appkit/nsrunningapplication?language=objc
• separate same parts of jna-platform (like jna-platform-extended)
• deprecate rococoa-contrib
• selector and java method binding for notification
• exception in callback method cannot be shown as reason, shown as "Exception calling method for selector foo:"
  • OCInvocationCallbacks.java:170

Original

Fair Warning

Rococoa is very much work in progress. Much is subject to change. A lot isn't good enough not to change. But given the recent deprecation of the Java-Cocoa bridge, it's the best I've got. Just mind your head. And please give feedback

Oh, one big warning. Rococoa on PPC passes all but one of its tests, but that shows that it has an issue returning longs from Objective-C methods. Please do try it on PPC, and let me know any other problems.

• Take the Whistlestop Tour
• How To
• Quicktime
• Limitations
• Help Wanted

_{image by copilot}