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

أوسو! شعار

أوسو!

بناء الحالة

لعبة إيقاعية مجانية للفوز. الإيقاع هو مجرد نقرة واحدة!

هذا هو التكرار المستقبلي – والنهائي – لـ OSU! عميل اللعبة الذي يمثل بداية عصر مفتوح! معروف حاليًا وتم إصداره تحت الاسم الرمزي للإصدار " lazer ". كما هو الحال في أكثر حدة من المتطورة.

حالة

هذا المشروع قيد التطوير المستمر، ولكننا نبذل قصارى جهدنا للحفاظ على الأمور في حالة مستقرة. يتم تشجيع اللاعبين على التثبيت من الإصدار إلى جانب نظام OSU المستقر الخاص بهم! عميل. سيستمر هذا المشروع في التطور حتى نصل في النهاية إلى النقطة التي يفضلها معظم المستخدمين على الإصدار السابق "osu!stable".

تتوفر بعض الموارد كنقاط بداية للمشاركة وفهم المشروع:

  • تتوفر سجلات التغيير التفصيلية للإصدار على موقع OSU الرسمي! موقع.
  • يمكنك معرفة المزيد عن نهجنا في إدارة المشاريع.
  • تتبع جهودنا الحالية نحو تحسين اللعبة.

تشغيل أوسو!

إذا كنت تتطلع فقط إلى تجربة اللعبة، فيمكنك الحصول على أحدث إصدار لمنصتك:

أحدث إصدار:

ويندوز 10+ (x64) نظام التشغيل macOS 12+ (إنتل، وأبل سيليكون) لينكس (x64) دائرة الرقابة الداخلية 13.4+ أندرويد 5+

يمكنك أيضًا بشكل عام تنزيل إصدار لجهازك الحالي من OSU! موقع.

إذا كان نظامك الأساسي غير مدعوم أو غير مدرج أعلاه، فلا تزال هناك فرصة لتشغيل الإصدار أو إنشائه يدويًا باتباع الإرشادات أدناه.

لمستخدمي iOS/iPadOS : يمتلئ رابط اختبار iOS بسرعة كبيرة (لدى Apple حد صارم يبلغ 10000 مستخدم). نقوم بإعادة ضبطه من حين لآخر. من فضلك لا تسأل عن هذا. تحقق مرة أخرى بانتظام لإعادة تعيين الارتباط أو اتبع مفعم بالحيوية على تويتر للحصول على الإعلانات. هدفنا هو الحصول على اللعبة على متاجر تطبيقات الأجهزة المحمولة في أوائل عام 2024.

تطوير مجموعة قواعد مخصصة

أوسو! تم تصميمه للسماح بتنوعات اللعب التي أنشأها المستخدم، والتي تسمى "مجموعات القواعد". يسمح بناء واحد منها للمطور بتسخير قوة OSU! مكتبة Beatmap ومحرك الألعاب وتجربة المستخدم العامة لأسلوب جديد من اللعب. لبدء العمل على مجموعة القواعد، لدينا بعض النماذج المتاحة هنا.

يمكنك مشاهدة بعض الأمثلة على مجموعات القواعد المخصصة من خلال زيارة دليل مجموعة القواعد المخصصة.

تطوير أوسو!

المتطلبات الأساسية

يرجى التأكد من توفر المتطلبات الأساسية التالية:

  • نظام أساسي لسطح المكتب مثبت عليه .NET 8.0 SDK.

عند العمل مع قاعدة التعليمات البرمجية، نوصي باستخدام IDE مع استكمال التعليمات البرمجية الذكية وتمييز بناء الجملة، مثل أحدث إصدار من Visual Studio أو JetBrains Rider أو Visual Studio Code مع تثبيت EditorConfig وC# Dev Kit الإضافي.

تنزيل الكود المصدري

استنساخ المستودع: 

git clone https://github.com/ppy/osu
cd osu

لتحديث التعليمات البرمجية المصدر إلى آخر التزام، قم بتشغيل الأمر التالي داخل دليل osu : 

git pull

مبنى

من IDE

يجب عليك تحميل الحل عبر أحد ملفات .slnf الخاصة بالنظام الأساسي، بدلاً من ملف .sln الرئيسي. سيؤدي هذا إلى تقليل التبعيات وإخفاء الأنظمة الأساسية التي لا تهتم بها. ملفات .slnf الصالحة هي:

  • osu.Desktop.slnf (الأكثر شيوعًا)
  • osu.Android.slnf
  • osu.iOS.slnf

