منسّق ملاحظات الإصدار
الصق ملاحظاتك، تغييرًا واحدًا في كل سطر. تُرتَّب هنا في هذه الصفحة، ولا يُرسل شيء إلى أي مكان.
جرّب مثالًا:
ماذا تفعل
كل تحديث يحتاج إلى بضعة أسطر تقول ما الذي تغيّر، ومعظم تطبيقات Mac تحتاجها في أكثر من مكان: نص What's New في App Store Connect، وملاحظات الإصدار التي يعرضها Sparkle في نافذة التحديث، وإصدار على GitHub أو صفحة سجل تغييرات. تأخذ هذه الأداة ما لديك، مثل ملاحظات أولية أو قائمة أو الأسطر التي يطبعها git log --oneline، وترتّب كل سطر تحت «جديد» أو «محسّن» أو «مُصلَح». وتزيل معرّفات التجزئة والبادئات مثل feat: وfix: وأرقام pull request، وتستبعد الأسطر التي تهمك وحدك، مثل chore وci وdocs وtest وإيداعات الدمج، وتكتب ثلاث نسخ يمكنك لصقها. ثم تقرأ النتيجة بالطريقة التي قد يقرأها بها App Review.
أين تذهب كل نسخة
| نسخ | أين تذهب |
|---|---|
| App Store | What's New in This Version، في App Store Connect. نص عادي، حتى 4,000 حرف. مطلوب لكل إصدار بعد الأول. |
| Sparkle | داخل description الخاص بالإصدار في appcast، ملفوفًا بـ CDATA، أو في صفحة يشير إليها sparkle:releaseNotesLink. |
| Markdown | إصدار GitHub، أو CHANGELOG.md، أو Sparkle 2.9 وما بعده على macOS 12 وما بعده، مع sparkle:format="markdown". |
الأوامر المطلوب تشغيلها
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
كلاهما يسرد الإيداعات منذ وسم إصدارك الأخير، وهو هنا v2.0، واحدًا في كل سطر. الثاني بلا معرّفات التجزئة. الصق أيًّا منهما هنا، ثم أعد كتابة أي سطر ما زال يبدو كملاحظة لنفسك.
معنى كل نتيجة
| العلامة | ماذا تعني |
|---|---|
| إصلاح | App Store Connect لن يقبله، مثل What's New فوق الحد (4,000 حرف). |
| المظهر | سيُلصق، لكن قد يربك سطرٌ الناسَ أو يستجلب سؤالًا في المراجعة، مثل رقم تذكرة أو اسم ملف أو اسم منصة أخرى. |
| سليم | يتسع للنص ويقول ما الذي تغيّر. |
| ملاحظة | ما الذي أُبقي، وما الذي استُبعد، وأين تذهب كل نسخة. |
المصادر: App Store Connect Help, Platform version information وApp Review Guidelines (2.2، 2.3.10 و2.3.12) وSparkle, Publishing an update، وكلها قُرئت في 13 نوفمبر 2026.
كيف يعمل
هي بضع قواعد نصية بسيطة تعمل في هذه الصفحة. تصنّف السطر بحسب كلمته الأولى أو بادئته، فـ «Add» وfeat: تذهب إلى «جديد»، و«Fix» وfix: إلى «مُصلَح»، وكل ما لا تستطيع تحديده إلى «محسّن». وأي عنوان في ملاحظاتك، مثل «Fixed:»، يصنّف الأسطر التي تحته. ولا تعيد كتابة جملك، ولا تعرف إن كان السطر صحيحًا أو واضحًا: هذا الجزء يبقى عليك. لا شيء مما تلصقه يُحفظ أو يُرسل.
الأسئلة
ما الطول الأقصى لملاحظات إصدار App Store؟
What's New in This Version في App Store Connect يقبل حتى 4,000 حرف من النص العادي. وهو مطلوب لكل إصدار بعد الأول.
هل يمكنني ببساطة كتابة «bug fixes and performance improvements»؟
نعم، لإصلاح خطأ بسيط أو تحديث أمني أو تحسين أداء. تقول App Review Guideline 2.3.12 إن التغييرات الأكبر والميزات الجديدة يجب ذكرها في الملاحظات.
كيف أضيف ملاحظات الإصدار إلى Sparkle appcast؟
ضع HTML داخل عنصر description الخاص بالإصدار، ملفوفًا بـ CDATA، أو استضف صفحة وأشر إليها بـ sparkle:releaseNotesLink. ويمكن لـ Sparkle 2.9 وما بعده قراءة Markdown أيضًا عند ضبط sparkle:format على markdown.
هل يمكنني لصق ناتج git log؟
نعم. تُزال معرّفات التجزئة والبادئات مثل feat: وfix: وأرقام pull request، وتُستبعد أسطر chore وci وdocs وtest والدمج.
هل تُرسل ملاحظاتي إلى أي مكان؟
لا. تُرتَّب في هذه الصفحة ولا يُرسل أو يُخزَّن شيء.