Share Extension — یہ کیا ہے، کیسے کام کرتا ہے اور ایکسٹینشن کی ترقی

Share Extension کیا ہے

Share Extension ایک قسم کی iOS ایپ ایکسٹینشن ہے جو کسی بھی ایپ میں مواد منتخب کرنے پر سسٹم شیر شیٹ میں ظاہر ہوتی ہے۔ صارف Safari میں متن کو نمایاں کرتا ہے، شیر پر دباتا ہے اور آپ کی ایپ کو دستیاب کارروائیوں کی فہرست میں دیکھتا ہے۔ انتخاب کے بعد، مواد کارروائی کے لیے ایکسٹینشن کو بھیج دیا جاتا ہے: محفوظ کرنا، شائع کرنا، بھیجنا یا تبدیل کرنا۔

Action Extension کے برعکس، Share Extension بیرونی ایپس سے مواد حاصل کرنے میں مہارت رکھتی ہے۔ Action Extension اس کے برعکس آپ کی ایپ سے باہر ڈیٹا بھیجتی ہے۔ Share Extension صارفی مواد کا داخلہ نقطہ ہے، صارفین کے حصول کا ایک اہم عنصر: صارفین Share Extension کے ذریعے آپ کی ایپ کو مکمل طور پر انسٹال کیے بغیر آزماتے ہیں۔ App Store ان ایپس کو ممنوع قرار دیتا ہے جن کا واحد کام Share Extension کے ذریعے اشتہارات دکھانا ہے (App Store Review Guideline 4.2)۔

آپ کی ایپ کے لیے Share Extension کیوں اہم ہے

Share Extension داخلے کی رکاوٹ کو کم کرتی ہے: صارفین ایک مانوس سیاق و سباق — براؤزر، گیلری، فائل مینیجر — سے آپ کی ایپ میں مواد بھیجتے ہیں۔ Branch (2024) کے مطابق، Share Extension والی ایپس 7ویں دن 28% زیادہ برقراری ظاہر کرتی ہیں۔ ایک اضافی اثر وائرلٹی ہے: جب بھی صارف شیر شیٹ میں آپ کی ایپ دیکھتا ہے، اشتہاری اخراجات کے بغیر غیر فعال برانڈنگ ہوتی ہے۔

Share Extension کیسے کام کرتا ہے

Share Extension کا طریقہ کار نظام NSExtensionItem کنٹینرز کے ذریعے مواد کی منتقلی پر مبنی ہے۔ میزبان ایپ (Safari، تصاویر) منتخب کردہ مواد کو ایک مخصوص قسم (public.image, public.url, public.plain-text) کے ساتھ NSExtensionItem میں پیک کرتی ہے۔ نظام اس کنٹینر کو ایکسٹینشن کو بھیجتا ہے، جو extensionContext.inputItems کے ذریعے ڈیٹا نکالتی ہے۔

ایکسٹینشن کا لائف سائیکل

Share Extension ایک علیحدہ عمل میں محدود عملدرآمد کے وقت کے ساتھ چلتی ہے — کارروائی کے لیے تقریباً 30 سیکنڈ۔ ایکسٹینشن کو لمبے ہم وقت ساز عمل نہیں کرنے چاہئیں۔ بڑی فائلیں اپ لوڈ کرنے کے لیے، پس منظر کی ترتیب کے ساتھ NSURLSession استعمال کریں۔ SLComposeServiceViewController مواد کا پیش منظر اور پوسٹ بٹن کے ساتھ Share Extension کے لیے بنیادی کلاس ہے۔

ڈیٹا کی اقسام اور Uniform Type Identifiers

iOS منتقل شدہ مواد کی قسم کا تعین کرنے کے لیے Uniform Type Identifiers (UTI) استعمال کرتا ہے۔ Share Extension کے لیے اہم UTI: public.image (تصاویر، اسکرین شاٹس)، public.url (لنکس)، public.plain-text (متن)، public.video (ویڈیو فائلیں) اور public.file-url (فائلیں)۔ ایکسٹینشن NSExtensionActivationRule کلید کے ذریعے Info.plist میں معاون UTI رجسٹر کرتی ہے۔

ایکسٹینشن کا فن تعمیر

Share Extension تین اجزاء پر مشتمل ہے: Xcode میں ہدف، SLComposeServiceViewController اور Info.plist ترتیب۔ فن تعمیر اس بات کا تعین کرتا ہے کہ مواد کی کن اقسام پر کارروائی کی جاتی ہے، انٹرفیس کیسے دکھایا جاتا ہے اور ڈیٹا کہاں محفوظ کیا جاتا ہے۔

NSExtensionActivationRule

Share Extension ترتیب کا اہم عنصر فعالیت کا قاعدہ ہے۔ یہ اس بات کا تعین کرتا ہے کہ ایکسٹینشن شیر شیٹ میں کن شرائط پر ظاہر ہوتی ہے۔ قاعدہ Info.plist میں پابندیوں کے ساتھ ایک لغت کے طور پر مقرر کیا جاتا ہے: تصاویر کی زیادہ سے زیادہ تعداد، کم از کم متن کی لمبائی، لازمی URL موجودگی۔ معیاری قاعدہ کسی ایک مواد کی قسم کے لیے ایکسٹینشن کو فعال کرتا ہے۔