يتم تضمين تكوينات التشغيل لـ IDEs الموصى بها (المذكورة أعلاه). يجب عليك استخدام وظيفة Build/Run المتوفرة في IDE الخاص بك لبدء الأمور. عند اختبار أو إنشاء مكونات جديدة، ننصحك بشدة باستخدام osu! (Tests) المشروع/التكوين. مزيد من المعلومات حول هذا موضح أدناه.

لإنشاء منصات متنقلة، ستحتاج على الأرجح إلى تشغيل sudo dotnet workload restore إذا لم تكن قد قمت بذلك من قبل. سيؤدي هذا إلى تثبيت أدوات Android/iOS المطلوبة لإكمال الإنشاء.

من كلي

يمكنك أيضًا إنشاء وتشغيل OSU! من سطر الأوامر بأمر واحد: 

dotnet run --project osu.Desktop

عند التشغيل محليًا لإجراء أي نوع من اختبارات الأداء، تأكد من إضافة -c Release إلى أمر الإنشاء، نظرًا لأن عبء التشغيل باستخدام تكوين Debug الافتراضي يمكن أن يكون كبيرًا (خاصة عند الاختبار باستخدام تعديلات إطار العمل المحلي على النحو الموضح أدناه).

إذا فشل البناء، فحاول استعادة حزم NuGet باستخدام dotnet restore .

الاختبار باستخدام تعديلات الموارد/الإطار

في بعض الأحيان قد يكون من الضروري إجراء اختبار شامل للتغييرات في موارد OSU أو إطار عمل OSU. يمكن تحقيق ذلك بسرعة باستخدام الأوامر المضمنة:

ويندوز: 

 UseLocalFramework.ps1
UseLocalResources.ps1

ماك / لينكس: 

 UseLocalFramework.sh
UseLocalResources.sh

لاحظ أن هذه الأوامر تفترض أن لديك المشروع (المشاريع) ذات الصلة التي تم سحبها في الدلائل المجاورة: 

 |- osu            // this repository
|- osu-framework
|- osu-resources

تحليل الكود

قبل تنفيذ التعليمات البرمجية الخاصة بك، يرجى تشغيل منسق التعليمات البرمجية. يمكن تحقيق ذلك عن طريق تشغيل dotnet format في سطر الأوامر، أو استخدام أمر Format code في IDE الخاص بك.

لقد اعتمدنا بعض المحللين المتكاملين عبر الأنظمة الأساسية. يمكنهم تقديم تحذيرات عندما تقوم بالتحرير أو البناء داخل IDE أو من سطر الأوامر، كما لو تم توفيرها بواسطة المترجم نفسه.

يتم استخدام JetBrains ReSharper InspectCode أيضًا لمجموعات القواعد الأوسع. يمكنك تشغيله من PowerShell باستخدام .InspectCode.ps1 . وبدلاً من ذلك، يمكنك تثبيت ReSharper أو استخدام Rider للحصول على دعم مضمّن في بيئة التطوير المتكاملة (IDE) التي تختارها.

المساهمة

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

إذا كنت ترغب في المساعدة في جهود التوطين، فتوجه إلى موقع Crowdin.

نحن نحب مكافأة المساهمات الجيدة. إذا كنت قد قدمت مساهمة كبيرة، أو كنت مساهمًا منتظمًا، فنحن نرحب بك لتقديم نفقات عبر opencollective. إذا كانت لديك أية أسئلة، فلا تتردد في التواصل مع Peppy قبل القيام بذلك.

رخصة

أوسو! تم ترخيص كود وإطار العمل الخاص بـ MIT بموجب ترخيص MIT. يرجى الاطلاع على ملف الترخيص لمزيد من المعلومات. tl;dr يمكنك أن تفعل ما تريد طالما قمت بتضمين إشعار حقوق النشر والترخيص الأصلي في أي نسخة من البرنامج/المصدر.

يرجى ملاحظة أن هذا لا يغطي استخدام "osu!" أو العلامة التجارية "ppy" في أي برنامج أو موارد أو إعلان أو ترويج، حيث أن هذا محمي بموجب قانون العلامات التجارية.

يرجى أيضًا ملاحظة أن موارد اللعبة مشمولة بترخيص منفصل. يرجى مراجعة مستودع موارد ppy/osu للحصول على التوضيحات.

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