Kotlin/coding conventions
<noinclude>{{DISPLAYTITLE:أنماط كتابة الشيفرات المُتعارَف عليها (Coding Conventions)}}</noinclude>
تناقش هذه الصفحة أنماط كتابة الشيفرات المُتَّفق عليها من قِبل مبرمجي لغة Kotlin ضمن العناوين العامّة الآتية:
- تنظيم الشيفرة المصدرية source code
- قواعد التسمية
- التنسيق
- التعليقات التوثيقيَّة
- تجنُّب البُنى الزائدة
- الاستخدام الاصطلاحيُّ لمزايا اللغة
- المكتبات
تطبيق دليل التنسيق
لضبط التنسيق بما يتوافق مع هذا الدليل يُنصَح بتثبيت إضافة Kotlin بالإصدار 1.2.20 (أو أي إصدار أحدث) ومن ثم ضبط المّحرِّر من خلال الذهاب إلى الإعدادات (Settings) ثمّ المُحرِّر (Editor) ثم نمط الشيفرة (Code Style) ثم Kotlin واضغط على "ضبط من..." Set from…"" في الزاوية اليمنى العُلويَّة واختر الخيار Predefined style/Kotlin style guide من القائمة.
وللتأكد من تنسيق الشيفرة وفقًا لدليل Kotlin انتقل لإعدادت التدقيق (inspection settings) وفعِّل الخاصية الموجودة في Kotlin ثم Style issues ثمّ File is not formatted according to project setting (أيّ أنَّ تنسيق الملف ليس خاضعًا لإعدادات المشروع)، أمّا التدقيقات الإضافيّة والتي تتبع لدليل الأنماط المتعارَف عليه (مثل قواعد التسمية) فهي مفعَّلة بالحالة الافتراضيَّة.