انتقل إلى المحتوى
YA
كل الأعمال
نموذج أوليأندرويد

CodePortميناء الكود

مستودع GitHub كمدينة ميناء حيّة بمنظور متساوي القياس — كل إيماءة تنفّذ أمر Git حقيقياً.

الحالة
المرحلة الرابعة من الخطة: الشاشات الست تعمل فوق عالم واحد، مع نهار/ليل واتجاه من اليمين وTalkBack.
الفترة
2026
المنصات
Android
المستودع
خاص — متاح عند الطلب
منشور
—
شاشات CodePort: مدينة الميناء متساوية القياس

01نظرة عامة

الإيداعات صناديق، وطلبات الدمج شاحنات، والتكامل المستمر هو الطقس. الأوامر الخطرة تمر عبر «الجمارك»، حيث ما يُعرض هو بالضبط ما يُنفَّذ، خلف تأكيد بالضغط المطوّل. ست شاشات فوق عالم واحد: البداية والمستودعات وواجهة المدينة وورقة طلب الدمج والجمارك و«آلة الزمن» التي تتصفح التاريخ والمدينة تكبر.

بالأرقام

زمن المعالج p95 لكل إطار، مشهد ضغط
2.7 ms
زمن المعالج p95 لكل إطار، مشهد ضغط
ADR 0001 benchmark
إطاراً/ث، المشهد العادي
59.9
إطاراً/ث، المشهد العادي
ADR 0001 benchmark
تخصيص لكل إطار
0
تخصيص لكل إطار
JVM test
إيداعاً
49
إيداعاً
git history
  1. 02المشكلة

    Git قوي ومجرّد، وعملياته الخطرة تشبه الآمنة تماماً. وعملاء Git على الجوال إما يخفون القوة أو يعرضون أوامر خام بلا إحساس بالعواقب.

  2. 03الحل

    نموذج عالم ومحاكاة حتمية بلغة Kotlin النقية، ومحرّك رسم متساوي القياس بأطلس صور مُعدّ مسبقاً، وآلة حالات «جمارك» يُعرض فيها الأمر الدقيق ولا يُنفَّذ سواه.

04الشاشات

05معمارية النظام

  1. L1الميزات
    • city
    • pullrequest
    • customs
    • repos
    • timemachine
    • splash
  2. L2المحرك (Kotlin نقية)
    • World model
    • Deterministic simulation
    • Isometric math
    • Depth sorting
    • Director
  3. L3الرسم
    • Sprite baking → atlas
    • Zero-allocation frame renderer
    • Compose Canvas host
  4. L4البيانات
    • GitHub REST client
    • ETag polling
    • Rate limits
    • Room cache
    • Tink-encrypted token
  5. L5الأمان
    • Customs state machine
    • PortCommand
    • Hold-to-confirm
    • Sandbox-only real merges
وحدات المحرك والبيانات بلغة Kotlin النقية مختبرة على JVM؛ ووحدات أندرويد للرسم والاستضافة فقط.مخطط — مستخلص من الكود المصدري

06قرارات هندسية

  1. Compose Canvas بدل SurfaceView — بالقياس

    بُني مضيفان حول المحرك نفسه وقيسا على هاتف متوسط (Snapdragon 6 Gen 1). فاز Compose Canvas في كل محور: زمن المعالج p95 بين 2.5 و2.7 ملّي ثانية لنحو ٢٥٠ كائناً مقابل ميزانية ٨، وتقطّع 0.17–0.34٪، مقابل 9.3–9.9 ملّي ثانية و1.2–1.5٪ لـ SurfaceView.

  2. صفر تخصيصات ذاكرة لكل إطار

    تُعدّ الرسوم الثابتة مرة واحدة عند البدء في صفحات أطلس بصيغة bitmap عتادية، وكل إطار عمليات نسخ مرتبة بالعمق وخطوط مجمّعة. وضمان عدم التخصيص في المحاكاة مُتحقَّق منه باختبار JVM.

  3. الدمج الحقيقي في بيئة معزولة فقط

    الدمج الحقيقي يعمل في نسخ التطوير فقط، على مستودع معزول برمز دقيق الصلاحيات، والمفتاح مطفأ عند كل تشغيل.

مساهمتي

الفكرة وسجلات القرار والمحرك والرسم وطبقة البيانات والشاشات الست — ١٥٠ ملف Kotlin عبر ١٥ وحدة.

التقنيات

  • Kotlin
  • Jetpack Compose
  • Compose Canvas
  • Hilt
  • Room
  • Tink
  • kotlinx.serialization
  • Coroutines
  • GitHub REST API
  • Macrobenchmark
  • MockWebServer
  • Multi-module
  • detekt
  • ktlint

كيف تم التحقق

تمت مراجعة الكود والوثائق وسجلات القرار بما فيها جداول القياس على الجهاز. الصور من يزن: نظرة على الشاشات ولقطة من جهاز حقيقي.

مشاريع ذات صلة

المشروع التالي

Kaff