เว็บไซต์อย่างเป็นทางการพร้อมเครื่องจำลองและสนามเด็กเล่น: https://matebuddy.github.io/mathebuddy/
โครงการนี้ได้รับทุนจาก "Freiraum 2022" (Stiftung Innovation ใน Der Hochschullehre) ประเทศเยอรมนี
หากคุณต้องการใช้สนามเด็กเล่นหรือทดสอบตัวจำลองด้วยตัวอย่างไฟล์ไม่จำเป็นต้องติดตั้งอะไรเลย เพียงไปที่ https://mathebuddy.github.io/mathebuddy/
หากคุณต้องการสร้างและทดสอบหลักสูตรของคุณเองเยี่ยมชมเว็บไซต์มุ่งหน้าไปยัง simulator และคลิกที่ปุ่ม http://localhost:8271 จากนั้นทำตามคำแนะนำที่ระบุไว้
ที่เก็บนี้ใช้ส่วนประกอบทั้งหมดของแอพ matheBuddy

| เส้นทาง | คำอธิบาย |
|---|---|
| .vscode/ | การตั้งค่าโครงการ Visual Code |
| แอป/ | การใช้งานแอพด้วย Flutter |
| ถัง/ | สคริปต์ |
| เอกสาร/ | เว็บไซต์: https://mathebuddy.github.io/mathebuddy/ |
| เอกสาร/เอกสาร/ | เอกสารของ SMPL, MBL, MBCL |
| ext/ | ส่วนประกอบภายนอก |
| IMG/ | ไฟล์ภาพต้นฉบับ |
| lib/ | การใช้งานส่วนประกอบ (Math-Runtime, ... ) |
| cmd.sh | สคริปต์การบริหารสำหรับนักพัฒนา |
| web.sh | เริ่มต้นเว็บเซิร์ฟเวอร์ในพื้นที่ |
| mathebuddy.code-workspace | พื้นที่ทำงานสำหรับ vscode |
มุ่งหน้าไปที่ไฟล์ README.md ในไดเรกทอรีย่อยสำหรับข้อมูลเพิ่มเติม
ระบบปฏิบัติการอื่น ๆ นอกเหนือจาก Debian และ MacOS ยังไม่ได้รับการสนับสนุน มีเพียง MacOS เท่านั้นที่อนุญาตให้สร้างแอพเวอร์ชัน iOS
สำคัญ: หากคุณต้องการเรียกใช้เว็บเซิร์ฟเวอร์ในเครื่องเท่านั้น (รวมถึงสนามเด็กเล่นทั้งหมดและเครื่องจำลอง) คุณจะต้องติดตั้ง Python 3 พื้นที่เก็บข้อมูลให้ไลบรารีที่สร้างขึ้นในปัจจุบันใน docs/ ไดเรกทอรี
หมายเหตุ: Android และ Xcode สามารถข้ามได้หากคุณต้องการรวบรวมและเรียกใช้ MatheBuddy Simulator เท่านั้น pandoc สามารถข้ามได้หากคุณไม่ได้ตั้งใจจะสร้างคู่มือ
Linux จาก Debian (เช่น Ubuntu)
sudo apt install python3 snapd pandoc
sudo snap install flutter --classic
แม็กอส
ก่อนอื่นติดตั้ง Brew Package Manager
brew install git python3 flutter pandoc
จากนั้นเรียกใช้ flutter doctor ในหน้าต่างเทอร์มินัลและติดตั้งการอ้างอิงที่ระบุไว้ทั้งหมด
แม็กอส
ติดตั้ง 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 Runtime ให้ Run 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
ตอนนี้คุณต้องโคลนที่เก็บ คณิตศาสตร์ ต่อไปนี้ แทนที่ 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 ดู https://docs.github.com/en/authentication/connecting-to-github-with-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 ของ Symbol Div ด้านซ้าย พิมพ์ @recommended ในช่องค้นหา จากนั้นคลิกที่ Install ในแต่ละส่วนขยายที่ยังไม่ได้ติดตั้ง
(TODO: ส่วนนี้จะขยายออกเร็ว ๆ นี้ ... )
https://github.com/mathebuddy/mathebuddy
แอพ iOS และ Android (นำไปใช้กับ Flutter)
https://github.com/mathebuddy/mathebuddy-public-courses
หลักสูตรคณิตศาสตร์ฟรีและโอเพ่นซอร์ส