تركز الموارد العامة على أنماط تكامل قابلة للتكرار. تبقى SDK والبرامج الثابتة ووثائق المصنع المقيدة ضمن القنوات المعتمدة.
أدلة قابلة للمقارنة مع الطريقة والإصدار والقيود.
- خيار الطابعة الدقيق وعرض الورق وأنواع المخرجات المدعومة.
- ملصق اختبار أو إيصال لا يحتوي على بيانات حقيقية للعميل أو الدفع.
- عامل أو مالك كوروتين يمكنه إجراء تسلسل لمهام الطباعة.
معيار النشر
أنشئ تكاملات Android مؤسسية بأدلة محددة الإصدار.
تركز الموارد العامة على أنماط تكامل قابلة للتكرار. تبقى SDK والبرامج الثابتة ووثائق المصنع المقيدة ضمن القنوات المعتمدة.
- 01
بناء نموذج صفحة واحدة
احتفظ بعناصر النص والرمز الشريطي والصور داخل الصفحة مع فرض قيود واضحة على العرض والارتفاع. لا تبعثر الإحداثيات عبر معالجات النقر.
- 02
التحقق من الحالة قبل التقديم
تعامل مع الانشغال، ونفاد الورق، ودرجة الحرارة الزائدة، وانخفاض الجهد الكهربي، وخطأ السائق كحالات مميزة للمشغل. رسالة "فشل الطباعة" العامة ليست كافية للاسترداد.
- 03
تسلسل وإلغاء
تعطيل الإرسال المكرر عندما يمتلك العامل الطابعة. يجب أن تقوم المهمة الملغاة بإغلاق المورد وترك مسار واضح لإعادة المحاولة.
- 04
التحقق من صحة الإخراج المادي
قم بقياس عرض الورق وإمكانية قراءة الباركود وكمية التغذية والتباين والسلوك الحراري وظروف البطارية. قم بتسجيل البرنامج الثابت للطابعة وتكوين الملحقات.
تطبيقات نموذجية / Kotlin
أنماط SDK وAPI
يمتلك المنفذ مكالمات البائعين ورسم خرائط الحالة. يظل نموذج الصفحة قابلاً للاستخدام في اختبار الوحدة.
data class PrintJob(
val title: String,
val lines: List<String>,
val barcode: String?,
)
sealed interface PrintResult {
data object Printed : PrintResult
data class Blocked(val reason: String) : PrintResult
data class Failed(val reason: String) : PrintResult
}
interface PrintPort {
suspend fun print(job: PrintJob): PrintResult
}
suspend fun runPrint(port: PrintPort, job: PrintJob): PrintResult =
runCatching { port.print(job) }
.getOrElse { PrintResult.Failed("driver-error") }توزيع SDK
بوابة النشر
لا تُنشر ملفات المصنع أو البرامج الثابتة أو الأمثلة قبل تسجيل إذن التوزيع.
احتفظ بالمهمة في قائمة الانتظار أو اطلب من المشغل إعادة المحاولة؛ لا ترسل مكالمات الصفحة الموازية.
اعرض إجراء الاسترداد المحدد وانتظر حتى تظهر حالة جديدة قبل إعادة المحاولة.
تحقق من عرض الصفحة والمنطقة الهادئة وحجم الوحدة للتعرف على التكوين الدقيق للطابعة.
قم بالإلغاء أو الانتهاء وفقًا لسياسة المهمة، ثم أغلق الطابعة في العامل.
حالات الدليل
أدلة قابلة للمقارنة مع الطريقة والإصدار والقيود.
- 01
طباعة نص ورمز شريطي واحد وصورة واحدة بعرض الورق المستهدف.
- 02
قم بمقاطعة العملية وتأكد من تحرير الطابعة.
- 03
اختبر حالات الانشغال ونفاد الورق والحرارة والجهد وخطأ السائق.
- 04
تأكد من عدم كتابة أي بيانات خاصة بالعميل أو الدفع أو بيانات الاعتماد في السجلات أو التركيبات.
الموارد
أنماط SDK وAPI
لا تُنشر ملفات المصنع أو البرامج الثابتة أو الأمثلة قبل تسجيل إذن التوزيع.