الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

لغة البرمجة كوتلن

مرحبا بكم في كوتلين!
إنها لغة برمجة مفتوحة المصدر ومكتوبة بشكل ثابت مدعومة ومطورة بواسطة JetBrains والمساهمين مفتوحي المصدر.

بعض الروابط المفيدة:

  • موقع كوتلن
  • دليل البدء
  • جرب كوتلين
  • مكتبة كوتلين القياسية
  • تعقب المشكلة
  • قناة كوتلين على اليوتيوب
  • المنتدى
  • مدونة كوتلين
  • اشترك في قناة كوتلن على اليوتيوب
  • اتبع كوتلين على تويتر
  • قناة سلاك العامة
  • بناء TeamCity CI

قدرات منصة Kotlin المتعددة

يعد دعم البرمجة متعددة المنصات أحد المزايا الرئيسية لـ Kotlin. إنه يقلل من الوقت المستغرق في الكتابة والحفاظ على نفس الكود لمنصات مختلفة مع الحفاظ على مرونة وفوائد البرمجة الأصلية.

  • Kotlin Multiplatform Mobile لمشاركة التعليمات البرمجية بين Android وiOS
  • البدء باستخدام دليل الهاتف المحمول Kotlin Multiplatform
  • فوائد منصة Kotlin المتعددة
  • مشاركة الكود على جميع المنصات
  • مشاركة الكود على منصات مماثلة

تحرير كوتلين

  • Kotlin IntelliJ IDEA Plugin (كود المصدر)
  • البرنامج المساعد كوتلين الكسوف
  • حزمة نص Kotlin Sublime

بناء متطلبات البيئة

يستخدم هذا المستودع ميزة سلاسل أدوات Gradle لتحديد JDKs المطلوبة وتوفيرها تلقائيًا من مشروع AdoptOpenJdk.

وبدلاً من ذلك، لا يزال من الممكن توفير JDKs المطلوبة فقط عبر متغيرات البيئة (راجع gradle.properties لمعرفة أسماء المتغيرات المدعومة). للتأكد من أن Gradle يستخدم JDKs فقط من المتغيرات البيئية - قم بتعطيل الاكتشاف التلقائي لسلسلة أدوات Gradle عن طريق تمرير الخيار -Porg.gradle.java.installations.auto-detect=false (أو ضعه في $GRADLE_USER_HOME/gradle.properties ).

في نظام التشغيل Windows، قد تحتاج إلى إضافة إعداد المسارات الطويلة إلى الريبو: 

 git config core.longpaths true

مبنى

تم بناء المشروع باستخدام Gradle. قم بتشغيل Gradle لبناء المشروع وإجراء الاختبارات باستخدام الأمر التالي على Unix/macOS: 

 ./gradlew <tasks-and-options>

أو الأمر التالي على نظام التشغيل Windows: 

 gradlew <tasks-and-options>

في أول تكوين للمشروع، سيتم تنزيل التبعيات وإعدادها

  • يعد intellij-core جزءًا من برنامج التحويل البرمجي لسطر الأوامر ويحتوي على واجهات برمجة التطبيقات الضرورية فقط.
  • idea-full عبارة عن إصدار مجتمع IntelliJ IDEA كامل لاستخدامه في وحدة البرنامج المساعد.

هذه التبعيات كبيرة جدًا، لذا اعتمادًا على جودة اتصالك بالإنترنت، قد تواجه مهلة زمنية للحصول عليها. في هذه الحالة، يمكنك زيادة المهلة عن طريق تحديد معلمات سطر الأوامر التالية في التشغيل الأول: 

 ./gradlew -Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000

مهام gradle الهامة

  • clean - نتائج بناء نظيفة
  • dist - يجمع توزيع المترجم في مجلد dist/kotlinc/
  • install - إنشاء جميع العناصر العامة وتثبيتها في مستودع maven المحلي
  • coreLibsTest - إنشاء وتشغيل اختبارات stdlib وreflex واختبارات kotlin
  • gradlePluginTest - إنشاء اختبارات المكونات الإضافية وتشغيلها
  • compilerTest - بناء وتشغيل جميع اختبارات برنامج التحويل البرمجي

