At WWDC 2018 Apple announced that they are working on a multi-year strategy to make it easier to port UIKit applications to the Mac. While some first-party applications such as the Home & News app are going to use this API in macOS 10.14, third-party developers won't have official access for another year. As a result, I made this project to help tinkerers/other impatient people get a taste of what's to come when Apple gives everyone access to Marzipan next year.
Requirements/Notes
macOS 10.14 Mojave & Xcode 10 (note: apparently Virtual Machines do not work with Marzipan, so you'll need a real Mac/Hackintosh to make magic happen)
Disabling SIP & adding the amfi_get_out_of_my_way=0x1 to your boot-args (Hopefully we can circumvent the entitlement check with a less brutish method in the near future)
Requires jtool to parse the MachO loader commands.
Requires optool to edit the MachO header of our almost final product.
Patience
No longer requires any environment variables because the best rules are no rules.
Still probably requires a beer or two.
Caveats
Requires you to disable SIP & add amfi_get_out_of_my_way=0x1 to your boot-args. There has to be a better way.
Seems to crash my debugger/Mac a lot (not sure if this is a me or a Mojave beta issue)
The UIKitSystem process doesn't usually stop running when you stop debugging your app. It's best if you leave sshd open (I mean we already killed code signing, what's the worst that could happen) and connected so you can kill UIKitSystem if your development machine locks up. Thanks goes to @stroughtonsmith and @_inside for the gnarly tip!
Build instructions
Install Xcode 10, go to Preferences -> Locations -> select Xcode 10 for Command Line Tools
Disable SIP and AMFI:
boot into Recovery Mode (hold Cmd+R while rebooting), open Terminal from menu bar
Open MarzipanPlatter/MarzipanPlatter.xcodeproj, go to MarzipanPlatter in sidebar -> MarzipanPlatter target -> General
Change Signing -> Team to your team, let Xcode regenerate provisioning profiles
Go to Build Settings tab, and set the JTOOL_PATH and OPTOOL_PATH user-defined settings to the respective locations where you installed jtool/optool
Also, you can set the IOSMAC_PLATFORM_NAME user-definied setting to either iosmac or macos. iosmac will use the linking magic to create an iOSMac binary and macos will create a patched macOS binary that requires the CFMZEnabled=1 environment variable to be set before launching the app. However, you can also link things like AppKit with a macOS binary.
Hit Run (or use the CLI method below)
Build Release & Run (from the CLI)
If you're running into oh my goodness my Mac keeps dying issues when debugging, I've provided some simple instructions to create a release version of your Marzipan app.
To build the archive:
xcodebuild archive -scheme MarzipanPlatter -archivePath ./build/MarzipanPlatter.xcarchive
To export the .app from the archive:
xcodebuild -exportArchive -archivePath ./build/MarzipanPlatter.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath ./build/
To run MarzipanPlatter with the useful CFMZEnabled environment variable:
./build/MarzipanPlatter.app/Contents/MacOS/MarzipanPlatter
@zhuowei for coming up with the clever ldwrap method. Definitely check out the MarzipanTool repo listed below.
@Morpheus______ for the awesome jtool and *OS Internals books that have taught me many things.
Related Projects
MarzipanTool - Tools to build and run iOS UIKit applications on macOS 10.14 Mojave, using the iOSMac framework announced at WWDC.
Questions/Comments
It's probably best if you leave an issue if you have a real problem with this code. However, you can tweet/DM me @NSBiscuit on Twitter if you want to chat about life/snakes/random thoughts/etc.
客服电话
APP下载
官方微信
请发表评论