1. R.swift क्या है और इसकी ज़रूरत क्यों?

R.swift Swift भाषा के लिए एक शक्तिशाली लाइब्रेरी है, जो आपके iOS/macOS/tvOS/watchOS ऐप के रिसोर्सेज़ (जैसे इमेज, फ़ॉन्ट, रंग, लोकलाइज़्ड स्ट्रिंग) तक type-safe (टाइप-सेफ) एक्सेस प्रदान करती है। स्ट्रिंग लिटरल का उपयोग करने के बजाय, R.swift आपके लिए सख्ती से टाइप की गई संरचनाएं जनरेट करता है। इसका मतलब है कि कंपाइलर रिसोर्स के नाम की सहीता की जांच कंपाइल टाइम पर ही कर सकता है, न कि ऐप रन होने के दौरान।

इसकी ज़रूरत क्यों है? Apple डेवलपमेंट में आमतौर पर आप UIImage(named: "myImage") या NSLocalizedString("hello_key", comment: "") जैसा कोड लिखते हैं। अगर फ़ाइल नाम या लोकलाइज़ेशन की में कोई गलती हो जाए, तो ऐप रन होने पर ही क्रैश होगा। R.swift इस समस्या को जड़ से खत्म करता है: कोड जनरेट होने के बाद, आप रिसोर्सेज़ को जनरेटेड स्ट्रक्चर के प्रॉपर्टी के रूप में एक्सेस करते हैं। जैसे: R.image.myImage या R.string.localizable.helloKey()। कंपाइलर तुरंत गलत रिसोर्स बताएगा, और Xcode ऑटोकम्प्लीट भी देगा।

इसके अलावा, R.swift ऑटोमैटिकली Asset Catalogs, .strings फ़ाइलें, .storyboard, .xib, .json, .plist, फ़ॉन्ट, रंग और Data फ़ाइलों को हैंडल करता है। इससे कोड साफ, सुरक्षित होता है और Xcode के ऑटोकम्प्लीट की मदद से डेवलपमेंट काफी तेज़ हो जाता है। यह लाइब्रेरी कम्युनिटी द्वारा एक्टिवली मेंटेन की जाती है और दुनिया भर के हज़ारों प्रोजेक्ट्स में उपयोग होती है।

2. इंस्टॉलेशन

R.swift को Swift Package Manager (SPM) या CocoaPods के ज़रिए इंस्टॉल किया जा सकता है। हम SPM की सलाह देते हैं, क्योंकि यह Swift प्रोजेक्ट्स के लिए आधुनिक स्टैंडर्ड है।

Swift Package Manager (SPM) से इंस्टॉलेशन

Xcode के ज़रिए पैकेज जोड़ें:

1. अपना प्रोजेक्ट Xcode में खोलें।
2. File > Add Packages... पर जाएं।
3. यह URL पेस्ट करें: https://github.com/mac-cain13/R.swift
4. वर्शन चुनें (नवीनतम स्थिर वर्शन लें) और Add Package दबाएं।
5. सुनिश्चित करें कि पैकेज आपके मुख्य टार्गेट में जुड़ गया है।

आप मैन्युअली Package.swift में भी जोड़ सकते हैं:

// swift-tools-version:5.7
import PackageDescription

let package = Package(
    name: "YourProject",
    dependencies: [
        .package(url: "https://github.com/mac-cain13/R.swift", from: "7.0.0")
    ],
    targets: [
        .target(
            name: "YourTarget",
            dependencies: [
                .product(name: "RswiftLibrary", package: "R.swift")
            ]
        )
    ]
)

CocoaPods से इंस्टॉलेशन

अगर आप CocoaPods का उपयोग करते हैं, तो Podfile में जोड़ें:

platform :ios, '13.0'
use_frameworks!

target 'YourApp' do
  pod 'R.swift', '~> 7.0'
end

फिर यह कमांड चलाएं:

pod install

Build Phase सेटअप (ज़रूरी!)

इंस्टॉलेशन के बाद, अपने टार्गेट के Build Phases में Run Script Phase जोड़ना ज़रूरी है:

1. अपने टार्गेट के Build Phases पर जाएं।
2. + दबाएं और New Run Script Phase चुनें।
3. इस फेज़ को Compile Sources से पहले खींचकर रखें।
4. स्क्रिप्ट फील्ड में यह कोड पेस्ट करें:

"$PODS_ROOT/R.swift/rswift" generate "$SRCROOT/R.generated.swift"

अगर आप SPM का उपयोग कर रहे हैं, तो स्क्रिप्ट इस तरह होगी:

"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/R.swift/rswift" generate "$SRCROOT/R.generated.swift"

प्रोजेक्ट बिल्ड करने पर R.generated.swift फ़ाइल जनरेट होगी। इसे अपने प्रोजेक्ट में जोड़ें (इसे ड्रैग करना न भूलें)।