Uygulama
Küpün her dönüşü özel bir sisteme dayanır: matematiksel model, 3D motoru ve ders hedeflerini dikkate alan bir çözücü. Android uygulaması Kotlin ve Jetpack Compose kullanır.
Proje anlık görüntüsü
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 ve Material 3 arayüz bileşenlerini ve temalarını belirler. Adaptive pencere boyutuna göre düzeni, Navigation 3 ise gezinmeyi ve ekranların geri yüklenmesini yönetir. Durum Coroutines ve Flow üzerinden gelir; Hilt uygulama modüllerini bağlar.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileArayüz, alan sözleşmeleri ve veriler ayrı modüllerdedir; Hilt uygulamaları birbirine bağlar. Compose değişmez durum ve açık olaylar alır. Room geçmişi ve öğrenme ilerlemesini, DataStore ayarları saklar; Navigation 3 bölüm yığınlarını geri yükler.
android-ux.md
Cubiq, Google'ın Apps Experience Program kapsamında öne çıkardığı yaklaşımları uygular: Compose, uyarlanabilir düzen ve edge-to-edge.
engine.glsl
GLSL shader'ları PBR malzemelerini, pürüzlülüğü ve çevre aydınlatmasını hesaplar. Model ve animasyon uyumludur: bir adım geri gitmek ters hamleyi uygular, kamera da paneller arasındaki boş alanı dikkate alır.
Tür bilgisi taşıyan gösterim, hamlelere ve tutarlı küp durumlarına dönüştürülür. Renderer kuyruğu, parça ve facelet kimliklerini koruyarak katman dönüşlerini canlandırır. Formül gerçek hamle dizisi olarak, oynatma, duraklatma ve tempo ayarıyla yürütülür.
İleri adım yeni hamleyi canlandırır; geri adım ters hamleyi uygular. Konuma atlama temel sahneyi ve hedef diziyi geri yükler. İptal, sonraki hamlelerin verilmesini durdurur; başlamış dönüş tamamlanır. EGL yaşam döngüsü pause/release işlemlerini yönetir; GL yoksa öğrenme yolu 3D olmadan kullanılabilir kalır.
solver.kt
Özel çözücü, mevcut dersin formülleri ve yardımcı hamleleriyle çözüm kurar. SolverRequest; küp durumu, hedef parçalar, kilitli hedefler, izin verilen formüller, durumlar ve yönelim içerir. Planlayıcı öğrenme hedeflerinin sırasını izler ve çözülmüş parçaları korur.
Fazlara özel planlama sınırlı BFS, ışın araması ve F2L durum tanımayı kullanır. Doğrulama parça bileşimini, çevirmeleri, burulmaları ve permütasyon paritesini kontrol eder. Arama politikası derinliği ve ışın genişliğini sınırlar. Ders değişimi aramayı iptal eder ve eski sonucu engeller.
Sonuç PracticePlan olur: adımlar, formül başvuruları, görüntüleme zaman çizelgesi ve yürütme zaman çizelgesi. Açıklama eğitim yönelimini korur; motor tam yürütme dizisini alır. Sonuçlar: plan / solved / invalid input / no constrained path.
content.md
Teori 756 Markdown belgesinde saklanır, alıştırmalar 336 yerelleştirilmiş senaryoda tanımlanır. Gradle çeviri yapısını ve 316 özgün çizime yapılan başvuruları doğrular. Grafikler Blender/Cycles ile hazırlanmıştır; Android motoru ayrı prosedürel geometri kullanır.
workflow.md
AGENTS.mdREADME.mdDepo, ajanlarla geliştirme için düzenlenmiştir: AGENTS.md hiyerarşisi sorumlulukları, mimari kısıtları ve doğrulama kapılarını belirler; README.md modül sözleşmelerini, KDoc API ve değişmezleri açıklar.
Mimari, tasarım ve yerelleştirme sözleşmeleri kodla birlikte sürümlenir. PLAN.md kapsamı ve devri kaydeder; sözleşme değişiklikleri ilgili sorumlu belgeleri günceller. Kontroller ve üretim Gradle üzerinden yürür; CI her iki mağaza varyantını derler.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTestler imkânsız küp durumlarını, çözülmüş katmanların korunmasını, öğrenme planlarını, eski isteklerin iptalini, oturumların geri yüklenmesini ve veri içe aktarmayı kapsar. CI her iki mağaza varyantını derler; sürüm kontrolleri R8, APK/AAB, sağlama toplamları ve yerel kütüphanelerin 16 KB sayfalar için hizalanmasını içerir.
Kotlin hacmi; yorumlar, boş satırlar, buildSrc ve benchmark kodu dahil, test dizinleri hariç fiziksel satırlarla sayılır. Test sayısı çalıştırmaları değil, 1 343 JVM bildirimi ve 281 Android bildirimini ifade eder. Belgeler yedek metni içerir; bir senaryonun bulunması her derste alıştırma olduğu anlamına gelmez.
baselineprofile · @TestToplam metin, takip edilen UTF-8 dosyalarındaki fiziksel satırları sayar: kaynaklar, testler, XML/JSON kaynakları, Markdown içeriği, yerelleştirme, belgeler, build araçları ve web kaynakları. Yorumlar, boş satırlar ve dil kopyaları dahildir. Medya, üretilen ve build çıktıları, üçüncü taraf kodu, hizmet yapılandırması ve geçici PLAN.md hariçtir. Bu, projenin metin girdilerinin hacmidir; çalıştırılabilir LOC değildir.