لإعادة إنتاج تصميم TeamCity، استخدم -Pteamcity=true flag. لا تعمل الإصدارات المحلية على تشغيل proguard ويتم تعطيل ضغط الجرة افتراضيًا.

اختياري: يتم إنشاء بعض القطع الأثرية، خاصة مكونات Maven الإضافية، بشكل منفصل باستخدام Maven. راجع المكتبات/ReadMe.md للحصول على التفاصيل.

لبناء Kotlin/Native، راجع kotlin-native/README.md.

العمل مع المشروع في IntelliJ IDEA

يوصى باستخدام أحدث إصدار من Intellij IDEA (Community أو Ultimate Edition). يمكنك تنزيل IntelliJ IDEA هنا.

بعد استنساخ المشروع، قم باستيراد المشروع في IntelliJ عن طريق اختيار دليل المشروع في مربع حوار فتح المشروع.

للعمل المفيد مع اختبارات المترجم، يوصى باستخدام Kotlin Compiler Test Helper

التحقق من التبعية

لدينا ميزة التحقق من التبعيات ممكّنة في المستودع لجميع إصدارات Gradle. سيتحقق Gradle من التجزئات (md5 وsha256) للتبعيات المستخدمة وسيفشل في الإنشاءات مع Dependency verification failed عند غياب العناصر المحلية أو وجود تجزئات مختلفة مدرجة في ملف Verification-metadata.xml.

من المتوقع أن يتم تحديث verification-metadata.xml فقط من خلال الالتزامات التي تعدل البنية. هناك بعض النصائح حول كيفية إجراء مثل هذه التحديثات:

  • احذف قسم components في verification-metadata.xml لتجنب تخزين التبعيات القديمة غير المستخدمة. يمكنك استخدام الأمر التالي: 
 # macOS
sed -i ' ' -e ' /<components>/,/</components>/d ' gradle/verification-metadata.xml
# Linux & Git for Windows
sed -i -e ' /<components>/,/</components>/d ' gradle/verification-metadata.xml
  • أعد إنشاء التبعيات باستخدام أمر --write-verification-metadata الخاص بـ Gradle (تحقق من أن التحديث يتعلق بالتغييرات التي أجريتها) 
./gradlew --write-verification-metadata sha256,md5 -Pkotlin.native.enabled=true resolveDependencies

تعمل مهمة resolveDependencies على حل التبعيات لجميع الأنظمة الأساسية بما في ذلك التبعيات التي تم تنزيلها بواسطة المكونات الإضافية.

يمكنك أيضًا استخدام البرنامج النصي ./scripts/update-verification-metadata.sh الذي يتضمن هاتين الخطوتين

ضع في اعتبارك:

  • إذا كنت تضيف تبعية مع نظام التشغيل المذكور في اسم قطعة أثرية ( darwin ، mac ، osx ، linux ، windows )، فتذكر إضافتها إلى تكوين implicitDependencies أو تحديث مهمة resolveDependencies إذا لزم الأمر. يجب أن يحل resolveDependencies جميع التبعيات بما في ذلك التبعيات الخاصة بالأنظمة الأساسية المختلفة.
  • إذا كان لديك ملف local.properties في مجلد مشروع Kotlin الخاص بك، فتأكد من أنه لا يحتوي على kotlin.native.enabled=false . وبخلاف ذلك، قد لا تتم إضافة التبعيات الأصلية فقط إلى بيانات تعريف التحقق. وذلك لأن local.properties لها أسبقية أعلى من -Pkotlin.native.enabled=true المحدد في أمر Gradle.

باستخدام إصدارات -dev

ننشر إصدارات -dev بشكل متكرر.

بالنسبة لإصدارات -dev ، يمكنك استخدام قائمة الإصدارات المتاحة وتضمين المستودع المخضرم هذا: 

maven( " https://maven.pkg.jetbrains.space/kotlin/p/kotlin/bootstrap " )

رخصة

يتم توزيع Kotlin بموجب شروط ترخيص Apache (الإصدار 2.0). راجع مجلد الترخيص للحصول على التفاصيل.

المساهمة

يرجى التأكد من مراجعة إرشادات المساهمة الخاصة بـ Kotlin لمعرفة كيفية مساعدة المشروع.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل