Oleafly रिलीज़ करना

Oleafly रिलीज़ के दो जानबूझकर रखे गए चरण हैं। एक वर्शन टैग ड्राफ़्ट बनाकर जाँचता है। कोई मेंटेनर उसी ड्राफ़्ट को अलग वर्कफ़्लो रन से प्रकाशित करता है।

main पर पुश करना CI चलाता है लेकिन रिलीज़ नहीं बनाता।

ड्राफ़्ट बनाएँ

हाल की हुई main ब्रांच और हरी CI से शुरू करें।

git switch main
git pull --ff-only
./scripts/bump-version.sh 0.3.6
git commit -am "chore: release v0.3.6"
git push origin main
git tag v0.3.6
git push origin v0.3.6

टैग .github/workflows/release.yml चालू करता है। वह ये टार्गेट बनाता है:

टार्गेट	इंस्टॉलर
macOS Apple Silicon	.dmg
Windows x64	.msi और -setup.exe
Linux x64	.AppImage और .deb
Linux ARM64	.AppImage और .deb

हर टार्गेट अपने पिन किए हुए कंपाइलर साइडकार फ़ेच करके सत्यापित करता है। फिर वर्कफ़्लो चारों अपडेटर फ़्रैगमेंट को एक latest.json में मर्ज करता है। ड्राफ़्ट तभी तैयार माना जाता है जब हर ज़रूरी इंस्टॉलर और अपडेटर एंट्री मौजूद हो।

ड्राफ़्ट की समीक्षा करें

ड्राफ़्ट को GitHub Releases पेज (नए टैब में खुलता है) पर खोलें। रिलीज़ नोट्स, इंस्टॉलर नाम, checksum, सिग्नेचर और latest.json जाँचें। अधूरा ड्राफ़्ट प्रकाशित न करें।

प्रकाशित करें

Actions → Release → Run workflow खोलें। वही टैग दर्ज करें और Publish the release चुनें।

प्रकाशन रन बिल्ड और आर्टिफ़ैक्ट जाँच दोहराता है। वह रिलीज़ कैंडिडेट का उपयोग करके Anthropic और Google के साथ लाइव कॉन्ट्रैक्ट टेस्ट भी चलाता है। आख़िरी जॉब तब तक प्रकाशित करने से मना करती है जब तक हर समर्थित प्लेटफ़ॉर्म और पूरा अपडेटर फ़ीड मौजूद न हो।

प्रकाशित करने से latest.json इंस्टॉल किए हुए ऐप्स को दिखने लगता है। इसे अपरिवर्तनीय प्रोडक्शन कार्रवाई मानें। अगर प्रकाशन रन विफल हो जाए, तो रिलीज़ को ड्राफ़्ट पर छोड़ दें, कारण ठीक करें, और उसे फिर से चलाएँ।

वर्शन नंबर

Oleafly सिमेंटिक वर्शनिंग का पालन करता है:

• Patch, जैसे 0.3.5 से 0.3.6, संगत फ़िक्स के लिए।
• Minor, जैसे 0.3.5 से 0.4.0, संगत फ़ीचर के लिए।
• Major, जैसे 0.3.5 से 1.0.0, ब्रेकिंग बदलावों या पहली स्टेबल रिलीज़ के लिए।

महत्वपूर्ण जाँचें

• टैग package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml और src-tauri/Cargo.lock से मेल खाना चाहिए। उन्हें अलग-अलग एडिट करने के बजाय scripts/bump-version.sh उपयोग करें।
• रिलीज़ नोट्स CHANGELOG.md के मिलते-जुलते वर्शन सेक्शन से आते हैं।
• प्रकाशित हुए टैग का पुनः उपयोग न करें। विफल ड्राफ़्ट के लिए ब्रांच ठीक करें और नया वर्शन बनाएँ, जब तक कि अप्रकाशित टैग बदलने का कोई स्पष्ट कारण न हो।
• macOS साइनिंग और नोटराइज़ेशन Apple रिलीज़ सीक्रेट्स उपयोग करते हैं। Windows Authenticode, Azure Artifact Signing उपयोग करता है जब उसके सीक्रेट्स कॉन्फ़िगर किए गए हों। अपडेटर सिग्नेचर अलग Tauri साइनिंग कुंजी उपयोग करते हैं।

अपडेटर साइनिंग और रोलबैक व्यवहार के लिए ऑटो-अपडेट देखें। यूज़र इंस्टॉलेशन निर्देश डाउनलोड और इंस्टॉल करें में हैं।