NSExtensionContext

Наследование

NSObject
NSExtensionContext

NSObject
NSExtensionContext

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в iOS 8.0 и позже.

NSExtensionContext объект представляет контекст приложения узла, от которого вызывается расширение приложения.

Когда приложение узла отправляет запрос к расширению приложения, оно обеспечивает дополнительный контекст. Для многих расширений приложения самая важная часть контекста является данными, с которыми пользователь хочет работать, который содержится в inputItems свойство.

Обрабатывание запросов

cancelRequestWithError (_:) - cancelRequestWithError:

Говорит приложению узла отменять запрос расширения приложения, с предоставленной ошибкой.

Объявление

Swift

func cancelRequestWithError(_ error: NSError)

Objective C

- (void)cancelRequestWithError:(NSError *)error

Параметры

error

Ошибочный объект возвратиться. Это должно быть не -nil.

Обсуждение

По возврату, userInfo словарь NSError объект содержит названный ключ NSExtensionItemsAndErrorsKey который имеет как его значение словарь NSExtensionItem объекты и связанный NSError экземпляры.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.


    
    completeRequestReturningItems (_: completionHandler:)
    - completeRequestReturningItems:completionHandler:

Говорит приложению узла завершать запрос расширения приложения с массивом элементов результата.

Объявление

Swift

func completeRequestReturningItems(_ items: [AnyObject]?, completionHandler completionHandler: ((Bool) -> Void)?)

Objective C

- (void)completeRequestReturningItems:(NSArray *)items completionHandler:(void (^)(BOOL expired))completionHandler

Параметры


      items

Массив элементов результата, каждый NSExtensionItem объект, для возврата к приложению узла.


      completionHandler

Дополнительный блок, который вызовут, когда запрос завершается, выполняемый как фоновая приоритетная задача.

Блок берет следующий параметр:


      expired

Булево значение, указывающее, завершает ли система предыдущий вызов completionHandler блок.

Этот параметр YEStrue когда система преждевременно завершает a completionHandler блок, ранее вызванный и иначе не истекший.

Обсуждение

Вызов этого метода в конечном счете отклоняет контроллер представления расширения приложения.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.

Открытие URLs


    
    openURL (_: completionHandler:)
    - openURL:completionHandler:

Просит система открывать URL от имени расширения в настоящее время запущенного приложения.

Объявление

Swift

func openURL(_ URL: NSURL, completionHandler completionHandler: ((Bool) -> Void)?)

Objective C

- (void)openURL:(NSURL *)URL completionHandler:(void (^)(BOOL success))completionHandler

Параметры

URL

URL для открытия.


      completionHandler

Блок, который вызовут, когда открылся URL.

Блок берет следующий параметр:


      success

Булево значение, указывающее, была ли операция открытия успешна.

Обсуждение

Каждая точка расширения определяет, поддерживать ли этот метод, или под который условия поддерживать этот метод. В iOS 8 только Сегодня точка расширения (используемый для создания Сегодня виджетов) поддерживает этот метод.

Важный

Apple позволяет любому Сегодня виджет для использования openURL:completionHandler: метод для открытия виджета, собственного содержащий приложение.

При использовании этого метода для открытия других приложений от Вашего Сегодня виджет, отправка приложения в магазин могла бы повлечь за собой дополнительный анализ для обеспечения соответствия с намерением Сегодня виджетов.

Для узнавания больше считайте Инструкции по Анализу App Store и Инструкции по Интерфейсу пользователя iOS, соединенные с от Страницы поддержки Анализа Приложения Apple

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.

Хранение дополнительных элементов

inputItems Свойство

Список ввода NSExtensionItem объекты связались с контекстом. (только для чтения)

Объявление

Swift

var inputItems: [AnyObject] { get }

Objective C

@property(readonly, copy, nonatomic) NSArray *inputItems

Обсуждение

Если контекст не имеет никаких входных элементов, этот массив пуст.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.

Константы

Дополнительный ключ элементов и ошибок
Этот ключ используется в userInfo словарь NSError объект, возвращенный cancelRequestWithError:.

Объявление

Swift

let NSExtensionItemsAndErrorsKey: String

Objective C

NSString *const NSExtensionItemsAndErrorsKey;

Константы
- NSExtensionItemsAndErrorsKey
  
  Ключ, значение которого является словарем NSExtensionItem объекты и связанный NSError экземпляры.
  
  Доступный в iOS 8.0 и позже.

Уведомления

NSExtensionHostDidBecomeActiveNotification NSExtensionHostDidBecomeActiveNotification

Отправленный, когда приложение узла расширения перемещается от неактивного до активного состояния.
Расширения могут использовать это уведомление для корректировки их действия, когда они становятся активными. object параметр содержит NSExtensionContext объект. Это уведомление не содержит a userInfo словарь.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.2 и позже.
NSExtensionHostWillResignActiveNotification NSExtensionHostWillResignActiveNotification

Отправленный, когда приложение узла расширения перемещается от активного до неактивного состояния.
Расширения могут использовать это уведомление для корректировки их действия, когда они становятся неактивными. Например, Вы могли бы использовать это уведомление для сохранения любых несохраненных данных, чтобы препятствовать тому, чтобы он был потерян. object параметр содержит NSExtensionContext объект. Это уведомление не содержит a userInfo словарь.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.2 и позже.
NSExtensionHostDidEnterBackgroundNotification NSExtensionHostDidEnterBackgroundNotification

Отправленный, когда приложение узла расширения начинает работать в фоновом режиме.
Расширения могут использовать это уведомление, чтобы остановить задачи и подготовить расширение, которое будет приостановлено. object параметр содержит NSExtensionContext объект. Это уведомление не содержит a userInfo словарь.
Расширения получают только короткий срок для выполнения любой фоновой работы. При необходимости в большем количестве времени для выполнения критических задач, используйте методы NSProcessInfo класс для запроса того времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.2 и позже.
NSExtensionHostWillEnterForegroundNotification NSExtensionHostWillEnterForegroundNotification

Отправленный, когда приложение узла расширения начинает работать на переднем плане.
Расширения могут использовать это уведомление для перезапуска задач, которые оно остановило, когда они переместились в фон. object параметр содержит NSExtensionContext объект. Это уведомление не содержит a userInfo словарь.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.2 и позже.