مرحباً بالعالم#

سيرشدك هذا الدليل خطوة بخطوة خلال إنشاء مشروع Vapor جديد، وبنائه، وتشغيل الخادم.

إذا لم تكن قد ثبّت Swift أو Vapor Toolbox بعد، فاطّلع على قسم التثبيت.

• التثبيت → macOS

• التثبيت → Linux

مشروع جديد#

الخطوة الأولى هي إنشاء مشروع Vapor جديد على جهازك. افتح الطرفية واستخدم أمر إنشاء المشروع الجديد من Toolbox. سيؤدي هذا إلى إنشاء مجلد جديد في الدليل الحالي يحتوي على المشروع.

vapor new hello -n

بمجرد انتهاء الأمر، انتقل إلى المجلد المُنشأ حديثاً:

cd hello

البناء والتشغيل#

Xcode#

أولاً، افتح المشروع في Xcode:

open Package.swift

سيبدأ تلقائياً في تنزيل اعتماديات Swift Package Manager. قد يستغرق هذا بعض الوقت في المرة الأولى التي تفتح فيها مشروعاً. عند اكتمال حل الاعتماديات، سيقوم Xcode بملء المخططات (schemes) المتاحة.

في أعلى النافذة، على يمين زرَّي التشغيل (Play) والإيقاف (Stop)، انقر على اسم مشروعك لتحديد مخطط (Scheme) المشروع، ثم اختر هدف تشغيل مناسباً—على الأرجح “My Mac”. انقر على زر التشغيل لبناء مشروعك وتشغيله.

من المفترض أن ترى وحدة التحكم (Console) تظهر في أسفل نافذة Xcode.

[ INFO ] Server starting on http://127.0.0.1:8080

Linux#

على Linux وأنظمة التشغيل الأخرى (وحتى على macOS إذا لم ترغب في استخدام Xcode) يمكنك تحرير المشروع في محرّرك المفضّل، مثل Vim أو VSCode. راجع Swift Server Guides للحصول على تفاصيل محدّثة حول إعداد بيئات تطوير متكاملة (IDEs) أخرى.

لبناء مشروعك وتشغيله، نفّذ في الطرفية:

swift run

سيؤدي ذلك إلى بناء المشروع وتشغيله. في المرة الأولى التي تشغّل فيها هذا، سيستغرق بعض الوقت لجلب الاعتماديات وحلّها. بمجرد التشغيل، من المفترض أن ترى ما يلي في وحدة التحكم:

[ INFO ] Server starting on http://127.0.0.1:8080

زيارة Localhost#

افتح متصفح الويب، وقم بزيارة localhost:8080/hello أو http://127.0.0.1:8080

من المفترض أن ترى الصفحة التالية.

Hello, world!

تهانينا على إنشاء أول تطبيق Vapor خاص بك وبنائه وتشغيله! 🎉