सामग्री पर जाएँ

फर्मवेयर डेवलपर्स के लिए

अपने फर्मवेयर को अपडेटर सीई में जोड़ें।

अपडेटर सीई कस्टम फर्मवेयर के लिए सामुदायिक कैटलॉग और इंस्टॉलर है। अपने प्रोजेक्ट को एक आधार से विकसित करें ROM, इसे सही रिलीज़ संपत्तियों के साथ एक सार्वजनिक भंडार के रूप में प्रकाशित करें, मॉडल प्रविष्टियाँ जोड़ें slidia_manifest.xml, मॉडल फ़िल्टर का परीक्षण करें, और एक पुल अनुरोध खोलें। एक रिपॉजिटरी अपने द्वारा समर्थित प्रत्येक मॉडल की सेवा कर सकती है।

आधार से प्रारंभ करें ROM

बेस रोम कस्टम फ़र्मवेयर डेवलपर्स को वायरलेस रेडियो चिप्स सक्षम होने के साथ एक साफ़ एंड्रॉइड फ़ाउंडेशन देते हैं। Y1 पर वे फ़ैक्टरी ब्लूटूथ और एफएम के साथ-साथ वाई-फ़ाई और जीपीएस सक्षम करते हैं; Y2 पर वे फ़ैक्टरी ब्लूटूथ के साथ-साथ वाई-फ़ाई, जीपीएस और एफएम सक्षम करते हैं।

आधार ROM कस्टम फ़र्मवेयर विकास के लिए डाउनलोड, एंड्रॉइड संस्करण और वायरलेस सुविधाओं के साथ जो हर एक को सक्षम करता है
डाउनलोडयुक्तिAndroidवायरलेस सुविधाएँ
rom.zipY1 · Type AAndroid 4.2.2फ़ैक्टरी ब्लूटूथ और एफएम में वाई-फाई और जीपीएस जोड़ता है (एफएम पहले से ही फ़ैक्टरी से Y1 पर काम करता है)। Y1 खिलाड़ियों के लिए जो ओएस 2.0.0 या उसके बाद के संस्करण के साथ भेजे गए हैं।
rom_type_b.zipY1 · Type BAndroid 4.2.2फ़ैक्टरी ब्लूटूथ और एफएम में वाई-फाई और जीपीएस जोड़ता है (एफएम पहले से ही फ़ैक्टरी से Y1 पर काम करता है)। Y1 खिलाड़ियों के लिए जो 2.0.0 से पहले के ओएस के साथ भेजे गए थे।
rom_y2.zipY2Android 4.4.2फ़ैक्टरी ब्लूटूथ में वाई-फाई, जीपीएस और एफएम जोड़ता है। Y2 रेडियो चिप पूरी तरह से सक्षम है, इसलिए एफएम यहां भी उपलब्ध है।

ये छवियां स्टॉक एंड्रॉइड बेस (एओएसपी) हैं जिसमें डिवाइस वायरलेस रेडियो सक्षम है, इसलिए एक कस्टम फर्मवेयर रेडियो स्टैक को बदलने के बजाय नेटवर्क सुविधाएं जोड़ सकता है। वे नीचे दिए गए प्रकाशन चरणों के लिए व्यावहारिक प्रारंभिक बिंदु हैं।

इन रिलीज़ परिसंपत्ति नामों का उपयोग करें

फ़ाइल नाम संगतता संकेत का हिस्सा है. नाम सटीक रखें और ज़िप फ़ाइलों को प्रोजेक्ट की रिलीज़ संपत्तियों में रखें, न कि केवल रिपॉजिटरी सोर्स ट्री में।

फ़र्मवेयर ज़िप संपत्ति के नाम और समर्थित डिवाइस
संपत्तियुक्तिहार्डवेयरमतलब
rom.zipY1Type AY1 डिवाइस जो ओएस 2.0.0 या उसके बाद के संस्करण के साथ भेजे गए हैं।
rom_type_b.zipY1Type BY1 डिवाइस जो 2.0.0 से पहले के ओएस के साथ भेजे गए थे।
rom_y2.zipY2Y2Y2 पूर्ण-इंस्टॉल पैकेज। इसे Y1 संपत्तियों से अलग रखें।
किसी पैकेज को किसी अन्य मॉडल में फिट करने के लिए उसका नाम न बदलें। Y1 और Y2 अलग-अलग MediaTek प्लेटफ़ॉर्म फ़ाइलों और फ़्लैशिंग कॉन्फ़िगरेशन का उपयोग करते हैं। उस हार्डवेयर के लिए पैकेज प्रकाशित करें जिसका वह वास्तव में समर्थन करता है।

