Implementasyon
Bawat ikot ng cube ay umaasa sa sariling sistema: isang modelong matematikal, 3D engine, at solver na isinasaalang-alang ang mga layunin ng aralin. Gumagamit ng Kotlin at Jetpack Compose ang Android app.
Snapshot ng proyekto
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 |
Itinatakda ng Jetpack Compose at Material 3 ang mga component at tema ng interface. Inaayos ng Adaptive ang layout ayon sa laki ng window, at pinangangasiwaan ng Navigation 3 ang navigation at pagpapanumbalik ng mga screen. Dumarating ang estado sa pamamagitan ng Coroutines at Flow; ikinokonekta ng Hilt ang mga modyul ng app.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileMagkakahiwalay na modyul ang interface, mga domain contract, at data; ikinokonekta ng Hilt ang mga implementasyon. Tumatanggap ang Compose ng hindi nababagong estado at mga tahasang event. Iniimbak ng Room ang kasaysayan at progreso, ng DataStore ang mga setting, at ibinabalik ng Navigation 3 ang mga stack ng seksiyon.
android-ux.md
Gumagamit ang Cubiq ng mga paraang binibigyang-diin ng Google sa Apps Experience Program: Compose, adaptive na layout, at edge-to-edge.
engine.glsl
Kinakalkula ng mga GLSL shader ang mga PBR material, gaspang, at ilaw mula sa kapaligiran. Magkatugma ang modelo at animation: inilalapat ang kabaligtarang galaw kapag umaatras ng isang hakbang, at isinasaalang-alang ng camera ang espasyo sa pagitan ng mga panel.
Ginagawang mga galaw at magkakatugmang estado ng cube ang typed notation. Ina-animate ng renderer queue ang mga ikot ng layer habang pinapanatili ang identidad ng mga piraso at facelet. Pinapatakbo ang formula bilang sunod-sunod na tunay na galaw, na may play, pause, at pagsasaayos ng tempo.
Nag-a-animate ng bagong galaw ang pag-abante; inilalapat ang kabaligtarang galaw sa pag-atras. Ibinabalik ng pagtalon sa posisyon ang base scene at target na pagkakasunod-sunod. Pinatitigil ng pagkansela ang pagpapadala ng susunod na galaw; natatapos ang ikot na nagsimula na. Pinangangasiwaan ng EGL lifecycle ang pause/release; kung walang GL, magagamit pa rin ang pag-aaral nang walang 3D.
solver.kt
Bumubuo ang sariling solver ng solusyon mula sa mga formula at pantulong na galaw ng kasalukuyang aralin. Kasama sa SolverRequest ang estado ng cube, target na piraso, naka-lock na target, pinapayagang formula, mga case, at oryentasyon. Sinusunod ng planner ang pagkakasunod-sunod ng mga layunin at pinoprotektahan ang mga pirasong nalutas na.
Gumagamit ang pagpaplano ayon sa phase ng bounded BFS, beam search, at pagkilala sa mga F2L case. Sinusuri ng validation ang komposisyon ng mga piraso, flips, twists, at permutation parity. Nililimitahan ng search policy ang depth at beam width. Kinakansela ng pagpapalit ng aralin ang paghahanap at hinahadlangan ang lumang resulta.
PracticePlan ang resulta: mga hakbang, formula reference, display timeline, at execution timeline. Pinapanatili ng paliwanag ang oryentasyon sa pag-aaral; natatanggap ng engine ang buong pagkakasunod-sunod ng execution. Mga kinalabasan: plan / solved / invalid input / no constrained path.
content.md
Nakaimbak ang teorya sa 756 dokumentong Markdown, at nakatakda ang pagsasanay sa 336 senaryong isinalin sa iba't ibang wika. Sinusuri ng Gradle ang istruktura ng mga salin at mga sanggunian sa 316 orihinal na ilustrasyon. Inihanda ang graphics sa Blender/Cycles; gumagamit ang Android engine ng hiwalay na procedural geometry.
workflow.md
AGENTS.mdREADME.mdNakaayos ang repository para sa pagde-develop gamit ang mga agent: itinatakda ng hierarchy ng AGENTS.md ang mga responsibilidad, limitasyon sa architecture, at validation gate; inilalarawan ng README.md ang mga kontrata ng modyul, ng KDoc ang API at mga invariant.
Naka-version kasama ng code ang mga kontrata ng architecture, design, at localization. Itinatala ng PLAN.md ang saklaw at handoff; ina-update ng pagbabago sa kontrata ang dokumentasyon ng may-ari nito. Dumadaan sa Gradle ang mga check at generation; binu-build ng CI ang parehong store variant.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationSaklaw ng mga test ang imposibleng estado ng cube, pagpapanatili ng mga nalutas na layer, mga plano sa pag-aaral, pagkansela ng mga lumang request, pagpapanumbalik ng session, at pag-import ng data. Binu-build ng CI ang parehong store variant; kasama sa pagsusuri ng release ang R8, APK/AAB, checksum, at pag-align ng mga native library para sa 16 KB na page.
Binibilang ang Kotlin sa pisikal na linya, kasama ang mga komento, blankong linya, buildSrc, at benchmark code, maliban sa mga direktoryo ng test. Ang bilang ng test ay 1 343 deklarasyon sa JVM at 281 deklarasyon sa Android, hindi dami ng pagpapatakbo. Kasama sa mga dokumento ang fallback text; hindi nangangahulugang may pagsasanay sa bawat aralin ang pagkakaroon ng senaryo.
baselineprofile · @TestBinibilang ng kabuuang teksto ang pisikal na linya sa sinusubaybayang UTF-8 na file: source, test, XML/JSON resource, Markdown content, localization, dokumentasyon, build tooling, at web source. Kasama ang mga komento, blankong linya, at kopya ng mga wika. Hindi kasama ang media, generated/build output, vendor code, service config, at pansamantalang PLAN.md. Sukat ito ng mga text input ng proyekto, hindi executable LOC.