أهم النقاط المستفادة
ربط مسارات CI/CD بواجهات برمجة تطبيقات التوزيع يغنيك عن إدخال البيانات يدويًا أثناء تحديثات التطبيق. تظل أدوات Fastlane Deliver و Supply هي المعيار السائد في هذا المجال لإدخال البيانات الوصفية المترجمة بشكل آمن. يمكن لأنظمة الأقلمة المدعومة بالذكاء الاصطناعي ترجمة ملاحظات الإصدار بشكل فوري إلى أكثر من 35 لغة مدعومة. تعمل النماذج اللغوية الكبيرة (LLMs) المدمجة مباشرة في سير عمل Git على ترجمة رسائل الإيداع التقنية (commit messages) إلى نصوص موجهة للمستخدم تلقائيًا. أتمتة أقلمة App Store Connect تمنع أخطاء التنسيق البشرية عند تحديث سجلات التغيير عبر الأنظمة الأساسية المتعددة.
يجب أن يكون إصدار تحديث لتطبيقات الهاتف المحمول عملية مباشرة تتم بنقرة واحدة. بدلاً من ذلك، يقضي المطورون ساعات في نسخ ولصق سجلات التغيير المترجمة يدويًا داخل منصات ويب جامدة لكل منطقة جغرافية. إن تطبيق أتمتة ملاحظات إصدار التطبيقات يخلق نظامًا موثوقًا يكتب ويترجم وينشر البيانات الوصفية للإصدار إلى جانب الحزم البرمجية (binaries) المجمعة.
كيفية أتمتة ملاحظات إصدار متجر التطبيقات؟
يمكنك أتمتة ملاحظات إصدار متجر التطبيقات من خلال ربط مسار CI/CD الخاص بك مباشرةً بواجهات برمجة تطبيقات المطورين من Apple و Google. يقوم هذا المسار المتصل بجلب النصوص من مستودع التعليمات البرمجية الخاص بك ودفعها إلى صفحة التطبيق بالمتجر أثناء عملية البناء.
تعامل مع البيانات الوصفية للمتجر تمامًا ككود التطبيق. فمن خلال تخزين ملاحظات الإصدار في Git، يمكنك ضمان التحكم في الإصدار (version control) وتتبع التحديثات إلى إصدارات معينة من التطبيق. ويؤدي وضع علامة (Tagging) للإصدار إلى تحفيز منصات مثل GitHub Actions لتشغيل برنامج نصي (script) خاص بالنشر.
يصادق هذا البرنامج النصي مع خوادم المنصات، ثم يرفع حزمة التطبيق جنبًا إلى جنب مع الملفات النصية الخاصة بكل لغة (مثل en-US، fr-FR). يتنقل البرنامج النصي المؤتمت عبر هذه الدلائل، ويربط الحزمة النصية بحقول اللغة المستهدفة في قاعدة بيانات متجر التطبيقات.
وفقًا لـ إرشادات المطورين من Apple، يعد الحفاظ على أقلمة دقيقة عبر المناطق الجغرافية محركًا أساسيًا لحجم التنزيلات العالمية. كما أن الأتمتة البرمجية تزيل نسبة الخطأ البشري وتضمن حصول الجماهير العالمية على تحديثات دقيقة للميزات.
هل يمكن أتمتة ملاحظات إصدار iOS باستخدام Fastlane؟
نعم، يمكنك أتمتة ملاحظات إصدار iOS باستخدام Fastlane Deliver لرفع الملفات النصية العادية مباشرةً إلى App Store Connect. تُنشئ أداة Deliver بنية دلائل محلية متطابقة ترتبط تمامًا بحقول البيانات الوصفية لشركة Apple.
تعمل أداة Fastlane كوسيط بين بيئة التكامل المستمر (CI) الخاصة بك وخوادم Apple. يؤدي تشغيل الأمر fastlane init إلى إنشاء دليل fastlane/metadata يحتوي على مجلدات فرعية لكل لغة مدعومة. وداخل مجلد اللغة المحدد، ما عليك سوى إنشاء ملف باسم release_notes.txt.
يؤدي تنفيذ الأمر fastlane deliver إلى المصادقة بشكل آمن عبر مفتاح API الخاص بـ App Store Connect، وتحليل ملف release_notes.txt، وتحديث حقل "ما الجديد في هذا الإصدار". ويمكنك تشغيل مسار العمل هذا من خلال إعداد lane مخصص في Fastlane عبر تعريف مفتاح API، وإضافة إجراء deliver، واختياريًا تمرير submit_for_review: true لإرسال التحديث للمراجعة الفورية.
يظل استخدام Fastlane الطريقة الأكثر مرونة من أجل أتمتة ملاحظات إصدار تطبيقات iOS دون الحاجة إلى بناء نصوص برمجية مخصصة للشبكة من الصفر. فهو يندمج بسلاسة في مسارات العمل التي تُنشئ هذه الملفات النصية ديناميكيًا.
كيفية ترجمة ملاحظات إصدار التطبيق تلقائيًا؟
يمكنك ترجمة ملاحظات إصدار التطبيقات تلقائيًا عن طريق ربط سير عمل إنشاء النصوص الخاص بك بواجهة برمجة تطبيقات (API) للترجمة بالذكاء الاصطناعي، أو باستخدام إضافة (extension) للمطورين مباشرةً داخل App Store Connect. تقوم هذه الأدوات بتحويل تحديثات اللغة الأساسية إلى اللغات العالمية المختلفة بشكل فوري.
في السابق، كان التدويل والأقلمة (L10n) يتطلب إدارة ملفات CSV ضخمة ووكالات ترجمة. أما اليوم، فيمكن للنصوص البرمجية إرسال ملاحظات الإصدار الإنجليزية إلى واجهة برمجة تطبيقات OpenAI أو Google Cloud Translation API. ثم تُحفظ هذه الردود المترجمة في دلائل Fastlane وتُجهز للرفع.
نظرًا لأن النصوص البرمجية المخصصة لواجهات برمجة التطبيقات تتطلب ضبطًا دقيقًا للمطالبات وصيانة لمفاتيح الـ API، تقدم أدوات المتصفح بديلاً فعالاً. حيث تقوم إضافة StoreManager بأتمتة أقلمة App Store Connect عبر أكثر من 35 لغة باستخدام ذكاء Gemini الاصطناعي مباشرةً داخل متصفحك. فتقوم بإدخال النص الأساسي، لتنشر الإضافة الترجمات عبر كافة اللغات المُعَدة مسبقًا في لمح البصر.
كما يعمل StoreManager على تبسيط المهام الأخرى في لوحة التحكم. فإلى جانب إنشاء نصوص متعددة اللغات، فإنه يقوم بـ إعداد تسعير يعتمد على تعادل القوة الشرائية (PPP) لأكثر من 175 منطقة جغرافية. ويعتمد الاختيار بين نصوص مسار العمل والأتمتة عبر المتصفح بشكل كامل على تفضيلاتك التقنية فيما يخص صيانة الأكواد المخصصة.
كيفية أتمتة ملاحظات إصدار متجر Google Play؟
يمكنك أتمتة ملاحظات إصدار متجر Google Play باستخدام Fastlane Supply أو من خلال استدعاءات مباشرة لـ Google Play Developer API. يفرض Google Play بنية ملفات صارمة يجب على أداة الأتمتة الخاصة بك اتباعها بدقة.
من أجل إنشاء ملاحظات إصدار Android تلقائيًا، قم بتنظيم ملفاتك النصية داخل Fastlane باستخدام قواعد تسمية مرتبطة برمز إصدار البناء. وضع ملاحظات الإصدار الخاصة بك في المسار fastlane/metadata/android/en-US/changelogs/.
يجب أن يتطابق اسم الملف مع رقم إصدار حزمة التطبيق (مثل 10045.txt)، أو يمكنك استخدام default.txt لتطبيق النص ذاته على جميع عمليات الرفع. وتفرض Google حدًا صارمًا يبلغ 500 حرف لملاحظات إصدار Android. لذا يجب أن يتضمن مسار عملك المؤتمت خطوات تحقق لقص أو تلخيص نص Android وذلك لتجنب فشل عملية النشر.
يؤدي تشغيل الأمر fastlane supply إلى الاتصال عبر مفتاح JSON الخاص بحساب خدمة Google Cloud. ليقوم بعد ذلك برفع ملف AAB الخاص بك ويدفع الملفات النصية المترجمة تباعًا إلى Google Play Console، مما يؤدي إلى نشر التحديث على الفور.
هل يمكن للذكاء الاصطناعي كتابة ملاحظات إصدار متجر التطبيقات؟
نعم، يمكن للذكاء الاصطناعي كتابة ملاحظات إصدار متجر التطبيقات من خلال استيعاب سجل إيداعات Git الخاص بك واستخدام النماذج اللغوية الكبيرة (LLMs) لتلخيص التغييرات التقنية الخام. قم بدمج مطالبة الذكاء الاصطناعي مباشرةً في سير عمل التكامل المستمر (CI) الخاص بك قبل مرحلة رفع البيانات الوصفية.
عادةً ما يكتب المطورون رسائل إيداع (commit messages) ذات طابع تقني بحت. إلا أن المستخدمين الذين يقرأون صفحة متجر التطبيقات لا يكترثون لإعادة هيكلة الكود الداخلي؛ بل يهتمون بالتحسينات المتعلقة بالأمان والسرعة. لذلك، قم بإعداد إجراء (GitHub Action) ليجمع كافة رسائل الإيداع بين علامة الإصدار الحالية والسابقة.
يُرسل النص البرمجي لمسار عملك هذه السلسلة المُجمعة من الإيداعات إلى نقطة نهاية لذكاء اصطناعي، حيث تقوم مطالبة بتوجيه النموذج لترجمة المصطلحات التقنية المعقدة إلى فوائد ملموسة للمستخدم. فيرد الذكاء الاصطناعي بنص مُنقح يمثل ملاحظات إصدار تطبيقات منشأة بالذكاء الاصطناعي، والتي يقوم نصك البرمجي بكتابتها تلقائيًا في ملف release_notes.txt. وهذا من شأنه إبراز إضافات الميزات الحقيقية دون إجبار المطورين على التوقف لكتابة نصوص تسويقية.
كيفية استخدام واجهة برمجة تطبيقات App Store Connect للتحديثات؟
يمكنك استخدام واجهة برمجة تطبيقات App Store Connect عن طريق إجراء استدعاءات شبكة REST مصادق عليها لنقطة النهاية appStoreVersionLocalizations بغرض تحديث حقل البيانات whatsNew. ويتخطى هذا الأسلوب الأدوات الوسيطة مثل Fastlane، مما يمنحك تحكمًا كاملاً في بنيتك التحتية.
تتطلب واجهة برمجة تطبيقات Apple مصادقة صارمة، مما يعني أنه يجب عليك إنشاء رمز ويب JSON (JWT) باستخدام مفتاح خاص من حسابك على App Store Connect. يقوم البرنامج النصي المسؤول عن النشر بتوقيع الرمز وإرفاقه بترويسة التفويض لطلب الـ HTTP. ولتحديث لغة معينة، قم أولاً بالاستعلام من الـ API للعثور على المعرّف الداخلي لتلك اللغة الخاص بإصدار تطبيقك المعلق.
أرسل طلب HTTP PATCH إلى https://api.appstoreconnect.apple.com/v1/appStoreVersionLocalizations/{id} مرفقًا بحمولة JSON تحدد نص whatsNew المُحدّث. يُعد الاستخدام المباشر لواجهة برمجة التطبيقات سريعًا للغاية، مما يتيح لك أتمتة تحديثات App Store Connect بشكل متزامن. غير أنه يتطلب منك التعامل بنفسك مع إعادة المحاولات عند الخطأ، وحدود معدل الطلبات، ومنطق تحليل JSON.
ما هي أفضل طريقة لأقلمة ملاحظات الإصدار؟
تعتمد أفضل طريقة لأقلمة ملاحظات الإصدار على وتيرة إصداراتك: استخدم أدوات الأتمتة المباشرة عبر المتصفح من أجل التحديثات الفورية، أو قم ببناء مسار CI/CD مُبرمج بالكامل من أجل الإصدارات المجدولة. وكلاهما يقضي على مشكلة إدخال البيانات يدويًا.
إن بناء تكامل مخصص لواجهة برمجة التطبيقات يوفر أقصى قدر من المرونة، ولكنه يتطلب صيانة مستمرة عندما تقوم المنصات بتحديث نقاط النهاية الخاصة بها. بينما يؤدي استخدام إضافة (extension) إلى تبسيط سير العمل بشكل كبير.
| طريقة الأقلمة | وقت الإعداد | عبء الصيانة | أفضل حالة استخدام |
|---|---|---|---|
| الإدخال اليدوي | لا يوجد | مرتفع جدًا | التطبيقات ذات اللغة الواحدة فقط |
| Fastlane CI/CD | مرتفع | متوسط | فرق المؤسسات ذات الخوادم المخصصة |
| الأتمتة عبر المتصفح | منخفض | منخفض | المطورون المستقلون والإصدارات السريعة |
ولتجاوز صيانة مسارات العمل (pipelines) بالكامل، تقدم إضافات المتصفح قيمة فورية. إذ يمكنك ترجمة ملاحظات إصدار التطبيقات تلقائيًا باستخدام StoreManager مباشرةً من لوحة تحكم Apple الخاصة بك. وبغض النظر عن الأداة التي تختارها، فإن الابتعاد عن الإدخال اليدوي للنصوص يُعد أمرًا ضروريًا لتوسيع النطاق العالمي لتطبيقك بفعالية.
الأسئلة الشائعة
ما هو الحد الأقصى للأحرف في ملاحظات إصدار متجر التطبيقات؟
تفرض Apple حدًا أقصى صارمًا يبلغ 4000 حرف لقسم "ما الجديد في هذا الإصدار" في App Store Connect. بينما يفرض Google Play حدًا أكثر صرامة يبلغ 500 حرف لملاحظات إصدار Android. لذا يجب أن تلتزم نصوص الأتمتة البرمجية الخاصة بك بهذه الحدود لتجنب أخطاء الرفع.
هل تؤدي ترجمة ملاحظات الإصدار إلى تحسين تحسين متجر التطبيقات (ASO)؟
نعم، تعمل ملاحظات الإصدار المترجمة (المأقلمة) على تعزيز تحسين محركات بحث المتاجر (ASO) بشكل كبير. حيث إن تقديم ملاحظات الإصدار بلغة المستخدم الأم يقلل من معدلات الارتداد في صفحة تطبيقك، ويحسن من قابلية القراءة، ويزيد من معدلات التحويل العالمية، مما يؤدي إلى المزيد من التنزيلات في جميع أنحاء العالم.
هل يمكنني استخدام Markdown أو HTML في ملاحظات الإصدار الخاصة بي؟
لا تدعم Apple أو Google عرض أكواد HTML الخام بشكل كامل في ملاحظات الإصدار. حيث تدعم Apple النص العادي البسيط فقط وتتجاهل تنسيق Markdown. في حين تسمح Google ببعض وسوم التنسيق الأساسية للغاية، مثل للنص العريض، ولكن سيتم عرض أكواد HTML المعقدة كنص خام.
كم مرة يجب عليّ تحديث ملاحظات إصدار التطبيق؟
يجب عليك تحديث ملاحظات الإصدار مع كل عملية نشر (deployment) في بيئة الإنتاج تتضمن تغييرات مرئية للمستخدم، أو إصلاحات للأخطاء، أو تحسينات في الأداء. ففي دورات التطوير الحديثة التي تستفيد من الأتمتة، يحدث هذا التحديث عادةً كل أسبوع إلى أسبوعين بالتزامن مع الإصدارات الدورية للسباقات (sprints).
المصادر
- وثائق مطوري Apple، الوثائق الرسمية لواجهة برمجة التطبيقات حول تعديل أقلمة إصدارات متجر التطبيقات عبر نقاط نهاية REST.
- واجهة برمجة تطبيقات مطوري Google Play، وثائق تفصل واجهة برمجة تطبيقات Edits المطلوبة لرفع حزم تطبيقات Android والبيانات الوصفية.
- Fastlane Deliver، إرشادات إعداد شاملة لربط الملفات النصية المحلية بحقول App Store Connect لنظام iOS.
- Fastlane Supply، إرشادات التكوين لدفع سجلات التغيير المترجمة إلى متجر Google Play.
- وثائق GitHub Actions، أفضل الممارسات لإنشاء مسارات عمل مؤتمتة يتم تشغيلها بواسطة علامات (tags) مستودع Git.
- منصة مطوري OpenAI، مرجع واجهة برمجة التطبيقات لدمج النماذج اللغوية الكبيرة لتنسيق وترجمة سجلات الإيداع.