कनेक्शन कैसे काम करता है

अपडेटर सीई मैनिफ़ेस्ट को उसके कैटलॉग के रूप में पढ़ता है। प्रत्येक <package> लाइन इसे प्रोजेक्ट का नाम, रिपॉजिटरी, मॉडल और हैंडलर बताती है। जब कोई उपयोगकर्ता उस प्रोजेक्ट को चुनता है, तो अपडेटर रिपॉजिटरी की प्रकाशित रिलीज़ की जाँच करता है और एक की तलाश करता है rom*.zip संपत्ति.

प्रकट

प्रोजेक्ट को नाम दें और इसे एक मॉडल पर मैप करें। Y1 और Y2 को अलग-अलग पंक्तियों की आवश्यकता होती है, भले ही वे एक रिपॉजिटरी साझा करते हों।

प्रकाशित विज्ञप्ति

इंस्टॉल करने योग्य ज़िप संपत्तियां शामिल हैं। एक एकल रिलीज़ में Y1 Type A, Y1 Type B, और Y2 पैकेज एक साथ हो सकते हैं।

अद्यतनकर्ता सीई स्थापित करें

मिलान पैकेज और मॉडल-विशिष्ट फ़्लैशिंग पथ चुनने के लिए चयनित मॉडल का उपयोग करता है। उपयोगकर्ता को फ़ाइल नाम का अनुमान नहीं लगाना चाहिए.

किसी प्रोजेक्ट को पाँच चरणों में प्रकाशित करें

  1. अपडेटर सीई रिपॉजिटरी को फोर्क करें। अपना खुद का कांटा बनाएं ryan-specter/updater-ce-neo, फिर अपने कांटे को स्थानीय रूप से क्लोन करें।
  2. एक सार्वजनिक फ़र्मवेयर रिपोजिटरी तैयार करें. सुनिश्चित करें कि रिपॉजिटरी सार्वजनिक है और इसकी रिलीज़ में सही ज़िप संपत्तियाँ हैं। आप डाल सकते हैं rom.zip, rom_type_b.zip, और rom_y2.zip एक ही रिलीज़ पर जब वे एक ही संस्करण से संबंधित हों।
  3. मैनिफ़ेस्ट संपादित करें. खुला slidia_manifest.xml आपके अपडेटर सीई फोर्क की जड़ में। रिलीज़ द्वारा समर्थित प्रत्येक मॉडल के लिए एक पंक्ति जोड़ें (Y1 और Y2 सामान्य जोड़ी हैं)। द repo मूल्य भंडार का है owner/repository; url सार्वजनिक परियोजना पृष्ठ है.
  4. कैटलॉग का परीक्षण करें. संपादित चेकआउट से अपडेटर चलाएँ। Y1 चुनें और पुष्टि करें कि प्रोजेक्ट Y1 संपत्ति दिखाता है। Y2 चुनें और पुष्टि करें कि यह Y2 रिलीज़ दिखाता है। जब दोनों प्रकाशित हों तो Type A और Type B को अलग-अलग जांचें।
  5. पुल अनुरोध खोलें. मेनिफेस्ट परिवर्तन को अपने फोर्क में पुश करें और अपस्ट्रीम अपडेटर सीई रिपॉजिटरी के खिलाफ एक पुल अनुरोध खोलें। प्रोजेक्ट लिंक, समर्थित मॉडल, रिलीज़ टैग, परिसंपत्ति नाम और आपके द्वारा परीक्षण किए गए डिवाइस शामिल करें।

अपनी प्रकट पंक्तियाँ उत्पन्न करें