// Info.plist — Share Extension کے لیے NSExtensionActivationRule
<key>NSExtensionActivationRule</key>
<dict>
    <key>NSExtensionActivationSupportsImageWithMaxCount</key>
    <integer>5</integer>
    <key>NSExtensionActivationSupportsText</key>
    <true/>
    <key>NSExtensionActivationSupportsWebURLWithMaxCount</key>
    <integer>1</integer>
</dict>

Share Extension بنانا

آئیے بک مارکنگ ایپ کے لیے Swift میں Share Extension بنانے کی ایک عملی مثال دیکھتے ہیں۔ ایکسٹینشن Safari سے URL وصول کرتی ہے، پیش منظر کا انٹرفیس دکھاتی ہے اور لنک کو App Group میں محفوظ کرتی ہے۔ SLComposeServiceViewController ایک متن کے خانے اور پوسٹ بٹن کے ساتھ تیار یوزر انٹرفیس فراہم کرتا ہے۔

import Social
import MobileCoreServices

class ShareViewController: SLComposeServiceViewController {

    override func isContentValid() -> Bool {
        return !(contentText?.isEmpty() ?? true)
    }

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

        for attachment in item.attachments ?? [] {
            attachment.loadItem(forTypeIdentifier: kUTTypeURL as String) {
                [weak self] (item, error) in
                if let url = item as? URL {
                    BookmarkService().save(url, title: self?.contentText)
                }
                self?.extensionContext?.completeRequest(
                    returningItems: [], completionHandler: nil)
            }
        }
    }
}

مواد بھیجنے کے بعد، ایکسٹینشن completeRequest کال کرکے ختم ہوتی ہے — یہ ایک لازمی مرحلہ ہے؛ اس کے بغیر نظام ایکسٹینشن کے عمل کو جاری نہیں کرے گا۔ اہم: Share Extension محدود نیٹ ورک اور فائل سسٹم رسائی کے ساتھ ایک محدود ماحول میں چلتی ہے — مواد اپ لوڈ کے لیے پس منظر کے سیشن استعمال کریں۔

مواد کی اقسام پر کارروائی

Share Extension کو مختلف اقسام کے ان پٹ ڈیٹا: متن، تصاویر، ویڈیو، URLs اور فائلوں کو صحیح طریقے سے سنبھالنا چاہیے۔ ہر قسم اپنا UTI اور نکالنے کا طریقہ استعمال کرتی ہے۔ عالمی ہینڈلنگ — hasItemConformingToTypeIdentifier جانچ کے ساتھ attachment.attachments پر لوپ کرکے۔

تصاویر کی ہینڈلنگ

تصاویر public.image کے طور پر UIImage یا Data کے ذریعے حاصل کرنے کی صلاحیت کے ساتھ بھیجی جاتی ہیں۔ بڑی تصاویر کے لیے، محفوظ کرنے سے پہلے jpegData(compressionQuality:) استعمال کریں۔ Share Extension کو صارف کی واضح اجازت کے بغیر اصل تصویر میں ترمیم نہیں کرنی چاہیے۔ سفارش کی جاتی ہے کہ اصل کو App Group میں محفوظ کریں اور انٹرفیس میں دکھانے کے لیے پیش منظر بنائیں۔

URL اور متن کی ہینڈلنگ

Safari اور دوسرے براؤزر URLs کو public.url اور منتخب متن کو public.plain-text کے طور پر بھیجتے ہیں۔ ایک واحد NSExtensionItem ایک ساتھ دونوں اقسام پر مشتمل ہو سکتا ہے — صفحہ کا URL اور اس پر منتخب کردہ متن۔ Share Extension کو تمام منسلکات کی جانچ کرنی چاہیے اور متعلقہ ڈیٹا نکالنا چاہیے۔ مشترکہ منظر نامہ: URL کو بک مارک کے طور پر اور متن کو اس سے منسلک نوٹ کے طور پر محفوظ کریں۔

App Groups اور ڈیٹا کی منتقلی

Share Extension اور مرکزی ایپ مختلف عملوں میں چلتی ہیں اور ان کی فائل سسٹم تک مشترکہ رسائی نہیں ہے۔ ڈیٹا کا تبادلہ App Groups میکانزم استعمال کرتا ہے: group.* شناخت کنندہ کے ساتھ ایک مشترکہ کنٹینر۔ App Group میں ڈیٹا محفوظ کرنے کے بعد، ایکسٹینشن CFNotificationCenter یا Darwin Notify کے ذریعے ایپ کو مطلع کرتی ہے۔

App Groups کی ترتیب

App Groups ہدف کی صلاحیتوں میں فعال کی جاتی ہیں: App Groups منتخب کریں اور ایک شناخت کنندہ شامل کریں (مثال کے طور پر، group.com.example.myapp)۔ دونوں ہدف — مرکزی ایپ اور ایکسٹینشن — کا ایک ہی گروپ تک رسائی ہونی چاہیے۔ UserDefaults سویٹ کم سے کم اضافی بوجھ کے ساتھ مشترکہ ذخیرہ میں ڈیٹا پڑھنے اور لکھنے کی اجازت دیتا ہے۔

// Share Extension سے App Group میں ڈیٹا محفوظ کرنا
let sharedDefaults = UserDefaults(suiteName: "group.com.example.myapp")
let bookmark: [String: Any] = [
    "url": url.absoluteString,
    "title": contentText ?? "",
    "date": Date().timeIntervalSince1970
]
sharedDefaults?.set(bookmark, forKey: "bookmark_\(Date().timeIntervalSince1970)")
sharedDefaults?.synchronize()