Action Extension: co to jest, jak działa i tworzenie rozszerzenia

Czym jest Action Extension

Action Extension to typ rozszerzenia iOS app extension, który umożliwia wykonanie akcji na treści bezpośrednio w kontekście aplikacji hosta. Użytkownik zaznacza tekst w Safari, naciska „Akcje” i wybiera na przykład „Sprawdź pisownię” — rozszerzenie przetwarza tekst i zwraca wynik bez opuszczania przeglądarki. Rozszerzenie otrzymuje dane wejściowe przez NSExtensionContext i może zwrócić zmodyfikowaną treść z powrotem.

Action Extension pojawił się w iOS 8 jako część architektury app extensions. Jego kluczową cechą jest to, że rozszerzenie nie ma własnego interfejsu (opcjonalnie) i działa w kontekście aplikacji hosta. Użytkownik nie opuszcza bieżącego ekranu, co zapewnia minimalną przerwę poznawczą. Według Apple, Action Extension to jedyny typ rozszerzenia, który może jednocześnie czytać i modyfikować treść aplikacji hosta (przez NSExtensionContext ze zwrotem wyniku).

Gdzie stosuje się Action Extension

Action Extension jest używany w różnych scenariuszach: tłumaczenie tekstu w przeglądarce, tworzenie PDF ze strony internetowej, stosowanie filtru do zdjęcia w galerii, sprawdzanie pisowni w dowolnym polu tekstowym, skracanie URL, szyfrowanie tekstu i dodawanie do zakładek. Uniwersalność Action Extension czyni go popularnym narzędziem dla aplikacji kategorii „Narzędzia” i „Produktywność”.

Action Extension a Share Extension

Action Extension i Share Extension są często mylone, ale ich przeznaczenie jest zasadniczo różne. Share Extension wysyła treść z aplikacji hosta do twojej aplikacji; Action Extension przetwarza treść i zwraca ją z powrotem. Różnica wpływa na architekturę, doświadczenie użytkownika i wymagania konfiguracji Info.plist.

Jak użytkownik wybiera akcję

Action Extension pojawia się w menu akcji (Action Sheet) po naciśnięciu przycisku „Udostępnij” lub „...”. iOS automatycznie umieszcza Action Extensions w górnej części arkusza (akcje), a Share Extensions w dolnej (aplikacje). Scenariusz użytkownika: zaznaczył tekst → nacisnął „Akcje” → wybrał twoje Action Extension → otrzymał przetworzony wynik bez przełączania aplikacji.

Architektura Action Extension

Action Extension składa się z targetu w Xcode, UIViewController do wyświetlania interfejsu (opcjonalnie), NSExtensionContext do wejścia-wyjścia danych oraz konfiguracji Info.plist. Architektura jest prostsza niż w Share Extension: nie ma obowiązkowego interfejsu compose, a rozszerzenie może działać całkowicie bez UI.

Komponenty Action Extension

Target — oddzielny bundle z identyfikatorem dziedziczonym z głównej aplikacji. UIViewController — opcjonalny interfejs do wyświetlania postępu, ustawień lub wyniku. NSExtensionContext — kontener z danymi wejściowymi (inputItems) i metodą completeRequest do zwracania wyniku. Info.plist — konfiguracja aktywacji przez NSExtensionActivationRule i atrybuty (NSExtensionAttributes) do określania obsługiwanych typów treści.

NSExtensionContext i przepływy danych

Action Extension otrzymuje dane wejściowe przez extensionContext?.inputItems — tablicę NSExtensionItem. Każdy element zawiera załączniki z danymi i UTI. Po przetworzeniu rozszerzenie wywołuje completeRequest(returningItems:) z tablicą wyjściowych NSExtensionItem. Aplikacja hosta otrzymuje przetworzone dane i wyświetla je. Model asynchroniczny: rozszerzenie może wykonywać długotrwałe operacje, utrzymując kontekst do 30 sekund.

Tworzenie Action Extension

Rozważmy tworzenie Action Extension w Swift do tłumaczenia zaznaczonego tekstu. Rozszerzenie otrzymuje tekst z aplikacji hosta, wysyła go na serwer tłumaczeń i zwraca wynik. ActionViewController — podstawowy kontroler tworzony przez Xcode po dodaniu targetu.

import UIKit
import MobileCoreServices

class ActionViewController: UIViewController {

    @IBOutlet var resultLabel: UILabel!