रिपॉजिटरी भरें और रिलीज़ द्वारा समर्थित प्रत्येक मॉडल पर टिक करें। जनरेटर एक लिखता है <package> प्रति मॉडल पंक्ति और केवल आपके द्वारा निर्धारित विशेषताएँ शामिल हैं, इसलिए परिणाम वर्तमान से मेल खाता है slidia_manifest.xml प्रारूप। प्रत्येक विशेषता अपडेटर सीई पढ़ता है नीचे उपलब्ध है - वैकल्पिक नीचे हैं अधिक विकल्प.

सार्वजनिक GitHub भंडार। जनरेटर निकालता है owner/repository यूआरएल से.
ऐप और साइट कैटलॉग में दिखाया गया है।
परियोजना या उसके रिलीज़ नोट्स के लिए मानव-सामना करने वाला पृष्ठ।
मॉडल के डिफ़ॉल्ट ब्रांड का उपयोग करने के लिए इसे साफ़ करें। SR1, Q3, Q5 और क्यू3ई Timmkoo मॉडल हैं।
उपकरण (प्रत्येक एक पंक्ति)
ऐसे मॉडल के लिए जो ऊपर सूचीबद्ध नहीं है. ज्ञात मॉडल अपनी कैटलॉग वर्तनी रखते हैं।
झंडे

कीप डेटा केवल तभी पेश किया जाता है जब आने वाला फ़र्मवेयर और इंस्टॉल किया गया फ़र्मवेयर समान हो या साझा हो derivative जड़. ध्वज का उपयोग केवल तभी करें जब उपयोगकर्ता का डेटा वास्तव में आगे नहीं ले जाया जा सके।

अधिक विकल्प: आइकन, कलाकृति, रिलीज संपत्ति, पोस्ट-इंस्टॉल और दर्पण

चिह्न और कलाकृति

वह छवि चुनें जिसे आप रिपॉजिटरी के लिए प्रतिबद्ध करेंगे। यह इसका पूर्वावलोकन करता है और इसका कच्चा URL बनाता है; यह कुछ भी अपलोड नहीं करता है.
रिपॉजिटरी रूट के सापेक्ष प्रतिबद्ध छवि का पथ।
एक सीधा छवि यूआरएल. खाली होने पर, ऐप रिलीज़ का उपयोग करता है updater.png या एक जनरेट किया गया आइकन.

वैकल्पिक डार्क-थीम आइकन. image_dark एक स्वीकृत उपनाम है.
द्वितीयक कलाकृति, रिलीज़ छवि के बाद आज़माई गई और icon.

संपत्ति जारी करें

प्रत्येक चयनित मॉडल के लिए एक नाम. उपयोग के लिए खाली छोड़ दें rom.zip Y1 पर और rom_<model>.zip अन्यत्र.
ग्लोब का उपयोग तब किया जाता है जब रिलीज़ के ज़िप का नाम नहीं दिया जाता है rom*.zip.
Y1 Type A पैकेज के लिए ग्लोब, जबकि इसके नाम में ऐसा नहीं लिखा है।
Y1 Type B पैकेज के लिए ग्लोब, जबकि इसके नाम में ऐसा नहीं लिखा है।
पुराने अपडेटर सीई बिल्ड से प्रविष्टि छुपाएं।

लिंक, दर्पण और डेटा परिवार रखें

सफल इंस्टालेशन के बाद खोला गया.
बहु-पृष्ठ सेटअप मार्गदर्शिका के लिए वैकल्पिक दूसरा चरण।
अल्पविराम से अलग किया गया *-mirror रिपॉजिटरी जो पोर्टेबल फ्लैशिंग ज़िप पैकेज बनाती हैं।
यह रिलीज़ जिस फर्मवेयर से बनाया गया है। संबंधित फ़र्मवेयर एक डेटा विभाजन साझा करते हैं, जिसे Keep Data जाँचता है।
ऐप रेपो जिसकी रिलीज़ इस फ़र्मवेयर में ऐप्स का वर्णन करती है। इसे एक पोस्ट-इंस्टॉल पेज की भी आवश्यकता है।
ऐप रेपो जिसका APK फर्मवेयर के बाद ऐप डाउनलोड और इंस्टॉल होता है।

