実装
キューブの回転は、独自のシステムが支えています。数学モデル、3Dエンジン、レッスンの目標を考慮するソルバーで構成されています。AndroidアプリはKotlinとJetpack Composeで実装されています。
プロジェクトのスナップショット
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とMaterial 3がインターフェースのコンポーネントとテーマを定義します。Adaptiveはウィンドウサイズに応じたレイアウトを担います。Navigation 3はナビゲーションと画面の復元を扱います。状態はCoroutinesとFlowを通じて届き、Hiltがアプリのモジュールを接続します。
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileインターフェース、ドメインの契約、データを別々のモジュールに分け、Hiltで実装を接続します。Composeは不変の状態と明示的なイベントを受け取ります。Roomは履歴と学習の進捗、DataStoreは設定を保存します。Navigation 3は各セクションのスタックを復元します。
android-ux.md
Cubiqは、GoogleがApps Experience Programで取り上げるアプローチを実装しています。Compose、適応型レイアウト、edge-to-edgeです。
engine.glsl
GLSLシェーダーがPBRマテリアル、粗さ、環境光を計算します。モデルとアニメーションは連動しています。前のステップに戻ると逆の手を適用し、カメラはパネル間の空きスペースを考慮します。
型付き記法を回転操作と整合するキューブの状態に変換します。レンダラーのキューが層の回転をアニメーション化し、ピースとフェイスレットの同一性を保ちます。手順は実際の回転操作の列として再生され、再生、一時停止、速度調整を使えます。
次へ進むと新しい回転操作をアニメーション化し、戻ると逆の操作を適用します。シークは基本シーンと対象の操作列を復元します。キャンセルは次の操作の発行を止め、すでに始まった回転は完了します。EGLのライフサイクルはpause/releaseを扱います。GLが使えない場合も、3Dなしで学習を続けられます。
solver.kt
独自のソルバーが、現在のレッスンの手順と補助操作から解法を作ります。SolverRequestはキューブの状態、対象ピース、固定対象、許可された手順、ケース、向きを含みます。プランナーは学習目標の順序を守り、揃ったピースを保護します。
フェーズ別の計画では、上限付きBFS、ビームサーチ、F2Lのケース認識を使います。検証はピースの構成、反転、ねじれ、置換のパリティを確認します。探索方針は深さとビーム幅を制限します。レッスンの変更は探索をキャンセルし、古い結果を適用させません。
結果はPracticePlanです。ステップ、手順への参照、表示タイムライン、実行タイムラインを含みます。説明は学習用の向きを保ち、エンジンには完全な実行列を渡します。結果の種類はplan / solved / invalid input / no constrained pathです。
content.md
理論は756件のMarkdownドキュメントに保存され、練習は336件のローカライズされたシナリオで定義されています。Gradleが翻訳の構造と316点のオリジナルイラストへの参照を検証します。グラフィックはBlender/Cyclesで作成しています。Androidエンジンでは別の手続き的ジオメトリを使います。
workflow.md
AGENTS.mdREADME.mdリポジトリはエージェントによる開発に合わせて構成されています。AGENTS.mdの階層が担当範囲、アーキテクチャの制約、検証ゲートを定義します。README.mdはモジュールの契約、KDocはAPIと不変条件を記述します。
アーキテクチャ、デザイン、ローカライズの契約をコードとともにバージョン管理します。PLAN.mdは範囲と引き継ぎを記録します。契約の変更に合わせて、その管理元のドキュメントも更新します。検証と生成はGradleで実行し、CIは両ストア向けのバージョンをビルドします。
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationテストは、成立しないキューブの状態、揃った層の保持、学習プラン、古いリクエストのキャンセル、セッションの復元、データのインポートを対象とします。CIは両ストア向けのバージョンをビルドします。リリース時はR8、APK/AAB、チェックサム、16 KBページ向けのネイティブライブラリのアラインメントを検証します。
Kotlinの規模は物理行数で集計し、コメント、空行、buildSrc、ベンチマークコードを含め、テストディレクトリを除きます。テスト数はJVMの宣言1 343件とAndroidの宣言281件を指し、実行回数ではありません。ドキュメントにはフォールバック用のテキストを含みます。シナリオがあっても、すべてのレッスンに練習があるとは限りません。
baselineprofile · @Test総テキスト量は、追跡対象のUTF-8ファイルの物理行を数えます。ソース、テスト、XML/JSONリソース、Markdownコンテンツ、ローカライズ、ドキュメント、ビルドツール、Webソースが対象です。コメント、空行、各言語のコピーを含みます。メディア、生成物とビルド出力、外部提供コード、サービス設定、一時的なPLAN.mdを除きます。プロジェクトのテキスト入力の規模であり、実行可能なLOCではありません。