ShareLink Swift: पूर्ण गाइड उदाहरणों के साथ

ShareLink SwiftUI फ्रेमवर्क में एक बिल्ट-इन स्ट्रक्चर है, जो Swift ऐप्स में "शेयर" बटन बनाने के लिए डिज़ाइन किया गया है। यह जटिल UIKit कोड लिखे बिना सिस्टम शेयर शीट (UIActivityViewController) को इंटीग्रेट करने का एक सरल और सहज तरीका प्रदान करता है। यह लाइब्रेरी iOS 16, macOS 13, tvOS 16 और watchOS 9 में आई है, और तब से आधुनिक SwiftUI ऐप्स में कंटेंट शेयर करने का मानक तरीका बन गई है।

ShareLink की आवश्यकता क्यों है? आज के समय में उपयोगकर्ता लगातार कंटेंट शेयर करते हैं: लिंक, फोटो, टेक्स्ट, फाइलें। मैन्युअल रूप से शेयरिंग लागू करने के लिए UIActivityViewController बनाना, डेलिगेट सेट करना और विभिन्न डेटा प्रकारों को हैंडल करना पड़ता है। ShareLink यह सारा काम अपने ऊपर ले लेता है, एक तैयार SwiftUI कंपोनेंट प्रदान करता है जो प्लेटफॉर्म और सिस्टम सेटिंग्स के अनुसार ऑटोमैटिकली एडजस्ट हो जाता है। यह न केवल डेवलपमेंट को तेज करता है, बल्कि सभी Apple डिवाइसों पर एक समान उपयोगकर्ता अनुभव सुनिश्चित करता है।

यह लाइब्रेरी इनके लिए एकदम सही है: सोशल ऐप्स (पोस्ट शेयर करना), न्यूज़ एग्रीगेटर (लेख शेयर करना), फोटो एडिटर (इमेज एक्सपोर्ट), मैसेजिंग ऐप्स (फाइल भेजना) और किसी भी अन्य ऐप में जहां "शेयर" फीचर चाहिए। ShareLink सभी मानक डेटा प्रकारों को सपोर्ट करता है: स्ट्रिंग, URL, इमेज, फाइलें और Transferable प्रोटोकॉल को फॉलो करने वाले कस्टम एलिमेंट।

सेटअप (Installation)

ShareLink SwiftUI फ्रेमवर्क का हिस्सा है, इसलिए इसे अलग से इंस्टॉल करने की आवश्यकता नहीं है। उपयोग के लिए बस अपने प्रोजेक्ट में SwiftUI इम्पोर्ट करें:

import SwiftUI

न्यूनतम आवश्यकताएँ:

• iOS 16.0+ / macOS 13.0+ / tvOS 16.0+ / watchOS 9.0+
• Xcode 14.0+
• Swift 5.7+

अगर आप पुराने iOS वर्जन का उपयोग कर रहे हैं, तो आपको UIViewRepresentable के ज़रिए सीधे UIActivityViewController का उपयोग करना होगा।

त्वरित शुरुआत (Quick Start)

ShareLink का उपयोग करने का सबसे आसान तरीका है इसे एक स्ट्रिंग या URL देना। यहाँ एक न्यूनतम काम करने वाला उदाहरण है:

import SwiftUI

struct ContentView: View {
    var body: some View {
        ShareLink(item: URL(string: "https://pythonlib.ru")!) {
            Label("लिंक शेयर करें", systemImage: "square.and.arrow.up")
        }
        .padding()
    }
}

यह कोड "शेयर" आइकन वाला एक बटन बनाता है। क्लिक करने पर सिस्टम शेयर शीट खुलती है, जहां उपयोगकर्ता लिंक भेजने के लिए ऐप चुन सकता है।

मुख्य तरीके और क्लासेस

ShareLink कस्टमाइज़ेशन के लिए कई इनिशियलाइज़र और मॉडिफायर प्रदान करता है। आइए 8 मुख्य फीचर्स देखें।

1. ShareLink(item:)

सिग्नेचर: init(item: T, subject: Text? = nil, message: Text? = nil, @ViewBuilder label: () -> Label)