कैटलॉग अतिरिक्त

लिंक और सहेजे गए इंस्टॉल रिकॉर्ड के लिए स्थिर पहचानकर्ता। जब कई मॉडल चुने जाते हैं तो मॉडल स्वचालित रूप से जुड़ जाता है।
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y1" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y2" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />

नवीनतम मैनिफ़ेस्ट लोड हो रहा है...

साझा भंडार के लिए एक पंक्ति पर्याप्त नहीं है। यदि Y2 लाइन गायब है, तो Y2 उपयोगकर्ताओं को तब भी मॉडल-मिलान वाली प्रविष्टि नहीं मिलेगी rom_y2.zip प्रोजेक्ट की रिलीज़ में मौजूद है। आपके रिलीज़ द्वारा समर्थित हर दूसरे मॉडल के लिए भी यही सच है।

मेनिफेस्ट में प्रत्येक विशेषता पढ़ी जाती है

ये वे विशेषताएँ हैं जिन्हें वर्तमान अपडेटर CE बिल्ड समझता है। जेनरेटर केवल वही लिखता है जो आप भरते हैं; ऐप बाकी के लिए समझदार डिफ़ॉल्ट पर वापस आ जाता है।

slidia_manifest.xml पैकेज विशेषताएँ और उनके अर्थ
विशेषताजरूरत हैयह क्या करता है
nameहाँसॉफ़्टवेयर का नाम कैटलॉग और इंस्टॉल कार्ड पर दिखाया गया है।
repoहाँowner/repo. ऐप उस रिपॉजिटरी की GitHub रिलीज़ को पढ़ता है।
deviceहाँलक्ष्य मॉडल, अपरकेस (Y1, Y2, G1, Q3e,…). प्रति मॉडल एक प्रविष्टि रखें.
urlअनुशंसितप्रोजेक्ट पेज या रिलीज़ नोट्स कैटलॉग से खोले गए।
type, handlerहाँ व्यवहार मेंtype="img" और handler="Custom Firmware". अन्य प्रकार और गैर-फर्मवेयर हैंडलर छोड़ दिए गए हैं।
brandवैकल्पिककैटलॉग ब्रांड (Innioasis, Timmkoo). Empty मॉडल के डिफ़ॉल्ट ब्रांड का उपयोग करता है।
package_nameवैकल्पिकसंपत्ति फ़ाइल नाम जारी करें. के लिए डिफ़ॉल्ट rom.zip Y1 पर और rom_<model>.zip अन्य मॉडलों पर.
asset_patternवैकल्पिकरिलीज़ के लिए केस-असंवेदनशील ग्लोब जिनके फ़र्मवेयर ज़िप का नाम नहीं है rom*.zip (उदाहरण के लिए my-firmware-*.zip).
type_a_asset, type_b_assetवैकल्पिकग्लब्स जो Y1 Type A और Type B ज़िप की पहचान करते हैं जब उनके फ़ाइल नाम में सामान्य मार्कर नहीं होते हैं।
iconवैकल्पिकलोगो यूआरएल. रिलीज़ के बाद स्वयं का उपयोग किया जाता है updater.png / updater.jpg, और प्रत्येक रिलीज़ के लिए फ़ॉलबैक के रूप में।
icon_darkवैकल्पिकडार्क-थीम लोगो. image_dark एक स्वीकृत उपनाम है.
imageवैकल्पिकद्वितीयक प्रकाश कलाकृति, बाद में आज़माई गई icon.
post_install, post_install2वैकल्पिकसफल इंस्टालेशन के बाद पेज खुले। दूसरे में बहु-चरणीय मार्गदर्शिका शामिल है।
portable_zipsवैकल्पिकअल्पविराम से अलग किया गया *-mirror रिपोज़ जो रेडी-टू-रन पोर्टेबल पैकेज प्रकाशित करते हैं।
derivativeवैकल्पिकफर्मवेयर रिपोजिटरी से बनाया गया है। समान व्युत्पन्न रूट वाला फर्मवेयर उपयोगकर्ता डेटा रख सकता है।
info_repoवैकल्पिकऐप रिपॉजिटरी जिसकी रिलीज़ बताती है कि फ़र्मवेयर क्या तैनात करता है। आवश्यकता है post_install या post_install2.
apk_repoवैकल्पिकऐप रिपॉजिटरी जिसका APK फर्मवेयर के बाद ऐप इंस्टॉल होता है।
min_versionवैकल्पिकजब अपडेटर CE इस संस्करण से पुराना हो तो प्रविष्टि छुपाएं।
do_not_keep_dataवैकल्पिकtrue (भी 1 / yes) इस फर्मवेयर के लिए कीप डेटा को पूरी तरह से ब्लॉक कर देता है।
slugवैकल्पिकलिंक और सहेजे गए इंस्टॉल रिकॉर्ड के लिए स्थिर पहचानकर्ता। खाली होने पर नाम और मॉडल से उत्पन्न।
descriptionवैकल्पिकसंक्षिप्त सूची विवरण. यह विशेषता मान या तत्व का पाठ हो सकता है।

