Implementering
Hver drejning af terningen bygger på et eget system: en matematisk model, en 3D-motor og en løser, der tager hensyn til lektionens mål. Android-appen bruger Kotlin og Jetpack Compose.
Projektøjebliksbillede
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 og Material 3 definerer brugerfladens komponenter og temaer. Adaptive håndterer layout efter vinduesstørrelse, og Navigation 3 håndterer navigation og gendannelse af skærme. Tilstanden kommer via Coroutines og Flow; Hilt forbinder appmodulerne.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileBrugerflade, domænekontrakter og data ligger i separate moduler; Hilt forbinder implementeringerne. Compose modtager uforanderlig tilstand og eksplicitte hændelser. Room gemmer historik og læringsfremskridt, DataStore indstillinger, og Navigation 3 gendanner sektionernes stakke.
android-ux.md
Cubiq bruger tilgange, som Google fremhæver i Apps Experience Program: Compose, adaptivt layout og edge-to-edge.
engine.glsl
GLSL-shadere beregner PBR-materialer, ruhed og omgivelsesbelysning. Model og animation er synkroniseret: et skridt tilbage udfører det omvendte træk, og kameraet tager hensyn til pladsen mellem panelerne.
Typet notation omdannes til træk og sammenhængende terningtilstande. Rendererens kø animerer lagdrejninger og bevarer identiteten af dele og facelets. Formlen afspilles som en sekvens af virkelige træk med afspilning, pause og tempojustering.
Et skridt frem animerer et nyt træk; et skridt tilbage anvender det omvendte træk. Spring til en position gendanner basisscenen og målsekvensen. Annullering stopper udsendelsen af flere træk; en påbegyndt drejning fuldføres. EGL-livscyklussen håndterer pause/release; uden GL forbliver læringsforløbet tilgængeligt uden 3D.
solver.kt
Den egenudviklede løser bygger en løsning af den aktuelle lektions formler og hjælpetræk. SolverRequest indeholder terningtilstand, måldele, låste mål, tilladte formler, tilfælde og orientering. Planlæggeren følger læringsmålenes rækkefølge og beskytter løste dele.
Fasespecifik planlægning bruger begrænset BFS, strålesøgning og genkendelse af F2L-tilfælde. Validering kontrollerer delenes sammensætning, vendinger, drejninger og permutationsparitet. Søgepolitikken begrænser dybde og strålebredde. Lektionsskift annullerer søgningen og forhindrer et forældet resultat.
Resultatet er PracticePlan: trin, formelreferencer, en visningstidslinje og en udførelsestidslinje. Forklaringen bevarer læringsorienteringen; motoren modtager hele udførelsessekvensen. Udfald: plan / solved / invalid input / no constrained path.
content.md
Teorien ligger i 756 Markdown-dokumenter, og øvelserne er defineret i 336 lokaliserede scenarier. Gradle kontrollerer oversættelsernes struktur og henvisninger til 316 originale illustrationer. Grafikken blev forberedt i Blender/Cycles; Android-motoren bruger separat procedurel geometri.
workflow.md
AGENTS.mdREADME.mdRepositoryet er organiseret til udvikling med agenter: AGENTS.md-hierarkiet angiver ansvar, arkitekturbegrænsninger og valideringskontroller; README.md beskriver modulkontrakter, KDoc API og invarianter.
Arkitektur-, design- og lokaliseringskontrakter versionsstyres sammen med koden. PLAN.md registrerer omfang og overdragelse; kontraktændringer opdaterer den ansvarlige dokumentation. Kontroller og generering går gennem Gradle; CI bygger begge butiksvarianter.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTests dækker umulige terningtilstande, bevarelse af løste lag, læringsplaner, annullering af forældede anmodninger, gendannelse af sessioner og dataimport. CI bygger begge butiksvarianter; udgivelseskontroller omfatter R8, APK/AAB, kontrolsummer og justering af native-biblioteker til sider på 16 KB.
Kotlin-omfanget tæller fysiske linjer, inklusive kommentarer, tomme linjer, buildSrc og benchmarkkode, uden testmapper. Testantallet betyder 1 343 JVM-deklarationer og 281 Android-deklarationer, ikke kørsler. Dokumenterne inkluderer reservetekst; et scenarie betyder ikke, at hver lektion har en øvelse.
baselineprofile · @TestDen samlede tekst tæller fysiske linjer i versionsstyrede UTF-8-filer: kildekode, tests, XML/JSON-ressourcer, Markdown-indhold, lokalisering, dokumentation, buildværktøjer og webkilder. Kommentarer, tomme linjer og sprogkopier er med. Medier, genererede og buildoutput, tredjepartskode, tjenestekonfiguration og midlertidig PLAN.md er udeladt. Dette måler projektets tekstinput, ikke eksekverbare LOC.