क्या करता है: एक आइटम के लिए शेयर बटन बनाता है। item पैरामीटर स्ट्रिंग, URL, इमेज या Transferable प्रोटोकॉल को फॉलो करने वाला कोई भी टाइप हो सकता है।

ShareLink(item: "नमस्ते, दुनिया!") {
    Text("टेक्स्ट शेयर करें")
}

2. ShareLink(items:)

सिग्नेचर: init(items: [T], subject: Text? = nil, message: Text? = nil, @ViewBuilder label: () -> Label)

क्या करता है: एक साथ कई आइटम शेयर करने की सुविधा देता है (जैसे फोटो का ऐरे)।

let images = [UIImage(named: "photo1")!, UIImage(named: "photo2")!]
ShareLink(items: images) {
    Label("फोटो शेयर करें", systemImage: "photo.on.rectangle")
}

3. ShareLink(item:preview:)

सिग्नेचर: init(item: T, preview: SharePreview<T>, @ViewBuilder label: () -> Label)

क्या करता है: शेयर करने से पहले आइटम का प्रीव्यू दिखाने की सुविधा देता है।

ShareLink(item: URL(string: "https://example.com")!, preview: SharePreview("वेबसाइट", image: Image(systemName: "globe"))) {
    Label("प्रीव्यू के साथ शेयर करें", systemImage: "link")
}

4. ShareLink(item:subject:)

सिग्नेचर: init(item: T, subject: Text?, @ViewBuilder label: () -> Label)

क्या करता है: शेयर करते समय एक विषय (subject) जोड़ने की अनुमति देता है, जो ईमेल या मैसेज में सब्जेक्ट लाइन के रूप में दिखाई देगा।

ShareLink(item: "यह एक महत्वपूर्ण संदेश है", subject: Text("महत्वपूर्ण")) {
    Text("विषय के साथ शेयर करें")
}

5. ShareLink(item:message:)

सिग्नेचर: init(item: T, message: Text?, @ViewBuilder label: () -> Label)

क्या करता है: शेयर किए गए आइटम के साथ एक अतिरिक्त संदेश जोड़ता है।

ShareLink(item: URL(string: "https://pythonlib.ru")!, message: Text("यह बहुत उपयोगी साइट है!")) {
    Text("संदेश के साथ शेयर करें")
}

6. ShareLink(item:preview:subject:message:)

सिग्नेचर: init(item: T, preview: SharePreview<T>, subject: Text? = nil, message: Text? = nil, @ViewBuilder label: () -> Label)

क्या करता है: प्रीव्यू, विषय और संदेश सभी को एक साथ सेट करने का सबसे कस्टमाइज़ेबल तरीका।

ShareLink(
    item: "कस्टम कंटेंट",
    preview: SharePreview("मेरा कंटेंट", image: Image(systemName: "star")),
    subject: Text("देखो यह क्या है"),
    message: Text("मुझे यह बहुत पसंद आया!")
) {
    Label("पूरी तरह कस्टमाइज़्ड शेयर", systemImage: "square.and.arrow.up.fill")
}

7. .tint() मॉडिफायर

सिग्नेचर: func tint(_ tint: Color?) -> some View

क्या करता है: शेयर बटन का रंग बदलता है।

ShareLink(item: "रंगीन शेयर") {
    Text("नीला शेयर बटन")
}
.tint(.blue)

8. .disabled() मॉडिफायर

सिग्नेचर: func disabled(_ disabled: Bool) -> some View

क्या करता है: शेयर बटन को डिसेबल करता है जब शेयर करने के लिए कुछ न हो।

@State private var textToShare = ""

var body: some View {
    ShareLink(item: textToShare) {
        Text("शेयर करें")
    }
    .disabled(textToShare.isEmpty)
}

निष्कर्ष

ShareLink SwiftUI में शेयरिंग फंक्शनैलिटी जोड़ने का सबसे आसान और शक्तिशाली तरीका है। यह कोड को साफ रखता है, प्लेटफॉर्म-स्पेसिफिक फीचर्स को ऑटोमैटिकली हैंडल करता है, और उपयोगकर्ताओं को एक परिचित शेयरिंग अनुभव प्रदान करता है। चाहे आप एक सोशल मीडिया ऐप बना रहे हों या एक सिंपल नोट्स ऐप, ShareLink आपकी ज़रूरत को पूरा करेगा।