प्रोजेक्ट स्ट्रक्चर, लाइफ़साइकल, और बंडलिंग

मिनी ऐप्लिकेशन प्रोजेक्ट स्ट्रक्चर

मार्कअप लैंग्वेज, स्टाइलिंग लैंग्वेज, और कॉम्पोनेंट के साथ पहले की तरह ही, मिनी ऐप्लिकेशन प्रोजेक्ट स्ट्रक्चर के साथ भी फ़ाइल एक्सटेंशन या डिफ़ॉल्ट नामों जैसी जानकारी अलग-अलग होती है. हालांकि, सुपर ऐप्लिकेशन की सेवा देने वाली सभी कंपनियों के लिए यही आइडिया एक जैसा होता है. प्रोजेक्ट के स्ट्रक्चर में हमेशा ये चीज़ें शामिल होती हैं:

  • ऐसी रूट फ़ाइल app.js जो मिनी ऐप्लिकेशन को शुरू करती है.
  • कॉन्फ़िगरेशन फ़ाइल app.json, जो आम तौर पर किसी वेब ऐप्लिकेशन मेनिफ़ेस्ट से मेल खाती है.
  • शेयर की गई डिफ़ॉल्ट स्टाइल के साथ, एक वैकल्पिक सामान्य स्टाइल शीट फ़ाइल app.css.
  • एक project.config.json फ़ाइल, जिसमें बिल्ड की जानकारी होती है.

सभी पेज, pages फ़ोल्डर में अलग-अलग सब-फ़ोल्डर में सेव किए जाते हैं. हर पेज सब-फ़ोल्डर में एक सीएसएस फ़ाइल, एक JS फ़ाइल, एक एचटीएमएल फ़ाइल, और एक वैकल्पिक कॉन्फ़िगरेशन JSON फ़ाइल होती है. सभी फ़ाइलों का नाम, फ़ाइल एक्सटेंशन के अलावा, उनके फ़ोल्डर के नाम जैसा ही होना चाहिए. इस तरह, मिनी ऐप्लिकेशन को सिर्फ़ app.json फ़ाइल (मेनिफ़ेस्ट जैसी फ़ाइल) में डायरेक्ट्री के लिए पॉइंटर की ज़रूरत होती है और वह सभी सबरिसॉर्स को डाइनैमिक तरीके से ढूंढ सकता है. वेब डेवलपर के नज़रिए से, मिनी ऐप्लिकेशन एक से ज़्यादा पेज वाले ऐप्लिकेशन होते हैं.

├── app.js               # Initialization logic
├── app.json             # Common configuration
├── app.css              # Common style sheet
├── project.config.json  # Project configuration
└── pages                # List of pages
   ├── index               # Home page
   │   ├── index.css         # Page style sheet
   │   ├── index.js          # Page logic
   │   ├── index.json        # Page configuration
   │   └── index.html        # Page markup
   └── other               # Other page
       ├── other.css         # Page style sheet
       ├── other.js          # Page logic
       ├── other.json        # Page configuration
       └── other.html        # Page markup

मिनी ऐप्लिकेशन का लाइफ़साइकल

दुनिया भर में बताए गए App() तरीके को कॉल करके, सुपर ऐप्लिकेशन के साथ मिनी ऐप्लिकेशन को रजिस्टर करना ज़रूरी है. पहले बताए गए प्रोजेक्ट स्ट्रक्चर की बात करें, तो यह app.js में होता है. मिनी ऐप्लिकेशन के लाइफ़साइकल में चार इवेंट होते हैं: launch, show, hide, और error. इन इवेंट के हैंडलर, कॉन्फ़िगरेशन ऑब्जेक्ट के तौर पर App() तरीके को भेजे जा सकते हैं. इसमें globalData प्रॉपर्टी भी शामिल हो सकती है. इसमें ऐसा डेटा होता है जो दुनिया भर के सभी पेजों पर उपलब्ध होना चाहिए.