अनुकूलता के लिए विरासती नाम अभी भी पढ़े जाते हैं: model, package, portable_zip, post_install_2, min_app_version और image_dark. नई प्रविष्टियों को उपरोक्त मौजूदा नामों का उपयोग करना चाहिए।

पुल अनुरोध के रूप में पंक्तियाँ सबमिट करें

  1. ऊपर उत्पन्न पंक्तियों को कॉपी करें। वे पहले से ही नवीनतम मैनिफ़ेस्ट प्रारूप से मेल खाते हैं।
  2. संपादित करें slidia_manifest.xml भंडार में. नीचे दिए गए संपादन लिंक का उपयोग करें; रिपॉजिटरी होस्ट स्वचालित रूप से आपके लिए एक कांटा और एक शाखा बनाता है।
  3. पंक्तियाँ ठीक पहले चिपकाएँ </slidia>, मौजूदा प्रविष्टियों को अपरिवर्तित रखते हुए।
  4. एक नई शाखा के लिए प्रतिबद्ध (उदाहरण के लिए add-your-firmware), फिर अपडेटर सीई रिपॉजिटरी के विरुद्ध एक पुल अनुरोध खोलें।
  5. पीआर में शामिल करें प्रोजेक्ट लिंक, समर्थित मॉडल, रिलीज़ टैग, परिसंपत्ति नाम और आपके द्वारा परीक्षण किए गए डिवाइस।

मॉडल नामों को बड़े अक्षरों में रखें, अपने सार्वजनिक भंडार के सटीक यूआरएल का उपयोग करें और रखें type="img" और handler="Custom Firmware" फ़र्मवेयर प्रविष्टि के लिए.

रिलीज़ को सत्यापित करना आसान बनाएं

रिलीज़ को एक स्पष्ट टैग और रिलीज़ नोट दें। टैग लोगों के लिए उपयोगी है, लेकिन ज़िप परिसंपत्ति नाम वे हैं जिनका उपयोग अपडेटर सीई इंस्टॉल पैकेजों की पहचान करने के लिए करता है।

चेकलिस्ट जारी करें

  • विज्ञप्ति को सार्वजनिक रूप से प्रकाशित करें.
  • ज़िप फ़ाइलों को रिलीज़ संपत्तियों के रूप में संलग्न करें।
  • नोट्स में समर्थित मॉडल और Type A या Type B बताएं।
  • किसी भी आवश्यक तैयारी या ज्ञात सीमा की सूची बनाएं।

एक रिलीज़, तीन संपत्तियाँ

एक साझा रिलीज़ में शामिल हो सकते हैं rom.zip, rom_type_b.zip, और rom_y2.zip. अपडेटर उन्हें अलग से वर्गीकृत करता है और मॉडल और हार्डवेयर फ़िल्टर में से चुनता है।

अनुमानों को बंडल न करें

Y2 फ़ाइल नाम के अंतर्गत एक Y1 पैकेज शामिल न करें, या केवल एक संपत्ति दिखाने के लिए परीक्षण न किया गया स्कैटर, प्रीलोडर, या विभाजन डेटा न जोड़ें।

