mathebuddy

Матебудди

Официальный веб -сайт с симулятором и игровыми площадками: https://mathebuddy.github.io/mathebuddy/

Финансирование

Этот проект финансируется «Freiraum 2022» (Stiftung Innovation в Der Hochschullehre), Германия.

Информация пользователей и создателей контента

• Если вам нравится использовать игровые площадки или тестировать симулятор с помощью примеров файлов, нет необходимости что -либо устанавливать. Просто посетите https://mathebuddy.github.io/mathebuddy/

• Если вы хотите создавать и проверять свои собственные курсы, посетите веб -сайт, отправляйтесь в simulator и нажмите кнопку http://localhost:8271 . Затем следуйте указанным инструкциям.

Информация о разработчиках

Этот репозиторий реализует все компоненты приложения matheBuddy .

Структура файла

Путь	Описание
.VSCODE/	Настройки проекта визуального кода
приложение/	Внедрение приложения с помощью Flutter
бин/	Сценарии
Документы/	Веб -сайт: https://mathebuddy.github.io/mathebuddy/
Документы/Док/	Документация SMPL, MBL, MBCL
ext/	Внешние компоненты
IMG/	Исходные файлы изображений
Либ/	Внедрение компонентов (математика, ...)
cmd.sh	Административный скрипт для разработчиков
web.sh	Запускает веб -сервер локально
mathebuddy.codeworkspace	Рабочая область для VSCODE

Перейдите к файлам README.md в подкаталогах для получения дополнительной информации.

Установка

Другие операционные системы, чем Debian и MacOS, еще не поддерживаются. Только macOS позволяет создавать версию приложения iOS.

Зависимости

Важно: если вам нравится запускать веб-сервер локально (включая все игровые площадки и симулятор), вам нужно только установить Python 3. Репозиторий обеспечивает актуальные библиотеки в docs/ каталоге.

Примечание: Android и Xcode можно пропустить, если вам нравится только компилировать и запустить MatheBuddy Simulator. pandoc можно пропустить, если вы не собираетесь строить руководства.

• Debian на базе Linux (например, Ubuntu)

   sudo apt install python3 snapd pandoc
  sudo snap install flutter --classic
  

• macOS

  Сначала установите диспетчер пакетов Brew.

   brew install git python3 flutter pandoc
  

Затем запустите flutter doctor в окне терминала и установите все перечисленные зависимости.

• macOS

  Установите Xcode из App Store и запустите приложение для завершения установки. Затем запустите следующие команды из терминала.

   xcode-select --install
  sudo gem install cocoapods
  brew install --cask android-studio
  brew install bundletool
  

  Запустите приложение Android Studio.app , согласен с лицензиями и заполните установку. В настройках Android Studio выберите Appearance & Behavior , System Settings , Android SDK и выберите в TAB [SDK Platforms] (например, Android 13 . Затем выберите вкладку [SDK Tools] Android SDK Command-line Tools (latest) . Нажмите кнопку Accept , чтобы запустить установку.

  В терминале запустите flutter doctor --android-licenses и принимайте каждую лицензию с y Затем запустите flutter doctor снова, чтобы проверить установку.

  Если у вас нет времени выполнения Java, запустите brew install openjdk чтобы установить его. Homebrew выведет, что вы должны запустить echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc . Сделай это!

  Недавняя ошибка (Flutter/Flutter#118502) может перечислять ошибки Java. Запустите следующее (уродливое!) Исправление:

   cd /Applications/Android Studio.app/Contents
  cp -r jbr jre
  

Получить Матебудди

Теперь вам нужно клонировать следующие хранилища Mathebuddy . Замените YOUR_FAVORITE_DIRECTORY локальным каталогом на своем диске.

Совет: используйте настольный компьютер GitHub, чтобы клонировать репозитории (см. Конец этого документа).

 cd YOUR_FAVORITE_DIRECTORY
git clone https://github.com/mathebuddy/mathebuddy.git
git clone https://github.com/mathebuddy/mathebuddy-public-courses.git

Разработчики основной команды должны использовать пару клавиш SSH; См. а также клонировать частный репозиторий:

 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

Предупреждение: никогда (!!) клон в iCloud / Googledrive / OneDrive / NextCloud / Sciebo / ...!

Запуск сайта локально

Запустите следующие команды:

 cd YOUR_FAVORITE_DIRECTORY/mathebuddy/docs
python3 -m http.server 8314

Откройте http://localhost:8314/ в вашем любимом браузере. Вы можете выбрать какой -то другой порт, чем 8314 .

В качестве альтернативы, вы также можете использовать скрипт ./web.sh (или инструмент администратора ./cmd.sh ) в корневом каталоге репозитория.

 cd YOUR_FAVORITE_DIRECTORY/mathebuddy
./web.sh

Строить

Мы используем VSCODE для редактирования исходного кода. Убедитесь, что вы установили все рекомендуемые расширения: откройте хранилище mathebuddy в VSCODE, затем нажмите на Extensions на левом символе Div. Введите @recommended в поле поиска. Затем нажмите Install на каждом расширении, которое еще не установлено.

(Тодо: этот раздел скоро будет расширен ...)

Список репозитория

• https://github.com/mathebuddy/mathebuddy

  Приложение для iOS и Android (реализовано с Flutter)

• https://github.com/mathebuddy/mathebuddy-public-courses

  БЕСПЛАТНЫЕ И МАТАЦИИ