Implementering
Varje vridning av kuben bygger på ett eget system: en matematisk modell, en 3D-motor och en lösare som tar hänsyn till lektionens mål. Android-appen använder Kotlin och Jetpack Compose.
Projektögonblicksbild
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 och Material 3 bestämmer gränssnittets komponenter och teman. Adaptive hanterar layout efter fönsterstorlek och Navigation 3 navigation och skärmåterställning. Tillståndet kommer via Coroutines och Flow; Hilt kopplar ihop appmodulerna.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileGränssnitt, domänkontrakt och data ligger i separata moduler; Hilt kopplar ihop implementationerna. Compose får oföränderligt tillstånd och uttryckliga händelser. Room lagrar historik och inlärningsframsteg, DataStore inställningar, och Navigation 3 återställer avsnittens stackar.
android-ux.md
Cubiq använder arbetssätt som Google lyfter fram i Apps Experience Program: Compose, adaptiv layout och edge-to-edge.
engine.glsl
GLSL-shaders beräknar PBR-material, råhet och omgivningsbelysning. Modell och animation är samordnade: ett steg tillbaka utför det omvända draget, och kameran tar hänsyn till utrymmet mellan panelerna.
Typad notation omvandlas till drag och samordnade kubtillstånd. Rendererkön animerar lagervridningar och bevarar identiteten hos delar och facelets. Formeln spelas som en följd av riktiga drag, med uppspelning, paus och tempojustering.
Ett steg framåt animerar ett nytt drag; ett steg bakåt tillämpar det omvända draget. Ett positionshopp återställer grundscenen och målsekvensen. Avbrytning stoppar fler drag från att skickas; en påbörjad vridning slutförs. EGL-livscykeln hanterar pause/release; utan GL finns lärvägen kvar utan 3D.
solver.kt
Den egna lösaren bygger en lösning av den aktuella lektionens formler och hjälpdrag. SolverRequest innehåller kubtillstånd, måldelar, låsta mål, tillåtna formler, fall och orientering. Planeraren följer lärmålens ordning och skyddar lösta delar.
Fasspecifik planering använder begränsad BFS, strålsökning och identifiering av F2L-fall. Validering kontrollerar delarnas sammansättning, vändningar, vridningar och permutationsparitet. Sökpolicyn begränsar djup och strålbredd. Lektionsbyte avbryter sökningen och hindrar ett inaktuellt resultat.
Resultatet är PracticePlan: steg, formelreferenser, en visningstidslinje och en exekveringstidslinje. Förklaringen bevarar lärorienteringen; motorn får hela exekveringssekvensen. Utfall: plan / solved / invalid input / no constrained path.
content.md
Teorin finns i 756 Markdown-dokument och övningarna definieras i 336 lokaliserade scenarier. Gradle kontrollerar översättningsstrukturen och hänvisningar till 316 egna illustrationer. Grafiken förbereddes i Blender/Cycles; Android-motorn använder separat procedurell geometri.
workflow.md
AGENTS.mdREADME.mdKodförrådet är organiserat för utveckling med agenter: AGENTS.md-hierarkin anger ansvar, arkitekturbegränsningar och valideringskontroller; README.md beskriver modulkontrakt, KDoc API och invarianter.
Arkitektur-, design- och lokaliseringskontrakt versionshanteras tillsammans med koden. PLAN.md dokumenterar omfattning och överlämning; kontraktsändringar uppdaterar ansvarig dokumentation. Kontroller och generering sker via Gradle; CI bygger båda butiksvarianterna.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTesterna omfattar omöjliga kubtillstånd, bevarande av lösta lager, inlärningsplaner, avbrutna inaktuella förfrågningar, sessionsåterställning och dataimport. CI bygger båda butiksvarianterna; versionskontroller omfattar R8, APK/AAB, kontrollsummor och justering av native-bibliotek för sidor på 16 KB.
Kotlin-omfånget räknar fysiska rader, inklusive kommentarer, tomma rader, buildSrc och benchmarkkod, utan testkataloger. Testantalet betyder 1 343 JVM-deklarationer och 281 Android-deklarationer, inte körningar. Dokumenten innehåller reservtext; ett scenario innebär inte att varje lektion har en övning.
baselineprofile · @TestDen totala texten räknar fysiska rader i versionshanterade UTF-8-filer: källkod, tester, XML/JSON-resurser, Markdown-innehåll, lokalisering, dokumentation, byggverktyg och webbkällor. Kommentarer, tomma rader och språkkopior ingår. Media, genererade och byggda utdata, tredjepartskod, tjänstekonfiguration och tillfällig PLAN.md undantas. Detta mäter projektets textindata, inte körbara LOC.