    override func viewDidLoad() {
        super.viewDidLoad()
        extractTextAndTranslate()
    }

    func extractTextAndTranslate() {
        guard let item = extensionContext?.inputItems.first
                as? NSExtensionItem
        else { return }

        for attachment in item.attachments ?? [] {
            attachment.loadItem(
                forTypeIdentifier: kUTTypePlainText as String
            ) { [weak self] (text, error) in
                guard let inputText = text as? String else { return }
                TranslationService().translate(inputText, from: "en", to: "ru") {
                    translated in
                    DispatchQueue.main.async {
                        self?.resultLabel?.text = translated
                    }
                }
            }
        }
    }
}

Po przetworzeniu rozszerzenie zwraca wynik do aplikacji hosta. completeRequest z danymi wyjściowymi — alternatywny scenariusz, gdy rozszerzenie nie pokazuje UI, a od razu zwraca przetworzoną treść.

// Zwracanie przetworzonego tekstu do aplikacji hosta
let resultItem = NSExtensionItem()
let resultData = translated.data(using: .utf8)!
let attachment = NSItemProvider(
    item: resultData,
    typeIdentifier: kUTTypePlainText as String
)
resultItem.attachments = [attachment]
extensionContext?.completeRequest(
    returningItems: [resultItem], completionHandler: nil
)

Przetwarzanie danych i zwracanie wyniku

Action Extension może działać w dwóch trybach: z UI i bez UI. W trybie bez UI rozszerzenie wykonuje akcję całkowicie w tle i wywołuje completeRequest natychmiast po przetworzeniu. W trybie z UI rozszerzenie pokazuje kontroler, użytkownik potwierdza akcję, i dopiero wtedy completeRequest wysyła wynik. Wybór trybu zależy od złożoności akcji i konieczności wprowadzania danych przez użytkownika.

Wczytywanie danych z załącznika

Metoda loadItem(forTypeIdentifier:) działa asynchronicznie — dane mogą być duże (obrazy, wideo). NSItemProvider zarządza strumieniowym wczytywaniem i buforowaniem. Dla obrazów użyj kUTTypeImage, dla plików — kUTTypeFileURL. Ważne: loadItem może być wywołany na wątku tła — aktualizuj UI tylko przez DispatchQueue.main.

Zwracanie zmodyfikowanych danych

Action Extension zwraca przetworzone dane przez completeRequest z tablicą NSExtensionItem. Każdy element odpowiada typowi danych wyjściowych. Aplikacja hosta może zastąpić oryginalną treść przetworzoną — na przykład zastąpić oryginalny obraz na przefiltrowany. NSExtensionItem obsługuje te same UTI co na wejściu, plus dodatkowe (np. public.html dla treści internetowych).

Scenariusze użycia Action Extension

Action Extension jest stosowany w dziesiątkach scenariuszy — od prostych narzędzi po złożone procesy biznesowe. Klasyczne przykłady obejmują operacje tekstowe, graficzne i plikowe, a także integrację z treściami internetowymi.

Scenariusze tekstowe

Action Extension dla tekstu: tłumaczenie, sprawdzanie pisowni, liczenie znaków, zmiana wielkości liter, szyfrowanie, tworzenie kodu QR z tekstu. Użytkownik zaznacza tekst w dowolnej aplikacji z polem tekstowym (Safari, Notatki, Poczta) i jednym kliknięciem wykonuje akcję. Podświetlanie składni kodu, formatowanie Markdown i skracanie URL — popularne przykłady Action Extension dla zaawansowanych użytkowników.

Scenariusze graficzne

Dla obrazów Action Extension oferuje: stosowanie filtrów, przycinanie, zmianę rozmiaru, konwersję formatów (HEIC na JPEG), dodawanie znaku wodnego, rozpoznawanie tekstu (OCR) i kompresję. Przetwarzanie obrazów powinno być szybkie — użytkownik oczekuje wyniku w ciągu 2–3 sekund. Do ciężkich operacji używaj Core Image na GPU lub kolejek tła.

Scenariusze internetowe

Action Extension dla URL: tworzenie PDF ze strony internetowej, zapisywanie w Pocket/Pinterest, sprawdzanie szybkości strony, archiwizowanie strony, pobieranie metadanych Open Graph, generowanie zrzutu ekranu strony. Generowanie PDF — jeden z najpopularniejszych scenariuszy: użytkownik konwertuje stronę internetową na PDF bez otwierania zewnętrznych serwisów.