Skip to content

imissmyselfer/idiom-junior-android

Repository files navigation

🏮 暑假成語大挑戰 (Idiom Junior Android)

License: MIT Platform: Android React: 18

一個專為兒童設計的成語學習 Android App,結合了錄音練習中英雙語介面每日挑戰。 A dedicated idiom learning Android app for children, featuring voice recording, bilingual UI, and daily challenges.


✨ 核心特色 (Core Features)

主畫面 挑戰模式

🏆 每日挑戰 (Daily Challenge)

  • 智能分配任務:每日自動挑選 5 個新成語 與 5 個複習成語,循序漸進。
  • Smart Task Allocation: Automatically selects 5 new idioms and 5 review idioms daily for a steady learning pace.
  • 成就系統:完成當日挑戰可獲得獎盃,追蹤學習總進度。
  • Achievement System: Earn trophies upon completing daily goals and track overall progress.

📖 智能標注與字典 (Smart Annotation & Library)

  • 多功能標註:隨時切換 注音 (Zhuyin)拼音 (Pinyin)隱藏標注
  • Multi-mode Annotation: Switch between Zhuyin, Pinyin, or hide annotations at any time.
  • 559 筆完整資料:涵蓋國小必備成語,支援成語、拼音或意思的即時搜尋。
  • Comprehensive Database: 559 essential idioms with instant search by name, pinyin, or definition.

🎙️ 互動練習與雙語介面 (Interactive Practice & Bilingual UI)

  • Bilingual Interface: Buttons and labels feature English subtitles (Listen, Record, Playback) to help young learners navigate easily.
  • 雙語友善介面:功能按鈕皆有中英文對照,讓不識字的孩子也能透過直覺操作。
  • 錄音與回放:孩子可以錄下發音並與範例對比。
  • Record & Playback: Children can record their own voice and compare it with the teacher's example.

🚀 快速開始 (Quick Start)

1. 環境需求 (Prerequisites)

  • Node.js (v18+)
  • Android Studio
  • Java SDK (v17+)
  • Python (v3.x for data conversion)

2. 安裝與編譯 (Install & Build)

# 安裝依賴 (Install dependencies)
npm install

# 編譯前端並同步 (Build & Sync)
npm run build
npx cap sync android

# 編譯 APK (Assemble APK)
cd android && ./gradlew assembleDebug

📊 數據處理 (Data Pipeline)

本專案使用自動化腳本處理資料,並為成語標題與意思生成注音標註: The project uses automated scripts to process data and generate annotations for both idiom titles and definitions:

# 建立虛擬環境並安裝工具 (Setup venv and install tools)
python3 -m venv venv
./venv/bin/pip install pypinyin

# 執行資料轉換 (Run conversion)
./venv/bin/python convert_data.py

📝 開源協議 (License)

本專案採用 MIT License。您可以自由地使用、修改與分發。 Distributed under the MIT License. Feel free to use, modify, and distribute.


👨‍💻 作者 (Author)

Erin - wcy203@gmail.com

About

暑假成語大挑戰 (Android App版本)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors