Skip to content

ExtensionKit tvOS xcode26.1 b1

Alex Soto edited this page Sep 22, 2025 · 2 revisions

#ExtensionKit.framework

diff -ruN /Applications/Xcode_26.0.1.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXAppExtensionBrowserViewController.h /Applications/Xcode_26.1.0-beta.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXAppExtensionBrowserViewController.h
--- /Applications/Xcode_26.0.1.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXAppExtensionBrowserViewController.h	2025-08-02 19:50:24
+++ /Applications/Xcode_26.1.0-beta.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXAppExtensionBrowserViewController.h	2025-09-07 23:48:51
@@ -23,11 +23,37 @@
 API_UNAVAILABLE(visionos)
 EXTENSIONKIT_EXPORT
 #if TARGET_OS_OSX
-/// A view controller that allows users to enable and disable extensions.
+/// A view controller that displays an interface to enable or disable the host
+/// app’s extensions.
+///
+/// When your host app supports app extensions, use this view controller to give
+/// people a way to enable or disable those extensions. When you present this view
+/// controller, the system displays an out-of-process UI with a list of all app
+/// extensions that support your app’s extension points. Someone using your app
+/// can use the presented interface to enable or disable extensions selectively.
+/// App extensions you include inside your host app’s bundle are enabled by default,
+/// but extensions that ship in separate apps are disabled by default.
+///
+/// Present this view controller modally from your app, or embed the view controller
+/// as a child in one of your existing view controller interfaces. For example, you
+/// might choose to embed the view controller in a tab of your app’s preferences interface.
 @interface EXAppExtensionBrowserViewController : NSViewController
 @end
 #else
-/// A view controller that allows users to enable and disable extensions.
+/// A view controller that displays an interface to enable or disable the host
+/// app’s extensions.
+///
+/// When your host app supports app extensions, use this view controller to give
+/// people a way to enable or disable those extensions. When you present this view
+/// controller, the system displays an out-of-process UI with a list of all app
+/// extensions that support your app’s extension points. Someone using your app
+/// can use the presented interface to enable or disable extensions selectively.
+/// App extensions you include inside your host app’s bundle are enabled by default,
+/// but extensions that ship in separate apps are disabled by default.
+///
+/// Present this view controller modally from your app, or embed the view controller
+/// as a child in one of your existing view controller interfaces. For example, you
+/// might choose to embed the view controller in a tab of your app’s preferences interface.
 @interface EXAppExtensionBrowserViewController : UIViewController
 @end
 #endif // TARGET_OS_OSX
diff -ruN /Applications/Xcode_26.0.1.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXHostViewController.h /Applications/Xcode_26.1.0-beta.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXHostViewController.h
--- /Applications/Xcode_26.0.1.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXHostViewController.h	2025-08-02 19:50:24
+++ /Applications/Xcode_26.1.0-beta.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/ExtensionKit.framework/Headers/EXHostViewController.h	2025-09-08 00:02:18
@@ -23,26 +23,48 @@
 API_UNAVAILABLE(watchos, tvos, visionos)
 EXTENSIONKIT_EXPORT
 #if TARGET_OS_OSX
-/// A view controller that hosts remote views provided by an extension.
+/// A view controller that hosts remote views provided by an app extension.
+///
+/// Present this view controller from your app’s interface to display the content for
+/// an associated app extension. Configure the view controller with the app extension
+/// identity and the specific scene you want to display. Use the associated delegate
+/// object to receive notifications when the app extension becomes active or inactive.
+///
+/// For more information about presenting this view controller and using it to display
+/// an app extension’s UI, see
+/// <doc://com.apple.documentation/documentation/extensionkit/including-extension-based-ui-in-your-interface>.
 @interface EXHostViewController : NSViewController
 #else
-/// A view controller that hosts remote views provided by an extension.
+/// A view controller that hosts remote views provided by an app extension.
+///
+/// Present this view controller from your app’s interface to display the content for
+/// an associated app extension. Configure the view controller with the app extension
+/// identity and the specific scene you want to display. Use the associated delegate
+/// object to receive notifications when the app extension becomes active or inactive.
+///
+/// For more information about presenting this view controller and using it to display
+/// an app extension’s UI, see
+/// <doc://com.apple.documentation/documentation/extensionkit/including-extension-based-ui-in-your-interface>.
 @interface EXHostViewController : UIViewController
 #endif
 
-/// The connection delegate.
+/// A custom delegate object you use to receive notifications about the activation
+/// and deactivation of the app extension.
 @property (weak, nonatomic, nullable) id<EXHostViewControllerDelegate> delegate;
 
 #if TARGET_OS_OSX
-/// A view that’s used when the view controller has no content to display.
+/// The view to display when the view controller has no app extension content to display.
 @property (strong, nonatomic) NSView* placeholderView;
 #else
-/// A view that’s used when the view controller has no content to display.
+/// The view to display when the view controller has no app extension content to display.
 @property (strong, nonatomic) UIView* placeholderView;
 #endif
 
-/// Attempts to connect to the extension over XPC.
+/// Initiates an XPC connection to the app extension’s scene.
 ///
+/// Call this method from your delegate's ``EXHostViewControllerDelegate/hostViewControllerDidActivate:``
+/// method to initiate a scene-specific connection to the app extension. 
+///
 /// - Returns: An object representing the connection.
 -(nullable NSXPCConnection*)makeXPCConnectionWithError:(NSError* __nullable*)error;
 
@@ -54,29 +76,26 @@
 @protocol EXHostViewControllerDelegate <NSObject>
 @optional
 
-/// A delegate method the view controller calls when a connection succeeds.
+/// Tells the host that the app extension is active and ready to accept an XPC connection.
 ///
-/// This delegate method gets called when the extension process has launched and
-/// the remote scene connects. After this delegate method gets called the host
-/// view controller can establish an XPC connection with the scene in the
-/// extension process.
+/// The host view controller calls this method after it launches an app extension and
+/// connects to its remote scene. Use this method to establish an XPC connection to
+/// the newly created UI instance.
 ///
 /// - Parameters:
-///   - viewController: The user interface object from the remote process.
+///    - viewController: The host view controller that initiated the connection.
 -(void)hostViewControllerDidActivate:(EXHostViewController*)viewController NS_SWIFT_UI_ACTOR;
 
-/// A delegate method the host view controller calls when an extension
-/// disconnects.
+/// Tells the host that the app extension disconnected and is no longer available.
 ///
-/// Called when the host view controller stops hosting the remote user
-/// interface. This can occur when the extension exits or when the view
-/// controller’s configuration property changes.
+/// The host view controller calls this method when the app extension exits or when
+/// you change the view controller’s ``EXHostViewController/configuration`` property.
+/// Use this method to close out the previous connection to the app extension.
 ///
 /// - Parameters:
-///   - viewController: The view controller for the extension that’s disconnecting
-///
-///   - error: An error object containing information about why the object
-/// disconnected, or `nil` if it’s disconnecting without error.
+///    - viewController: The host view controller that initiated the connection.
+///    - error: An error object indicating why the app extension disconnected, or `nil`
+///    if the extension exited without issues.
 -(void)hostViewControllerWillDeactivate:(EXHostViewController*)viewController error:(nullable NSError *)error NS_SWIFT_UI_ACTOR;
 
 @end
Clone this wiki locally