muOS पर ऐप्स इंस्टॉल करें: Archive Manager से .muxapp और .muxzip फ़ाइलें

muOS के ऐप्स .muxapp पर ख़त्म होने वाली एक फ़ाइल के रूप में आते हैं। इसे अनज़िप करने या फ़ोल्डर इधर-उधर कॉपी करने की ज़रूरत नहीं: muOS में Archive Manager नाम का इंस्टॉलर पहले से है जो यह काम कर देता है। यह गाइड पूरा तरीक़ा, पीछे क्या होता है, और वे दो बातें बताती है जिनमें लोग अक्सर उलझते हैं: अपडेट से सेटिंग्स रीसेट होना, और ऐप कैसे हटाएँ।

इस पर परखा: Anbernic RG40XXH · muOS 2601.0 Jacaranda। दूसरे muOS हैंडहेल्ड भी इसी तरह काम करते हैं।

.muxapp फ़ाइल क्या है

.muxapp फ़ाइल असल में अलग एक्सटेंशन वाला एक सामान्य ZIP आर्काइव है। इसके अंदर ऐप के नाम का एक फ़ोल्डर होता है, जैसे:

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS इसी से ऐप शुरू करता है
    ├── config.ini
    └── …

इंस्टॉल करने का मतलब है उस फ़ोल्डर को आपके SD कार्ड के MUOS/application/ में खोलना। उस फ़ोल्डर का हर ऐप Applications मेन्यू में दिखता है।

चरण 1: फ़ाइल को ARCHIVE फ़ोल्डर में कॉपी करें

Archive Manager SD कार्ड 1 (जिस कार्ड से muOS चलता है) के सबसे ऊपर वाले ARCHIVE फ़ोल्डर की फ़ाइलें दिखाता है। अगर फ़ोल्डर न हो, तो इसे बड़े अक्षरों में बना लें।

फ़ाइल वहाँ पहुँचाने के तीन आसान तरीक़े हैं:

कार्ड रीडर: हैंडहेल्ड बंद करें, SD कार्ड 1 कंप्यूटर में लगाएँ और .muxapp फ़ाइल ARCHIVE में कॉपी करें। निकालने से पहले कार्ड को ठीक से इजेक्ट करें।
Wi-Fi पर Wi-Fi Transfer से: हैंडहेल्ड पर ऐप खोलें, जो पता यह दिखाए उसे फ़ोन या PC के ब्राउज़र में खोलें, और SD card 1 टैब में Add games दबाकर .muxapp चुनें। यह अपने आप ARCHIVE में जाती है।
SFTP: muOS एक SFTP सर्वर चला सकता है: Configuration → Connectivity → Web Services में SFTP + Filebrowser चालू करें। फिर कोई भी SFTP ऐप (FileZilla, Cyberduck, WinSCP) फ़ाइल को SD कार्ड 1 के ARCHIVE में कॉपी कर सकता है।

फ़ाइल का नाम जैसा है वैसा ही रखें: Archive Manager एक्सटेंशन (.muxapp) देखकर तय करता है कि क्या करना है।

चरण 2: Archive Manager से इंस्टॉल करें

हैंडहेल्ड पर Applications → Archive Manager खोलें।
.muxapp फ़ाइल चुनें और A दबाएँ।
काम के दौरान muOS अपने मेन्यू बंद करके एक टेक्स्ट स्क्रीन दिखाता है: Inspecting Archive…, खुलती फ़ाइलें, Sync Filesystem और आख़िर में All Done!
कुछ सेकंड बाद आप Archive Manager में लौट आते हैं। फ़ाइल पर अब INSTALLED लिखा होता है।

Applications खोलें: नया ऐप सूची में है। कुछ ऐप्स को शुरू करने से पहले Wi-Fi चालू करना पड़ता है (Configuration → Connectivity → Wi-Fi Network)।

इंस्टॉल के बाद भी .muxapp फ़ाइल ARCHIVE में रहती है। आप इसे बैकअप के रूप में रख सकते हैं या मिटा सकते हैं; इंस्टॉल किए ऐप को इसकी ज़रूरत नहीं।

Archive Manager असल में क्या करता है

कुछ भी खोलने से पहले Archive Manager आर्काइव जाँचता है, और अगर अंदर का कोई भी पाथ लक्ष्य फ़ोल्डर से बाहर जाता हो (कोई पूरा पाथ या ..), तो उसे इंस्टॉल करने से मना कर देता है। इसलिए कोई टूटा या नुक़सानदेह पैकेज इस तरीक़े से muOS की सिस्टम फ़ाइलें नहीं बदल सकता।

यह जाँच फ़ाइलों की जगह के बारे में है, इस बारे में नहीं कि चलने के बाद ऐप क्या करता है। muOS पर ऐप्स सिस्टम की पूरी पहुँच के साथ चलते हैं, इसलिए .muxapp फ़ाइलें सिर्फ़ भरोसेमंद स्रोतों से इंस्टॉल करें: डेवलपर की अपनी वेबसाइट या GitHub रिलीज़ पेज।

Archive Manager सिर्फ़ ऐप्स के लिए नहीं है। यह फ़ाइल के एक्सटेंशन से इंस्टॉल का तरीक़ा चुनता है:

एक्सटेंशन	क्या है	कहाँ जाता है
`.muxapp`	एप्लिकेशन	`MUOS/application/`
`.muxthm`	थीम	`MUOS/theme/<नाम>/`
`.muxalt`	मौजूदा थीम का दूसरा रूप	चालू थीम का फ़ोल्डर
`.muxzip`	कंटेंट पैकेज (अंदर क्या है उसके हिसाब से सेव, BIOS या कलेक्शन)	मिलते-जुलते muOS फ़ोल्डर
`.muxcat`	कैटलॉग पैकेज (बॉक्स आर्ट और विवरण)	`MUOS/package/catalogue/`
`.muxcfg`	RetroArch कॉन्फ़िगरेशन पैकेज	`MUOS/package/config/`
`.muxupd`	muOS सिस्टम अपडेट	ख़ुद सिस्टम

ऐप अपडेट करना: पहले अपनी सेटिंग्स सेव करें

अपडेट करने के लिए नई .muxapp को ARCHIVE में कॉपी करें और उसी तरह इंस्टॉल करें। Archive Manager इसे मौजूदा ऐप फ़ोल्डर के ऊपर खोलता है:

नए पैकेज की फ़ाइलें पुरानी फ़ाइलों को बदल देती हैं, config.ini समेत;
जो फ़ाइलें पैकेज में नहीं हैं, जैसे ऐप का data/ या logs/ फ़ोल्डर, वे बनी रहती हैं।

इसलिए ऐप के config.ini में आपने जो भी बदला, वह अपडेट के बाद डिफ़ॉल्ट पर लौट आता है। अपडेट से पहले ऐप का config.ini किसी सुरक्षित जगह कॉपी करें (या अपनी सेटिंग्स लिख लें), फिर बाद में अपने बदलाव वापस डालें। पर Game Manager अपवाद है: इसके पैकेज में config.ini नहीं होता, इसलिए आपकी itch.io API कुंजी समेत सेटिंग्स अपडेट के बाद भी बनी रहती हैं। आपके इंस्टॉल किए गेम की सूची data/ में है और अपडेट के बाद भी बनी रहती है।

अगर नई फ़ाइल का नाम पुरानी जैसा ही हो, तो पहले ARCHIVE की पुरानी फ़ाइल मिटा दें या बदल दें, ताकि पक्का रहे कि आप कौन-सी इंस्टॉल कर रहे हैं।

ऐप अनइंस्टॉल करना

muOS 2601 में ऐप्स अनइंस्टॉल करने का कोई बटन नहीं है। किसी ऐप को हटाने के लिए उसका फ़ोल्डर मिटाएँ:

SD कार्ड 1 → MUOS/application/<ऐप का नाम>

यह कार्ड रीडर, SFTP या Wi-Fi Transfer से करें। फिर मुख्य मेन्यू पर लौटकर Applications दोबारा खोलें; ऐप हट चुका होगा। फ़ोल्डर मिटाने से ऐप की अपनी सेटिंग्स और डेटा भी मिट जाते हैं, इसलिए जो रखना हो पहले कॉपी कर लें।

समस्या हल करना

Archive Manager “No Archives Found” कहता है: फ़ाइल SD कार्ड 1 के सबसे ऊपर वाले ARCHIVE में नहीं है, या फ़ोल्डर का नाम ग़लत है। इसे ARCHIVE होना चाहिए, ROMS या MUOS के अंदर नहीं।
फ़ाइल सूची में है पर “unsafe paths” के साथ इंस्टॉल विफल होता है: पैकेज ग़लत बना है। ऐप के डेवलपर से संपर्क करें; इसे हाथ से खोलने की कोशिश न करें।
“Could not open archive… Corrupt?”: डाउनलोड पूरा नहीं हुआ या कॉपी बीच में कट गई। फिर से डाउनलोड करें और, अगर डेवलपर SHA-256 चेकसम देता है, तो उसे मिलाएँ (Mac या Linux पर shasum -a 256 file.muxapp)।
ऐप इंस्टॉल हुआ पर दिखता नहीं: मुख्य मेन्यू पर लौटकर Applications दोबारा खोलें। फिर भी न दिखे, तो जाँचें कि MUOS/application/<ऐप का नाम>/mux_launch.sh मौजूद है।
ऐप खुलते ही बंद हो जाता है: कई ऐप्स अपने फ़ोल्डर में लॉग लिखते हैं, आमतौर पर logs/app.log। उसे देखें, और अगर ऐप को इंटरनेट चाहिए तो Wi-Fi चालू करें।

सारांश

.muxapp फ़ाइल को SD कार्ड 1 के ARCHIVE में रखें।
Applications → Archive Manager, फ़ाइल चुनें, A दबाएँ, All Done! का इंतज़ार करें।
Applications से ऐप खोलें।
अपडेट से पहले ऐप का config.ini सेव करें। अनइंस्टॉल करने के लिए MUOS/application/ में उसका फ़ोल्डर मिटाएँ।

सवाल? feedback@pocketkode.com पर ईमेल करें।

PocketKode का muOS या Anbernic से कोई संबंध नहीं है।