عمل درآمد
کیوب کی ہر گردش ایک مخصوص نظام پر مبنی ہے: ریاضیاتی ماڈل، 3D انجن اور حل تلاش کرنے والا نظام جو سبق کے مقاصد کو مدنظر رکھتا ہے۔ Android ایپ Kotlin اور Jetpack Compose میں لکھی گئی ہے۔
منصوبے کا اسنیپ شاٹ
test* / androidTest* · @Teststack.kt
| Kotlin | 2.4.21 |
|---|---|
| Compose BOM | 2026.09.00 |
| Material 3 | 1.5.0-beta01 |
| Adaptive | 1.3.0 |
| Navigation 3 | 1.2.0 |
| AGP | 9.4.1 |
| KSP | 2.3.12 |
| Gradle | 9.7.0 |
Jetpack Compose اور Material 3 انٹرفیس کے اجزا اور تھیم متعین کرتے ہیں۔ Adaptive ونڈو کے سائز کے مطابق لے آؤٹ سنبھالتا ہے، جبکہ Navigation 3 نیویگیشن اور اسکرین کی بحالی سنبھالتا ہے۔ حالت Coroutines اور Flow کے ذریعے آتی ہے؛ Hilt ایپ کے ماڈیول جوڑتا ہے۔
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileانٹرفیس، ڈومین معاہدے اور ڈیٹا الگ ماڈیولوں میں ہیں؛ Hilt عمل درآمد کو جوڑتا ہے۔ Compose ناقابلِ تبدیلی حالت اور واضح واقعات وصول کرتا ہے۔ Room تاریخ اور سیکھنے کی پیش رفت، DataStore ترتیبات محفوظ کرتا ہے، جبکہ Navigation 3 حصوں کے اسٹیکس بحال کرتا ہے۔
android-ux.md
Cubiq میں وہ طریقے نافذ ہیں جنہیں Google اپنے Apps Experience Program میں نمایاں کرتا ہے: Compose، ڈھلنے والا لے آؤٹ اور edge-to-edge۔
engine.glsl
GLSL شیڈرز PBR مواد، کھردراپن اور ماحول کی روشنی کا حساب کرتے ہیں۔ ماڈل اور اینیمیشن ہم آہنگ ہیں: ایک قدم پیچھے جانے سے الٹی چال لاگو ہوتی ہے، اور کیمرا پینلوں کے درمیان خالی جگہ کو مدنظر رکھتا ہے۔
ٹائپ شدہ نوٹیشن چالوں اور ہم آہنگ کیوب حالات میں بدلتی ہے۔ رینڈرر کی قطار تہوں کی گردش اینیمیٹ کرتی ہے، حصوں اور فیسلیٹس کی شناخت برقرار رکھتے ہوئے۔ فارمولا حقیقی چالوں کی ترتیب میں چلتا ہے، پلے، پاز اور رفتار کے کنٹرول کے ساتھ۔
اگلا قدم نئی چال اینیمیٹ کرتا ہے؛ پچھلا قدم الٹی چال لاگو کرتا ہے۔ کسی مقام پر جانا بنیادی منظر اور ہدف کی ترتیب بحال کرتا ہے۔ منسوخی اگلی چالیں بھیجنا روکتی ہے؛ شروع ہوئی گردش مکمل ہوتی ہے۔ EGL لائف سائیکل pause/release سنبھالتا ہے؛ GL دستیاب نہ ہو تو سیکھنے کا راستہ 3D کے بغیر باقی ہے۔
solver.kt
اپنا حل تلاش کرنے والا نظام موجودہ سبق کے فارمولوں اور معاون چالوں سے حل بناتا ہے۔ SolverRequest میں کیوب کی حالت، ہدف کے حصے، لاک شدہ اہداف، اجازت یافتہ فارمولے، صورتیں اور سمت ہیں۔ منصوبہ ساز سیکھنے کے اہداف کی ترتیب مانتا ہے اور حل شدہ حصے محفوظ رکھتا ہے۔
مرحلے کے مطابق منصوبہ بندی محدود BFS، بیم سرچ اور F2L صورتوں کی شناخت استعمال کرتی ہے۔ توثیق حصوں کے مجموعے، فلپس، ٹوئسٹس اور پرمیوٹیشن پیرٹی کو جانچتی ہے۔ تلاش کی پالیسی گہرائی اور بیم کی چوڑائی محدود کرتی ہے۔ سبق بدلنے سے تلاش منسوخ ہوتی ہے اور پرانا نتیجہ روکا جاتا ہے۔
نتیجہ PracticePlan ہے: قدم، فارمولے کے حوالے، ڈسپلے ٹائم لائن اور ایگزیکیوشن ٹائم لائن۔ وضاحت سبق کی سمت برقرار رکھتی ہے؛ انجن کو مکمل اجرائی ترتیب ملتی ہے۔ نتائج: plan / solved / invalid input / no constrained path۔
content.md
نظریہ 756 Markdown دستاویزات میں محفوظ ہے، اور مشق 336 مقامی زبانوں میں ڈھالے گئے منظرناموں میں متعین ہے۔ Gradle تراجم کی ساخت اور 316 اصل تصاویر کے حوالوں کی جانچ کرتا ہے۔ گرافکس Blender/Cycles میں تیار کیے گئے؛ Android انجن الگ طریقہ جاتی جیومیٹری استعمال کرتا ہے۔
workflow.md
AGENTS.mdREADME.mdریپوزٹری ایجنٹوں کے ساتھ ترقی کے لیے منظم ہے: AGENTS.md کی درجہ بندی ذمہ داریاں، معماری کی پابندیاں اور توثیق کے گیٹس متعین کرتی ہے؛ README.md ماڈیول معاہدے اور KDoc API اور مستقل شرائط بیان کرتے ہیں۔
معماری، ڈیزائن اور مقامی زبانوں کے معاہدے کوڈ کے ساتھ ورژن کنٹرول میں ہیں۔ PLAN.md دائرہ اور کام کی حوالگی درج کرتا ہے؛ معاہدے کی تبدیلی متعلقہ مالک کی دستاویزات بھی بدلتی ہے۔ جانچ اور جنریشن Gradle سے ہوتی ہیں؛ CI دونوں اسٹور صورتوں کا بلڈ بناتا ہے۔
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationٹیسٹ ناممکن کیوب حالات، حل شدہ تہوں کے تحفظ، سیکھنے کے منصوبوں، پرانی درخواستوں کی منسوخی، سیشن کی بحالی اور ڈیٹا درآمد کا احاطہ کرتے ہیں۔ CI دونوں اسٹور صورتوں کا بلڈ بناتا ہے؛ ریلیز کی جانچ میں R8، APK/AAB، چیک سم اور 16 KB پیجز کے لیے نیٹو لائبریریوں کی الائنمنٹ شامل ہے۔
Kotlin کی مقدار فزیکل سطروں میں گنی گئی ہے، جس میں تبصرے، خالی سطریں، buildSrc اور بینچ مارک کوڈ شامل ہیں، ٹیسٹ ڈائریکٹریاں نہیں۔ ٹیسٹوں کی تعداد سے مراد 1 343 JVM ڈیکلریشنز اور 281 Android ڈیکلریشنز ہیں، چلائے جانے کی تعداد نہیں۔ دستاویزات میں متبادل متن شامل ہے؛ منظرنامہ ہونے کا مطلب ہر سبق میں مشق ہونا نہیں ہے۔
baselineprofile · @Testکل متن، ٹریک کیے گئے UTF-8 سورس، ٹیسٹوں، XML/JSON وسائل، Markdown مواد، مقامی زبانوں، دستاویزات، بلڈ ٹولز اور ویب سورس کی فزیکل سطریں گنتا ہے۔ تبصرے، خالی سطریں اور زبانوں کی نقول شامل ہیں۔ میڈیا، جنریٹڈ/بلڈ آؤٹ پٹ، وینڈر کوڈ، سروس کنفیگریشن اور عارضی PLAN.md خارج ہیں۔ یہ منصوبے کے متنی اِن پٹ کا حجم ہے، قابلِ اجرا LOC نہیں۔