مُصَوّر كود كوتلين
مرشد
مُصَوّر كود كوتلين
أدخل أي مصدر كوتلين واحصل على تنسيق نظيف بأسلوب ktlint مباشرة في متصفحك. يقوم المُنسق بتوحيد التسجيل، وتصحيح مسافات المُشغلات، وترتيب التصنيفات، وإضافة مسافات خلفية في القوائم المتعددة الأسطر، دون إرسال الكود إلى خادم.
كيفية استخدام
- أدخل كودك الكوتلين في مربع الإدخال، أو اضغط اختر مثالًا لتحميل ملف عينة.
- اختر حجم التسجيل (مسافتين، أربع مسافات، أو تبويبات) وحدة الطول القصوى للسطر.
- تبديل فرز الاستيرادات و إضافة مسافات خلفية حسب تفضيلك.
- انقر شكل وأعد نسخ أو احفظ النتيجة المُنظمة.
خصائص
- مسافات بادئة قابلة للتكوين – تبديل بين مسافتين، أربع مسافات، أو تبويبات دون إعادة تعديل الملف.
- مسافات المُشغلات – مسافات متسقة حول
=,==,===,->,?:، والتعيينات المُركبة. - ترتيب التصنيفات – ترتيب التصنيفات حسب الحروف الأبجدية
importبشكل موحد كمقطع واحد. - المسافات الخلفية – تُضاف تلقائيًا في القوائم ذات السطر المتعدد للإشارات والمتغيرات.
- موضع القوس – يبقى القوس المفتوح على نفس السطر مع إعلانه، وفق معايير كوتلين.
- أمان النصوص والتعليقات – يتم الحفاظ على الكلمات داخل نصوص النص، وتعليقات KDoc، وتعليقات السطر.
- من جانب العميل فقط – لا يُرفع كودك من المتصفح؛ لا تُرفع، لا تُسجل.
- نسخ وتنزيل – احصل على النتيجة كنص أو احفظها كـ
.ktملف.
عندما يُستخدم هذا الأداة
يُصمم هذا المُنسق لحالات حيث يكون استخدام سلسلة أدوات كوتلنت أو كتفرم مفرطًا: لصق قطعة من محادثة أو من سلسلة طلبات، تنظيف ملف Gist فردي، أو توحيد عينة للاستخدام في الوثائق. يطبق القواعد التي تُؤثر كثيرًا في مراجعة الكود – مثل عدم توازن المسافات حول العلامات، عدم وجود سطر فارغ بين الإعلانات العليا، أو عدم تطابق مستويات التسجيل بعد تعديل – ويترك التحويلات الابتكارية للإطار المُدمج.
التعليمات
-
ما هو دليل التنسيق المُعتمد في كود كوتلين؟
يُعتمد تنسيق كود كوتلين على المعايير الرسمية لكتابة الكود المُصدرة من جيتبريس. تشمل هذه المعايير التسجيل (أربعة مسافات، لا تبويبات)، وضع القوس على نفس السطر مع الإعلان، مسافات خلفية في القوائم المتعددة الأسطر، وترتيب المُؤشِّرات مثل public، open، override، وsuspend. تُستخدم أدوات مثل ktlint وktfmt لتطبيق هذه القواعد لضمان توازٍ بين الكودات في الفرق.
-
كيف يتم تنظيم تضمينات كوتلين؟
تُقسّ تضمينات كوتلين عادة إلى مقطع واحد في أعلى الملف مباشرة تحت إعلان الحزمة، دون وجود سطر فارغ بين التضمينات. يتم ترتيب التضمينات حسب المسار الكامل. يُسمح بـ تضمينات "أو" ولكن يُنصح بتجنبها في الحزم غير المحددة؛ بينما تُستخدم تضمينات "أو" لحزم مثل kotlinx.android.synthetic ونماذج مشابهة كاستثناءات شائعة.
-
لماذا تُستخدم المسافات الخلفية في كوتلين؟
المسافات الخلفية في القوائم ذات السطر المتعدد، والمتغيرات، والقوائم المُجمعة تقلل من تأثير التغييرات عند إضافة أو ترتيب العناصر، لأن لا حاجة لتعديل السطر العلوي للإغلاق لضمان إضافة مسافة خلفية. أدخلت مسافات خلفية في إصدار 1.4 من كوتلين كجزء من قواعد اللغة، وتشجع أدوات ktlint على استخدامها في القوائم التي تتجاوز سطرًا واحدًا.
-
كيف يتعامل كوتلين مع طول السطر والتكبير؟
يُوصي دليل كوتلين الرسمي بحد أقصى مقبول لطول السطر يبلغ 100 إلى 120 حرفًا. عند تجاوز الإعلان للحد، يُقسّم المعلمات والمتغيرات المُتسلسلة إلى سطر منفصل مع تضمين مستوى إضافي للسطر. يبقى القوس المفتوح على نفس السطر مع القوس المغلق لضمان تكامل الإعلانات بوضوح.
تثبيت ملحقاتنا
أضف أدوات IO إلى متصفحك المفضل للوصول الفوري والبحث بشكل أسرع
恵 وصلت لوحة النتائج!
لوحة النتائج هي طريقة ممتعة لتتبع ألعابك، يتم تخزين جميع البيانات في متصفحك. المزيد من الميزات قريبا!