/* app.js */
App({
  onLaunch(options) {
    // Do something when the app is launched initially.
  },
  onShow(options) {
    // Do something when the app is shown.
  },
  onHide() {
    // Do something when the app is hidden.
  },
  onError(msg) {
    console.log(msg);
  },
  globalData: "I am global data",
});

हमेशा की तरह, जानकारी में अंतर हो सकता है, लेकिन WeChat, Alipay, Baidu, ByteDance, और Quick App के लिए भी यह सिद्धांत एक जैसा है.

पेज लाइफ़साइकल

ऐप्लिकेशन के लाइफ़साइकल की तरह ही, पेज लाइफ़साइकल में भी लाइफ़साइकल इवेंट होते हैं, जिन्हें डेवलपर सुन सकता है और उन पर प्रतिक्रिया दे सकता है. ये मुख्य इवेंट load, show, ready, hide, और unload हैं. कुछ प्लैटफ़ॉर्म, pulldownrefresh जैसे अतिरिक्त इवेंट ऑफ़र करते हैं. इवेंट हैंडलर सेट अप Page() तरीके में किए जाते हैं. यह तरीका हर पेज के लिए तय किया जाता है. पहले के प्रोजेक्ट स्ट्रक्चर के index या other पेजों के लिए, यह index.js याother.js में होगा.

/* index.js */
Page({
  data: {
    text: "This is page data.",
  },
  onLoad: function (options) {
    // Do something when the page is initially loaded.
  },
  onShow: function () {
    // Do something when the page is shown.
  },
  onReady: function () {
    // Do something when the page is ready.
  },
  onHide: function () {
    // Do something when the page is hidden.
  },
  onUnload: function () {
    // Do something when the page is closed.
  },
  onPullDownRefresh: function () {
    // Do something when the user pulls down to refresh.
  },
  onReachBottom: function () {
    // Do something when the user scrolls to the bottom.
  },
  onShareAppMessage: function () {
    // Do something when the user shares the page.
  },
  onPageScroll: function () {
    // Do something when the user scrolls the page.
  },
  onResize: function () {
    // Do something when the user resizes the page.
  },
  onTabItemTap(item) {
    // Do something when the user taps the page's tab.
  },
  customData: {
    foo: "bar",
  },
});

बिल्ड प्रोसेस

मिनी ऐप्लिकेशन बनाने की प्रोसेस, डेवलपर से अलग है. इसके तहत, यह ट्रांसपिलेशन और छोटा करने के लिए Babel कंपाइलर और पोस्टक्स सीएसएस ट्रांसफ़ॉर्मर जैसे इंडस्ट्री टूल का इस्तेमाल कर रहा है. बिल्ड का अनुभव, Next.js या create-react-app की तुलना में है. अगर डेवलपर साफ़ तौर पर ऐसा न करने का विकल्प चुनते हैं, तो वे बिल्ड पैरामीटर को कभी नहीं छूते. प्रोसेस की जाने वाली फ़ाइलों को आखिर में हस्ताक्षर और एन्क्रिप्ट (सुरक्षित) किया जाता है. साथ ही, एक या कई (सब)पैकेज में पैकेज भी कर दिया जाता है. इसके बाद, ये फ़ाइलें सुपर ऐप्लिकेशन उपलब्ध कराने वाली कंपनियों के सर्वर पर अपलोड हो जाती हैं. सबपैकेज, लेज़ी लोडिंग के लिए होते हैं. इसलिए, मिनी ऐप्लिकेशन को एक साथ डाउनलोड करने की ज़रूरत नहीं होती. पैकेजिंग की जानकारी निजी होनी चाहिए और इसका कोई रिकॉर्ड मौजूद नहीं है. हालांकि, WeChat के wxapkg फ़ॉर्मैट जैसे पैकेज फ़ॉर्मैट को रिवर्स-इंजीनियर में बदला गया है.

स्वीकार की गई

इस लेख की समीक्षा जो मेडली, कैसी बास्क, मिलिका मिहाजलीजा, ऐलन केंट, और कीथ गू ने की है.