Apps Script एडिटर के बजाय, अपने टर्मिनल से Apps Script प्रोजेक्ट को डेवलप और मैनेज करने के लिए, clasp नाम के ओपन सोर्स टूल का इस्तेमाल किया जा सकता है.
clasp कोडलैब, clasp की सभी सुविधाओं की खास जानकारी देता है.
सुविधाएं
स्थानीय तौर पर बनाएं
clasp आपको अपने Apps Script प्रोजेक्ट, स्थानीय तौर पर डेवलप करने की सुविधा देता है. इसके बाद,
अपने कंप्यूटर पर कोड लिखा जा सकता है और इसे
Apps Script में अपलोड किया जा सकता है. आप मौजूदा Apps Script प्रोजेक्ट भी डाउनलोड कर सकते हैं, ताकि आप ऑफ़लाइन होने पर उनमें
बदलाव कर सकें. कोड स्थानीय है, इसलिए Apps Script प्रोजेक्ट बनाते समय, git जैसे अपने पसंदीदा डेवलपमेंट टूल इस्तेमाल
किए जा सकते हैं.
डिप्लॉयमेंट वर्शन मैनेज करें
अपने प्रोजेक्ट के एक से ज़्यादा डिप्लॉयमेंट बनाएं, अपडेट करें, और देखें.
स्ट्रक्चर का कोड
clasp की मदद से, अपने कोड को डायरेक्ट्री में व्यवस्थित किया जा सकता है. ये कोड, script.google.com पर अपलोड करते समय सेव रहते हैं. उदाहरण के लिए:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
ज़रूरी शर्तें
clasp को Node.js में लिखा गया है और इसे npm टूल की मदद से डिस्ट्रिब्यूट किया गया है. clasp का इस्तेमाल करने से पहले, आपके पास
Node.js का 4.7.4 या इसके बाद का वर्शन इंस्टॉल होना चाहिए.
Node.js को इंस्टॉल करने के लिए, एडमिन के अधिकारों की ज़रूरत होती है.
इंस्टॉल करना
Node.js इंस्टॉल करने के बाद, clasp को इंस्टॉल करने के लिए, नीचे दिए गए npm कमांड का इस्तेमाल करें:
npm install @google/clasp -g
इंस्टॉल करने के बाद, अपने कंप्यूटर की किसी भी डायरेक्ट्री से clasp कमांड का इस्तेमाल किया जा सकता है.
clasp का इस्तेमाल करना
clasp का इस्तेमाल, कमांड लाइन से कई तरह के टास्क मैनेज करने के लिए किया जा सकता है. इस सेक्शन में, उन सामान्य कार्रवाइयों के बारे में बताया गया है जिनका इस्तेमाल clasp के साथ डेवलप करते समय किया जा सकता है.
लॉगिन
यह कमांड लॉग इन करता है और आपके Google खाते के Apps Script प्रोजेक्ट को मैनेज करने की अनुमति देता है. इसे चलाने के बाद, आपको उस Google खाते में साइन इन करने के लिए कहा जाता है जिसमें आपके Apps Script प्रोजेक्ट सेव होते हैं.
clasp login
लॉगआउट करें
यह निर्देश, कमांड लाइन टूल से लॉग आउट हो जाता है. clasp का इस्तेमाल जारी रखने से पहले, आपको Google से फिर से पुष्टि करने के लिए clasp login का इस्तेमाल करके दोबारा लॉगिन करना होगा.
clasp logout
एक नया Apps Script प्रोजेक्ट बनाएं
यह निर्देश मौजूदा डायरेक्ट्री में वैकल्पिक स्क्रिप्ट टाइटल के साथ एक नई स्क्रिप्ट बना देता है.
clasp create [scriptTitle]
यह निर्देश, मौजूदा डायरेक्ट्री में दो फ़ाइलें भी बनाता है:
- स्क्रिप्ट आईडी सेव करने वाली
.clasp.jsonफ़ाइल. appsscript.jsonकी एक प्रोजेक्ट मेनिफ़ेस्ट फ़ाइल, जिसमें प्रोजेक्ट मेटाडेटा मौजूद है.
किसी मौजूदा प्रोजेक्ट का क्लोन बनाएं
यह निर्देश, मौजूदा डायरेक्ट्री में पहले से मौजूद प्रोजेक्ट को क्लोन करता है. स्क्रिप्ट बनाई जानी चाहिए या आपके Google खाते के साथ शेयर की जानी चाहिए. स्क्रिप्ट प्रोजेक्ट का स्क्रिप्ट आईडी देकर, उसे क्लोन करने के बारे में बताया जा सकता है.
प्रोजेक्ट का स्क्रिप्ट आईडी ढूंढने के लिए, नीचे दिया गया तरीका अपनाएं:
- Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग पर क्लिक करें.
आईडी में जाकर, स्क्रिप्ट आईडी कॉपी करें.
clasp clone <scriptId>
स्क्रिप्ट प्रोजेक्ट डाउनलोड करें
यह निर्देश Google Drive से Apps Script प्रोजेक्ट को आपके कंप्यूटर के फ़ाइल सिस्टम में डाउनलोड कर देता है.
clasp pull
स्क्रिप्ट प्रोजेक्ट अपलोड करना
यह निर्देश, स्क्रिप्ट प्रोजेक्ट की सभी फ़ाइलें आपके कंप्यूटर से Google Drive पर अपलोड कर देता है.
clasp push
प्रोजेक्ट के वर्शन की सूची बनाएं
इस निर्देश में, स्क्रिप्ट प्रोजेक्ट के हर वर्शन की संख्या और उसकी जानकारी होती है.
clasp versions
पब्लिश किया गया प्रोजेक्ट डिप्लॉय करना
स्क्रिप्ट प्रोजेक्ट को वेब ऐप्लिकेशन, ऐड-ऑन या एक्ज़ीक्यूटेबल के तौर पर डिप्लॉय किया जा सकता है. आपके पास स्क्रिप्ट एडिटर, प्रोजेक्ट मेनिफ़ेस्ट या clasp का इस्तेमाल करके डिप्लॉयमेंट बनाने का विकल्प है.
clasp के साथ किसी प्रोजेक्ट को डिप्लॉय करने के लिए, पहले Apps Script प्रोजेक्ट का ऐसा वर्शन बनाएं जिसे बदला न जा सके. वर्शन, स्क्रिप्ट प्रोजेक्ट का "स्नैपशॉट" होता है और यह रीड-ओनली ऐक्सेस वाली ब्रांच रिलीज़ की तरह होता है.
clasp version [description]
यह निर्देश, बनाई गई नई वर्शन संख्या दिखाता है. इस संख्या का इस्तेमाल करके, अपने प्रोजेक्ट के इंस्टेंस डिप्लॉय और हटाए जा सकते हैं:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
यह निर्देश मौजूदा डिप्लॉयमेंट को नए वर्शन और ब्यौरे के साथ अपडेट कर देता है:
clasp redeploy <deploymentId> <version> <description>
डिप्लॉयमेंट की सूची बनाएं
इस निर्देश में स्क्रिप्ट प्रोजेक्ट के डिप्लॉयमेंट आईडी, वर्शन, और उनके ब्यौरे शामिल होते हैं.
clasp deployments
प्रोजेक्ट को Apps Script एडिटर में खोलें
इस निर्देश से Apps Script एडिटर में, एक स्क्रिप्ट प्रोजेक्ट खुल जाता है. एडिटर को आपके डिफ़ॉल्ट वेब ब्राउज़र में नए टैब के तौर पर लॉन्च किया जाता है.
clasp open
clasp ओपन-सोर्स प्रोजेक्ट में योगदान दें
GitHub पर clasp में योगदान दें.