फ़्लैशिंग के दौरान मॉडल प्रविष्टियाँ क्यों मायने रखती हैं?

मेनिफेस्ट केवल एक डाउनलोड मेनू नहीं है. निष्कर्षण के बाद, अपडेटर सीई मिलान इंस्टॉल पथ तैयार करने के लिए हल किए गए मॉडल का उपयोग करता है। Y1 और Y2 में अलग-अलग प्लेटफ़ॉर्म फ़ाइलें, प्रीलोडर, स्कैटर कॉन्फ़िगरेशन और डिवाइस लेआउट हैं।

योगदानकर्ताओं को सही फ़र्मवेयर फ़ाइलें प्रदान करनी चाहिए, फ़्लैश ऑफ़सेट नहीं। खराब पैकेज के आसपास काम करने के लिए स्कैटर पते, प्रीलोडर, डीए फ़ाइलें या विभाजन कमांड को संपादित न करें। रिलीज़ एसेट को ठीक करें और इच्छित मॉडल पर परीक्षण करें।

इससे पहले कि आप मर्ज का अनुरोध करें

  1. XML को XML पार्सर से सत्यापित करें। एक गुम उद्धरण या समापन /> इसके बाद की प्रत्येक प्रविष्टि को छुपा सकते हैं।
  2. अपने चेकआउट से अपडेटर लॉन्च करें ताकि यह रिमोट रिफ्रेश से पहले स्थानीय मैनिफ़ेस्ट को लोड कर सके।
  3. Y1 और Y2 को स्वतंत्र रूप से जांचें। पुष्टि करें कि प्रोजेक्ट केवल वहीं दिखाई देता है जहां इसका पैकेज समर्थित है।
  4. के लिए रिलीज़ सूची की जाँच करें rom.zip, rom_type_b.zip, और rom_y2.zip जैसा लागू हो.
  5. एक विश्वसनीय USB डेटा केबल और मूल सॉफ़्टवेयर पर लौटने के लिए एक पुनर्प्राप्ति योजना के साथ, इच्छित डिवाइस पर वास्तविक इंस्टॉल का परीक्षण करें।
  6. पुल अनुरोध में, बताएं कि आपने क्या परीक्षण किया। किसी परीक्षण न किए गए मॉडल को समर्थित के रूप में वर्णित न करें.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

स्थानीय जाँच के लिए, उस कमांड को रिपॉजिटरी रूट से चलाएँ। यह केवल XML सिंटैक्स को सत्यापित करता है; यह साबित नहीं करता है कि रिलीज़ में वैध फ़र्मवेयर है या डिवाइस फ़्लैश करना सुरक्षित है।

एआई एजेंटों के लिए मॉडिफाईंग कौशल

भण्डार का skills/ निर्देशिका Y1 और Y2 हार्डवेयर, फ़र्मवेयर, थीम और ऐप्स पर काम करने वाले एजेंटों के लिए एक स्रोत-आधारित ज्ञान का आधार है। प्रत्येक कौशल उस परियोजना फ़ाइल को नाम देता है जिससे उसके दावे आते हैं, इसलिए एक एजेंट किसी उपकरण को बदलने से पहले एक तथ्य की जांच कर सकता है।

यहां से प्रारंभ करें

कौशल सूचकांक और सुरक्षा नियम

किसी कौशल को कैसे लोड किया जाए, कोई तथ्य किस मॉडल पर लागू होता है, और किसी पैकेज को कौन से विभाजन नहीं लिखने चाहिए।

हार्डवेयर

Y1 हार्डवेयर

MT6572, मुख्य घटनाओं के रूप में पहिया, 480x360 डिस्प्ले, एफएम/ऑडियो पथ, भंडारण और Type A/बी विभाजन मानचित्र।

हार्डवेयर

Y2 हार्डवेयर

MT6582 बोर्ड, डिवाइस ट्री, GC9503V/ST7701S पैनल, PMIC/DAC रेल, विभाजन और बूट छवि।

फ़र्मवेयर

फ़र्मवेयर पैकेज

rom.zip एनाटॉमी, स्कैटर फ़ाइलें, क्लास ए अपडेट अनुबंध और रिलीज़ चेकलिस्ट।