Pelaksanaan
Setiap putaran kiub bergantung pada sistem tersendiri: model matematik, enjin 3D dan penyelesai yang mengambil kira matlamat pelajaran. Aplikasi Android ditulis dengan Kotlin dan Jetpack Compose.
Petikan projek
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 dan Material 3 menentukan komponen dan tema antara muka. Adaptive mengurus susun atur mengikut saiz tetingkap, manakala Navigation 3 mengurus navigasi dan pemulihan skrin. Keadaan disampaikan melalui Coroutines dan Flow; Hilt menghubungkan modul aplikasi.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileAntara muka, kontrak domain dan data dipisahkan kepada modul tersendiri; Hilt menghubungkan pelaksanaannya. Compose menerima keadaan tidak berubah dan peristiwa eksplisit. Room menyimpan sejarah dan kemajuan pembelajaran, DataStore menyimpan tetapan, dan Navigation 3 memulihkan tindanan bahagian.
android-ux.md
Cubiq melaksanakan pendekatan yang diketengahkan oleh Google dalam Apps Experience Program: Compose, susun atur adaptif dan edge-to-edge.
engine.glsl
Shader GLSL mengira bahan PBR, kekasaran dan pencahayaan persekitaran. Model dan animasi selaras: mengundur satu langkah menerapkan gerakan songsang, dan kamera mengambil kira ruang antara panel.
Notasi berjenis ditukar menjadi gerakan dan keadaan kiub yang konsisten. Baris gilir renderer menganimasikan putaran lapisan sambil mengekalkan identiti bahagian dan facelet. Formula dimainkan sebagai urutan gerakan sebenar, dengan main, jeda dan pelarasan tempo.
Langkah ke hadapan menganimasikan gerakan baharu; langkah ke belakang menerapkan gerakan songsang. Lompat ke kedudukan memulihkan adegan asas dan urutan sasaran. Pembatalan menghentikan penghantaran gerakan seterusnya; putaran yang sudah bermula diselesaikan. Kitar hayat EGL mengendalikan pause/release; tanpa GL, laluan pembelajaran kekal tersedia tanpa 3D.
solver.kt
Penyelesai tersendiri menyusun penyelesaian daripada formula dan gerakan bantuan pelajaran semasa. SolverRequest merangkumi keadaan kiub, bahagian sasaran, sasaran terkunci, formula dibenarkan, kes dan orientasi. Perancang mengikut turutan matlamat pembelajaran dan melindungi bahagian yang selesai.
Perancangan setiap fasa menggunakan BFS terhad, beam search dan pengecaman kes F2L. Pengesahan menyemak komposisi bahagian, pembalikan, kilasan dan pariti permutasi. Dasar carian mengehadkan kedalaman dan lebar beam. Pertukaran pelajaran membatalkan carian dan mencegah hasil lapuk.
Hasilnya PracticePlan: langkah, rujukan formula, garis masa paparan dan garis masa pelaksanaan. Penjelasan mengekalkan orientasi pembelajaran; enjin menerima urutan pelaksanaan penuh. Hasil: plan / solved / invalid input / no constrained path.
content.md
Teori disimpan dalam 756 dokumen Markdown, dan latihan ditakrifkan dalam 336 senario yang disetempatkan. Gradle mengesahkan struktur terjemahan dan rujukan kepada 316 ilustrasi asli. Grafik disediakan dalam Blender/Cycles; enjin Android menggunakan geometri prosedural berasingan.
workflow.md
AGENTS.mdREADME.mdRepositori disusun untuk pembangunan dengan ejen: hierarki AGENTS.md menetapkan pemilikan, batasan seni bina dan gerbang pengesahan; README.md menerangkan kontrak modul, KDoc menerangkan API dan invarian.
Kontrak seni bina, reka bentuk dan penyetempatan dikawal versinya bersama kod. PLAN.md mencatat skop dan serahan; perubahan kontrak mengemas kini dokumentasi pemiliknya. Semakan dan penjanaan melalui Gradle; CI membina kedua-dua varian gedung.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationUjian merangkumi keadaan kiub yang mustahil, pengekalan lapisan yang selesai, pelan pembelajaran, pembatalan permintaan lapuk, pemulihan sesi dan import data. CI membina kedua-dua varian gedung; semakan keluaran merangkumi R8, APK/AAB, checksum dan penjajaran pustaka native untuk halaman 16 KB.
Jumlah Kotlin mengira baris fizikal, termasuk komen, baris kosong, buildSrc dan kod benchmark, tanpa direktori ujian. Bilangan ujian bermaksud 1 343 pengisytiharan JVM dan 281 pengisytiharan Android, bukan pelaksanaan ujian. Dokumen merangkumi teks sandaran; kewujudan senario tidak bermakna setiap pelajaran mempunyai latihan.
baselineprofile · @TestJumlah teks mengira baris fizikal dalam fail UTF-8 yang dijejaki: sumber, ujian, sumber XML/JSON, kandungan Markdown, penyetempatan, dokumentasi, alat build dan sumber web. Komen, baris kosong dan salinan bahasa disertakan. Media, keluaran terjana/build, kod vendor, konfigurasi perkhidmatan dan PLAN.md sementara dikecualikan. Ini isi padu input teks projek, bukan LOC yang boleh dilaksanakan.