iOS extension CocoaHeads Taipei 2014/11/13

1. iOS Extension
Prince

2. ⺩王品⼠士 (Prince)
@wpsteak
github , linkedin

3. • App Extensions
• Today Widget & Demo

4. 2007

6. App

7. App
Folder
Badge

8. Scenario 1

9. Edit a photo
Photo Home Find App Wait App Open
Find PhotoEdit Photo

10. Edit a photo
Photo Select App Edit Photo
Photo Editing Extension

11. Scenario 2

12. See scores from your
favorite team
Home Find App Wait App Open
wait for loading
Auto upload
Rate me
Cache
Sync
8:1

13. See scores from your
favorite team
Home
8:1
Today Extension
Widget

14. How an App Extension
Works

15. Open URL
Shared
Resources
App
extension
Host
app
Containing
app
Request
Response

16. App
extension
Host
app
Containing
app

17. Host app
• An app that a user employs to choose an app
extension is called a host app
Host
app
Today.app
Today
Chrome.app
Share/Action
Dropbox.app
Document Provider
Photo.app
Photo Editing

18. • an app that contains one or more extensions is
called a containing app
Containing app
Containing
app
extension extension extension

19. • an app that contains one or more extensions is
called a containing app
Containing app

20. App extension
• an app extension lets you extend custom
functionality and content beyond
App
extension

21. App extension
• an app extension lets you extend custom
functionality and content beyond

22. Today Extension

23. Today Extension

24. Today Extension

25. Today Extension

26. Today Extension

27. Dropbox
TodayView
Today.app
How an App Extension
Communicates

28. Dropbox
TodayView
Today.app
Database
How an App Extension
Communicates

29. Dropbox.app
Dropbox
TodayView
Today.app
Open URL
Database
How an App Extension
Communicates

30. Open URL
Shared
Resources
App
extension
Host
app
Containing
app
How an App Extension
Communicates

31. Share Extension

32. Share Extension

33. Share Extension

34. Share Extension

35. Share Extension

36. App
extension
Host
app
Containing
app
Pocket AddToPocket Chrome
Server

37. App
extension
Host
app
AddToPocket Chrome

38. Accessed via Apple
frameworks code
App
extension
Host
app
System
Framework

39. App
extension
Host
app
AddToPocket Chrome
UIActivityViewControllerSLComposeServiceViewController
Accessed via Apple
frameworks code

40. Extension Type Host App host app use
Today Today.app NotificationCenter.framework
Share any app UIActivityViewController
Action any app UIActivityViewController
Photo Editing Photo.app
PhotosUI.framework
Photos.framework
Document Provider any app UIDocumentPickerViewController
Custom Keyboard any app
Host
app

41. Extension Type Enter point
Today
UIViewController
<NCWidgetProviding>
Share SLComposeServiceViewController
Action SLComposeServiceViewController UI and non-UI variants
Photo Editing
UIViewController
<PHContentEditingController>
Document Provider UIDocumentPickerViewController UI and non-UI variants
Custom Keyboard UIInputViewController
App
extension

42. App
extension
Host
app
Containing
app
Pocket AddToPocket Chrome
Server

43. App
extension
Containing
app
Pocket AddToPocket
Different process
• Isolated address space
• Executes independently
• System optimizes
separately
Run Separately

44. App
extension
Containing
app
Shared
Resources
Share Resource
App Group
• UserDefault
• FileManager

45. Share Resource
NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@“group.domain"];
NSURL *directory = [[NSFileManager defaultManager]
containerURLForSecurityApplicationGroupIdentifier:@"group.domain"];

46. App
extension
Containing
app
Pocket AddToPocket
ServerServer
• Same data model
• Same logic
• Same views
Share Code

47. App
extension
Containing
app
Pocket AddToPocket
ServerServer
• Framework
• Static library
Share Code

48. Share Code
NSURL *containerURL = [[NSFileManager defaultManager]
containerURLForSecurityApplicationGroupIdentifier:@"group.domain"];
NSString *sorPath = [NSString stringWithFormat:@"%@/Dylib.framework",[[NSBundle
mainBundle] bundlePath]];
NSString *desPath = [NSString stringWithFormat:@“%@/Library/Caches/
Dylib.framework",containerURL.path];
BOOL copyResult = [[NSFileManager defaultManager] copyItemAtPath: sorPath toPath:desPath
error:&err];

49. • Containing app is still most important
• Extension cannot without containing app
• Don't have full use of system resources
• Make it seamless
• Make it useful

50. Demo

51. Demo
• a light bulb
• sample code
• Wifi Environment

52. App Extension
• Create an app extension by adding a new target
to an app
• Add necessary libraries to extension target
• ViewController

53. Load View
• with storyboard
• NSExtensionMainStoryboard
• without interface file
• NSExtensionPrincipalClass

54. viewController’s life cycle
• initWithCoder:
• viewDidLoad
• widgetMarginInsetsForProposedMarginInsets:
• widgetPerformUpdateWithCompletionHandler:
• viewWillAppear:
• viewDidAppear:

55. • widgetMarginInsetsForProposedMarginInsets

56. User Interface
• UIView
• UIButton
• UILabel
• UITextField
• UIScrollView

57. Some APIs are Unavailable
to App Extensions
• Access a sharedApplication object
• Use any API marked in header files with the NS_EXTENSION_UNAVAILABLE macro,
or similar unavailability macro, or any API in an unavailable framework
• Access the camera or microphone on an iOS device
• Perform long-running background tasks
• The specifics of this limitation vary by platform, as described in the extension point
chapters in this document.
• (An app extension can initiate uploads or downloads using an NSURLSession
object, with results of those operations reported to the containing app.)
• Receive data using AirDrop
• (An app extension can send data using AirDrop in the same way an app does: by
employing the UIActivityViewController class.)

58. App Store
• NOTE ABOUT 64-BIT ARCHITECTURE
• An app extension target must include the arm64 (iOS) or x86_64 architecture
(OS X) in its Architectures build settings or it will be rejected by the App
Store. Xcode includes the appropriate 64-bit architecture with its “Standard
architectures” setting when you create a new app extension target.
• If your containing app target links to an embedded framework, the app must
also include 64-bit architecture or it will be rejected by the App Store.

59. App Store

60. End