الإصدارات، الأحدث والمثبّت

الإصدارات، الأحدث والمثبّتلكل عدسة وجه وتأثير شاشة مسودة واحدة وأي عدد من الإصدارات المنشورة. أنت تعدّل المسودة، والنشر يجمّدها بوصفها الإصدار التالي.الحالات

الحالة

المعنى

Draft (مسودة)

لم يُنشر قط. ولا تستطيع التطبيقات جلبه.

Published (منشور)

له إصدار منشور واحد على الأقل. ويمكنك مواصلة تعديل المسودة.

Archived (مؤرشف)

مجمّد: لا مزيد من التعديلات. وتستمر إصداراته المنشورة في الخدمة.

تتضمن قوائم عدسات الوجه وتأثيرات الشاشة مرشّحًا حسب الحالة.النشريمكن لـ Owners (المالكين) وDesigners (المصممين) النشر. اختر Publish (النشر) في ترويسة الاستوديو، فيقوم المحرّر بما يلي:

يحفظ تعديلاتك المعلّقة؛

يفحص المسودة على الخادم، بما في ذلك قواعد مساحة العمل الخاصة بك؛

ينشرها فقط إن لم تكن فيها مشكلات.

إذا وُجدت مشكلات، يسردها تبويب Issues، ويعرض المحرّر "Fix the issues before publishing." (أصلح المشكلات قبل النشر.)، ولا يُنشر شيء. وحين ينجح النشر، تظهر رسالة مثل "Published version 3" (نُشر الإصدار 3).تُرقّم الإصدارات 1، 2، 3 وهكذا. ويضم الإصدار ملف البيان (manifest) والصور التي تستخدمها طبقاته. أما الصور التي رفعتها ولم تستخدمها في أي طبقة فتُستبعد.الإصدار المنشور لا يتغير أبدًابعد نشر الإصدار، لا تُغيَّر ملفاته ولا يُكتب فوقها أبدًا.

تعديل المسودة بعد ذلك لا يغيّر إلا المسودة.

حذف صورة من تبويب Assets لا يمس الإصدارات المنشورة؛ فلكل منها نسخه الخاصة.

لتغيير ما تحصل عليه التطبيقات، عدّل المسودة وانشرها مجددًا، فينتج الإصدار التالي.

هذا ما يتيح لتطبيقك الاحتفاظ بإصدار نهائيًا بعد أن يتحقق منه — ما لم يحذف Owner ذلك الإصدار أو العنصر (انظر أدناه). راجع التنزيل بأمان.تبويب الإصداراتيسرد تبويب Versions في الاستوديو كل إصدار منشور، من الأحدث إلى الأقدم، مع:

Version — رقمه؛

Published — تاريخ نشره؛

Size — حجم ملف البيان وصوره معًا؛

Engine — أدنى إصدار من محرك العرض يستطيع رسمه؛

Manifest — رابط إلى ملف manifest.json الخاص به، وCopy URL.

صور المعاينةبعد نشر عدسة وجه، يرسم المحرّر صورة PNG بحجم 512 × 512 للإصدار الجديد في متصفحك ويرفعها. تظهر الصورة في عمود Preview، وتُرجعها واجهة التسليم في الحقل previewUrl.قد يفشل إنشاؤها، مثلًا في متصفح لا يدعم WebGL. وعندئذ يعرض الصف Generate preview (إنشاء معاينة) لإعادة المحاولة. والعدسة شديدة التفاصيل التي لا تتسع لصورة بحجم 512 KiB لا تحصل على معاينة. لذا اعتبر المعاينة اختيارية: فقد تكون قيمة previewUrl هي null.ليس لتأثيرات الشاشة صور معاينة.الأحدث أو المثبّتتمنحك واجهة التسليم طريقتين لطلب عنصر:

الطلب

تستجيب بـ

GET /v1/lenses/:lensId

أحدث إصدار منشور. ويتغير في كل مرة ينشر فيها أحد.

GET /v1/lenses/:lensId/versions/:version

ذلك الإصدار تحديدًا، وهو ثابت دائمًا.

تعمل تأثيرات الشاشة بالطريقة نفسها، تحت /v1/effects/.

استخدم الأحدث حين ينبغي أن يصل كل نشر إلى مستخدميك.

استخدم المثبّت حين تريد التحقق من الإصدار بنفسك قبل أن ينتقل إليه تطبيقك. فمثلًا، واصل طلب الإصدار 3 حتى تقرر الانتقال إلى الإصدار 4.

راجع واجهة التسليم.الأرشفةيوجد Archive (الأرشفة) في قائمة More actions (⋯) في ترويسة الاستوديو. وبعد التأكيد يصبح العنصر للقراءة فقط: لا يمكن تعديله ولا إعادة تسميته.يستمر العنصر المؤرشف في الخدمة. فمسار الأحدث لا يزال يستجيب بآخر إصدار منشور له، وإصداراته المثبّتة لا تزال تستجيب. وتستمر التطبيقات التي تستخدمه بالفعل في العمل.للعمل عليه مجددًا، اختر Un-archive من القائمة نفسها. العنصر الذي له إصدارات منشورة يعود مباشرًا (ويُحتسب ضمن العناصر المباشرة في خطتك)؛ أما العنصر الذي لم يُنشر قط فيعود مسودة.الحذفيوجد Delete… (حذف) في قائمة More actions (⋯) في ترويسة الاستوديو أو في بطاقة العنصر في القائمة. وهو ينقل العنصر إلى سلة المحذوفات في مساحة العمل، دون الحاجة إلى كتابة أي شيء. ويتوقف تحميل العنصر في التطبيقات فورًا.

يمكن لأي شخص يستطيع تعديل المسودة أن يحذفها.

يجب أرشفة العنصر المباشر أولًا. فالأرشفة تُبقيه يعمل في التطبيقات؛ والحذف هو ما يوقفه.

العنصر الذي نُشر في أي وقت لا يحذفه إلا Owner في مساحة العمل. وتعرض النافذة المنبثقة مُعرّفه وآخر وقت حمّله فيه تطبيق.

تحتفظ صفحة Recycle bin (سلة المحذوفات) في الشريط الجانبي بالعنصر لمدة 30 يومًا. ويعيده Restore كما كان. أما Delete forever… (للـ Owners، مع كتابة DELETE) فيزيل المسودة وكل إصدار وكل ملف مخزّن. وبعد 30 يومًا يُحذف العنصر نهائيًا تلقائيًا. ويستجيب مسارا الأحدث والمثبّت بـ 404 للعنصر المحذوف، كما لو كان مُعرّفًا لم يوجد قط. أما الهواتف التي نزّلته بالفعل فتحتفظ بنسختها.لإزالة عدة عناصر دفعة واحدة، حددها في مكتبة واختر Move to bin. وتُتخطّى العناصر المباشرة.

Important: لا يمكن التراجع عن الحذف النهائي.

حذف إصدار أقدمفي تبويب Versions، يستطيع الـ Owners حذف أي إصدار عدا الأحدث، بكتابة DELETE. وعندئذ تحصل التطبيقات المثبّتة على ذلك الإصدار على 404. ولا يُستخدم رقمه مرة أخرى أبدًا.القواعد والإصدارات المنشورةإذا حصلت مساحة العمل الخاصة بك على ملف قواعد لاحقًا، فلا تُفحص الإصدارات المنشورة بالفعل مرة أخرى. وتسري القواعد بدءًا من عملية Validate أو Publish التالية. راجع القواعد والمناطق المحظورة.