Porting iOS app to the Mac. Catalyst: Where to begin? by Yevhenii Peteliev

Yevhenii Peteliev has covered the basics of porting iPad apps to Mac, talked about common issues and situations when you definitely should think twice before porting the application.

1. Porting iOS app to the Mac. Catalyst: Where to begin? !" 1 Yevhenii Peteliev Mac Software Engineer, MacPaw Inc.
2. Agenda: # Is Mac App Store dying? $ What is Marzipan? % Introduction to Catalyst & Why do we need to use it? ' System features in macOS " How to port iOS App to the Mac? ( Understanding pitfalls ) Tips for beginners 2
3. Is Mac App Store dying? *+ 3
4. iOS vs macOS ,( 4
5. 5 macOS - ~100M
6. 6 iOS /0 ~360M iPads
7. 7 iOS /0 ~900M iPhones
8. Soo… 12 8
9. What Is Marzipan? *3 9
10. Marzipan 4 10 5 With macOS Mojave, Apple is adding support to run UIKit apps on macOS without the requirement of rewriting the UI in AppKit $ It allows iOS developers to build apps for macOS
11. Marzipan 6 11
12. What problem does Marzipan solve? 78 12
13. Problems 13 The glaring difference between Mac and iOS is the user interface While Macs use keyboard, mouse, and a growing number of trackpad gestures, iOS devices are touch-based. Both platforms use different UI code: AppKit on Mac and UIKit on iOS
14. Marzipan < 14 , It is in some ways an evolution of the Simulator 
 5 It doesn’t use the Simulator architecture 4 It includes support for adding buttons to the window, menu bar, focus rings, and much more
15. Support 15 Trackpad and mouse input App window stoplights Window resizing Scroll bars Copy & paste Drag & drop
16. What about Apple? C 16 Home Stocks News Voice Recorder
17. Apple Products 17
18. Home 18
19. Home 19
20. Home 20
21. Stocks 21
22. Stocks 22
23. Stocks 23
24. Stocks 24
25. Stocks 25
26. Voice Recorder 26
27. Voice Recorder 27
28. Voice Recorder ☎ 28
29. Voice Recorder 29
30. Marzipan S 30 , While Marzipan is in use on macOS Mojave, Apple has opted not to make it available for developers because of its relative instability , Developers have already managed to create tools to bring iOS apps to macOS using Marzipan thanks to the Apple apps that were ported
31. Unsupported features 31 UIWebView SFSafariViewController CTTelephonyNetworkInfo SLComposeViewController MFMailComposeViewController OpenGLES AddressBook
32. Soo… 32 iOSMac is disappointingly limited in its compatibility with existing libraries due to its missing frameworks and classes, but surprisingly usable for simple apps
33. Introduction to Catalyst 33
34. Catalyst 34 Catalyst is Apple’s framework that lets developers easily port their iPad apps across to the Mac. It consists of new tools within Xcode and built-in Mac support for a huge number of APIs that will let your iOS apps run natively.
35. Bring Your iPad App to Mac 35
36. Why do we need to use it? 36
37. System features in macOS 12 37
38. 38 The Mac version of your iPad app supports many system features found in macOS without requiring any effort from you System Features
39. System features 39 A default menu bar for your app Support for trackpad, mouse, and keyboard input Support for window resizing and full-screen display Mac-style scroll bars
40. System features 40 Rich text interaction, including copy and paste and contextual menus for editing Support for system Touch Bar controls System Preferences Drag-and-drop support
41. System features 41 Many system-provided UI elements automatically convert from iOS to macOS You get macOS-appropriate versions of the following iOS-provided items: Split view File browser Activity view Contextual actions
42. Configure your app for Mac i% 42
43. 43 App Configuration j
44. 44 App Configuration k
45. App Configuration l 45 When you select Mac as a supported device, Xcode makes the following changes to your project
46. App Configuration m 46 Adds a bundle identifier for the Mac version of your app Adds the App Sandbox Entitlement to your project Adds My Mac to the list of destinations that you can choose when running your app from Xcode Excludes incompatible frameworks, app extensions, and other embedded content
47. App Configuration n 47
48. How to port iOS App to the Mac? op 48
49. 49 q Compile project on iOS13 r Add iPad support, then add macOS s Remove incompatible frameworks t Enclose incompatible embedded content u Setup your .plist Steps to port iOS App to the Mac s
50. What about some practice? 50
51. 51 Main.storyboard
52. 52 Main.storyboard
53. 53 Main.storyboard
54. 54 Simple Demo
55. Want more? !" 55
56. Sign up for the workshop! !" 56
57. Understanding pitfalls xy 57
58. 58 z Incompatible frameworks and embedded content & Highly sophisticated interface { AppSandbox | .plist y ... Pitfalls }
59. 59 z You may need to manually exclude other content. Go to the Frameworks, Libraries, and Embedded Content list under the General tab for your iOS target. Then select iOS as the platform setting for the item Incompatible frameworks
60. 60 Incompatible frameworks
61. 61 Incompatible frameworks
62. 62 & Your project likely contains code that no longer compiles because of frameworks or API that are unavailable to the Mac version of your app Incompatible code
63. 63 • App Sandbox is an access control technology provided in macOS, enforced at the kernel level € It is designed to contain damage to the system and the user’s data if an app becomes compromised. Apps distributed through the Mac App Store must adopt App Sandbox AppSandbox •
64. 64 z The sandbox is enabled automatically once you enable a Catalyst target on your iPad app & Sandbox is not mandatory on macOS. You can disable it and then your app has much more leeway in what it can do on a users system. However, it is required if you want to ship your app on the macOS App Store AppSandbox ‚
65. 65 AppSandbox ƒ
66. Tips for beginners 66
67. 67 Practice, practice and practice
68. 68 Tips&Tricks l„ z Aspiration & Documentation 7 Experimentation
69. 69 z Use technology properly & Take risks into account 7 Don't be afraid to be a discoverer … Start using new features and concepts Conclusion l„
70. Links: ! https://pspdfkit.com/blog/2018/porting-ios-apps-to- mac-marzipan-iosmac-uikit-appkit/ " https://github.com/steventroughtonsmith/marzipanify † https://speakerdeck.com/steipete/hacking-marzipan $ https://kirb.me/2018/06/07/iosmac-research.html ‡ https://developer.apple.com/design/human-interface- guidelines/ios/overview/ipad-apps-for-mac/ 4 https://developer.apple.com/documentation/uikit/ creating_a_mac_version_of_your_ipad_app 4 https://appventure.me/guides/catalyst/features.html 70
71. Thank you for your attention! 71
72. Sooo…questions? Š& 72
73. Contacts: s Email: zhenya.peteliev@macpaw.com € Medium: peteliev • Twitter: peteliev r Facebook: peteliev 73