mathebuddy
0.5.0
Offizielle Website mit Simulator und Spielplätzen: https://mathebuddy.github.io/mathebuddy/
Dieses Projekt wird von "Freiium 2022" (Stiftung Innovation in Der Hochschullehre), Deutschland, finanziert.
Wenn Sie nur Spielplätze verwenden oder den Simulator mit Beispieldateien testen möchten, müssen Sie nichts installieren. Besuchen Sie einfach https://mathebuddy.github.io/mathebuddy/
Wenn Sie Ihre eigenen Kurse erstellen und testen möchten, besuchen Sie die Website, besuchen Sie simulator und klicken Sie auf die Schaltfläche http://localhost:8271 . Befolgen Sie dann den aufgeführten Anweisungen.
Dieses Repository implementiert alle Komponenten der matheBuddy -App.
| Weg | Beschreibung |
|---|---|
| .VSCODE/ | Einstellungen für visuelle Codeprojekte |
| App/ | Implementierung der App mit Flattern |
| Mülleimer/ | Skripte |
| docs/ | Website: https://mathebuddy.github.io/mathebuddy/ |
| docs/doc/ | Dokumentation von SMPL, MBL, MBCL |
| ext/ | Externe Komponenten |
| IMG/ | Originalbilddateien |
| lib/ | Implementierung von Komponenten (Mathematik-Runtime, ...) |
| cmd.sh | Verwaltungsskript für Entwickler |
| web.sh | Startet den Webserver lokal |
| mathebuddy.code-workspace | Arbeitsbereich für VSCODE |
Weitere Informationen finden Sie in den README.md -Dateien in den Unterverzeichnissen.
Andere Betriebssysteme als Debian und MacOS werden noch nicht unterstützt. Nur MacOS ermöglicht es, eine iOS -Version der App zu erstellen.
docs/ : Wenn Sie den Webserver nur lokal ausführen möchten (einschließlich aller Spielplätze und Simulator), müssen Sie nur Python installieren.
Hinweis: Android und Xcode können übersprungen werden, wenn Sie MatheBuddy Simulator nur kompilieren und ausführen möchten. pandoc kann übersprungen werden, wenn Sie nicht beabsichtigen, die Handbücher zu erstellen.
Debian -basierte Linux (zB Ubuntu)
sudo apt install python3 snapd pandoc
sudo snap install flutter --classic
macos
Installieren Sie zuerst den Brean Package Manager.
brew install git python3 flutter pandoc
Führen Sie dann flutter doctor in einem Terminalfenster aus und installieren Sie alle aufgeführten Abhängigkeiten.
macos
Installieren Sie Xcode im App Store und starten Sie die Anwendung, um die Installation abzuschließen. Führen Sie dann die folgenden Befehle von einem Terminal aus.
xcode-select --install
sudo gem install cocoapods
brew install --cask android-studio
brew install bundletool
Führen Sie die Anwendung Android Studio.app aus, stimmen Sie den Lizenzen zu und schließen Sie das Setup ab. Wählen Sie in Android Studio -Einstellungen Appearance & Behavior , System Settings , Android SDK und wählen Sie in der Registerkarte [SDK Platforms] (z. B.) Android 13 . Wählen Sie dann in der Registerkarte [SDK Tools] Android SDK Command-line Tools (latest) aus. Klicken Sie auf die Schaltfläche Accept , um die Installation zu starten.
Führen Sie in einem Terminal flutter doctor --android-licenses und nehmen Sie jede Lizenz mit y an. Dann führen Sie flutter doctor erneut aus, um die Installation zu überprüfen.
Für den Fall, dass Sie keine Java -Laufzeit haben, rennen Sie brew install openjdk um es zu installieren. Homebrew gibt aus, dass Sie echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc ausführen müssen. Mach es!
In einem kürzlichen Fehler (Flutter/Flutter#118502) kann Java -Fehler auflisten. Führen Sie die folgenden (hässlich!) Fix aus:
cd /Applications/Android Studio.app/Contents
cp -r jbr jre
Sie müssen jetzt die folgenden Mathebuddy -Repositorys klonen. Ersetzen Sie YOUR_FAVORITE_DIRECTORY durch ein lokales Verzeichnis auf Ihrer Festplatte.
Tipp: Verwenden Sie den GitHub -Desktop, um die Repositorys zu klonen (siehe Ende dieses Dokuments).
cd YOUR_FAVORITE_DIRECTORY
git clone https://github.com/mathebuddy/mathebuddy.git
git clone https://github.com/mathebuddy/mathebuddy-public-courses.git
Entwickler des Kernteams sollten ein SSH -Schlüsselpaar verwenden. siehe https://docs.github.com/en/authentication/connecting-to-github-with-ssh; und klonen auch das private Repository:
cd YOUR_FAVORITE_DIRECTORY
git clone [email protected]:mathebuddy/mathebuddy.git
git clone [email protected]:mathebuddy/mathebuddy-public-courses.git
git clone [email protected]:mathebuddy/mathebuddy-private-courses.git
Warnung: Niemals (!!) Klon zu icloud / googledrive / oneedrive / Nextcloud / Sciebo / ...!
Führen Sie die folgenden Befehle aus:
cd YOUR_FAVORITE_DIRECTORY/mathebuddy/docs
python3 -m http.server 8314
Öffnen Sie http://localhost:8314/ in Ihrem Lieblingsbrowser. Sie können einen anderen Port als 8314 wählen.
Alternativ können Sie auch Skript ./web.sh (oder das Administrator -Tool ./cmd.sh ) im Stammverzeichnis des Repositorys verwenden.
cd YOUR_FAVORITE_DIRECTORY/mathebuddy
./web.sh
Wir verwenden VSCODE zum Bearbeiten von Quellcode. Stellen Sie sicher, dass Sie alle empfohlenen Erweiterungen installieren: Öffnen Sie das mathebuddy -Repository in VSCODE und klicken Sie dann auf Extensions auf der linken Symbol Div. Geben Sie @recommended im Suchfeld ein. Klicken Sie dann auf jede Erweiterung, die noch nicht installiert ist, auf die Install .
(TODO: Dieser Abschnitt wird bald verlängert ...)
https://github.com/mathebuddy/mathebuddy
iOS- und Android -App (implementiert mit Flutter)
https://github.com/mathebuddy/mathebuddy-public-courses
Kostenlose und Open -Source -Mathematikkurse
