Skip to content

About

אפליקציית ניהול גרסה מתקדמת לנגן m36

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Kosher M36 Icon

מנהל נגן M36 כשר 📱

אפליקציית ניהול מתקדמת וייחודית לסיסטם של נגן אנדרואיד כשר (M36 / m36+)

אפליקציית ניהול והתאמה מתקדמת למערכת ההפעלה של נגני אנדרואיד כשרים (M36, m36+ ומכשירים מקבילים כמו m393). האפליקציה מאפשרת שליטה מדויקת, מאובטחת ומודולרית על רכיבי המערכת, תוך מעבר קל בין פרופילי כשרות - ניהול יכולות וידאו, התקנת חבילות ושירותי גוגל.


🌟 תכונות עיקריות

  • 🎨 אייקון ומיתוג ייעודי חדש: עיצוב מגן טיטניום מתקדם המשלב מפתח סול מוזיקלי, גלי תדר אקולייזר וחותם נעילת כשרות נקייה.

  • 🔒 אבטחה מוגברת וקוד גישה (Passcode Protection)

    • נעילת מסך ניהול הגרסאות באמצעות קוד סודי אישי.
    • אימות קוד חוזר בעת שמירת שינויים למניעת שינוי תצורה לא מורשה.
  • 🎛️ פרופילי כשרות מוגדרים מראש (Presets)

    • פרופיל 1 – מלא: כולל נגני וידאו ואפשרות להתקנת אפליקציות.
    • פרופיל 2 – וידאו ללא התקנות: צפייה בסרטונים בלבד, עם חסימה מוחלטת של התקנת קובצי APK חיצוניים.
    • פרופיל 3 – כשר מהודר: ללא וידאו וללא התקנות כלל (סגירה הרמטית).
    • התאמה אישית (Custom): שליטה פרטנית על כל רכיב ומודול מערכת בנפרד.
  • ⚙️ ניהול רכיבי מערכת (Root Level System Management)

    • חסימת/פתיחת התקנות: החלפת מנהל החבילות (GooglePackageInstaller) בין גרסה מאפשרת לגרסה חוסמת וניהול דגל installs_allowed.flag.
    • שליטה בווידאו: שינוי שמות קבצי מערכת (.apk ⇄ .apkr) עבור יישומי וידאו ב-/system/preinstall/ ו-FilesGoogle.
    • ניהול שירותי Google: הפעלה או נטרול של GmsCore.
  • 🧪 מצב סימולציה מובנה (Simulation Mode)

    • מאפשר בדיקה מלאה של כלל הממשק והפונקציות גם במכשירי פיתוח ללא Root או באמולטור, מבלי לסכן קובצי מערכת.
  • 🎨 ממשק משתמש מודרני בעברית (RTL)

    • נבנה ב-Jetpack Compose ו-Material Design 3.
    • תמיכה בערכת נושא בהירה, כהה או לפי הגדרות המערכת.
    • ממשק נוח, מותאם מסכי מגע קטנים וגדולים של נגנים.
  • 🌐 שרת ליווי מקוון (Web Companion)

    • שרת Node.js קל-משקל המשולב בפרויקט, מאפשר צפייה בסטטוס המערכת והורדה נוחה של קובצי ה-APK שקומפלו ישירות מהדפדפן.

📂 מיפוי קובצי מערכת (System Mapping)

האפליקציה מבצעת שינויים בקובצי המערכת הבאים (במכשיר בעל הרשאות Root):

רכיב נתיב מקור / פעיל נתיב מנוטרל תיאור
נגן וידאו 1 /system/preinstall/app5.apk /system/preinstall/app5.apkr אפליקציית וידאו
נגן וידאו 2 /system/preinstall/app4.apk /system/preinstall/app4.apkr אפליקציית וידאו
נגן וידאו 3 /system/preinstall/app2.apk /system/preinstall/app2.apkr אפליקציית מדיה
סייר קבצים /system/product/priv-app/FilesGoogle/FilesGoogle.apk .../FilesGoogle.apkr מנהל הקבצים של גוגל
Google Play Services /system/product/priv-app/GmsCore/GmsCore.apk .../GmsCore.apkr שירותי ליבה של גוגל
מתקין החבילות /system/priv-app/GooglePackageInstaller/GooglePackageInstaller.apk החלפה בין גרסאות מ-/system/apps/ מניעת/אישור התקנת APK
דגל התקנות /system/priv-app/GooglePackageInstaller/installs_allowed.flag מחיקה בעת חסימה אינדיקציית הרשאות

🛠️ דרישות סביבה וטכנולוגיות

  • מערכת הפעלה למכשיר היעד: Android 7.0 (API 24) ומעלה (מותאם במיוחד ל-Android 11-14 בנגני M36).
  • הרשאות: נדרש Root (su) עבור החלת שינויים בפועל (עבור בדיקות קיים מצב סימולציה).
  • Kotlin: 2.2+
  • Compose BOM: 2024.09+
  • Gradle: 9.3+ (Android Gradle Plugin 9.1+)
  • Java: JDK 21 (Eclipse Temurin / OpenJDK)
  • Node.js: 18+ (עבור שרת ההפצה והדשבורד)

🚀 הוראות בנייה והרצה (Build & Run)

1. שיבוט הפרויקט

git clone https://github.com/YSmauas/M36_kosher.git
cd M36_kosher

2. בניית קובצי APK באמצעות Gradle

ודא שמשתנה הסביבה JAVA_HOME מפנה ל-Java 21, והרץ:

  • בניית גרסת Debug:

    ./gradlew assembleDebug

    הקובץ ייווצר בנתיב: app/build/outputs/apk/debug/app-debug.apk

  • בניית גרסת Release:

    ./gradlew assembleRelease

    הקובץ ייווצר בנתיב: app/build/outputs/apk/release/app-release.apk

  • הרצת בדיקות יחידה:

    ./gradlew testDebugUnitTest

3. העתקת קובצי ה-APK לתיקיית הפלט והפעלת השרת המקומי

# העתקת ה-APKs לתיקיית build-outputs
node copy-apks.js

# הפעלת שרת הדשבורד המקומי
npm start

השרת יעלה בכתובת: http://localhost:3000 (או לפי הפורט המוגדר במשתנה PORT).


🤖 אוטומציה ו-CI/CD ב-GitHub Actions

הפרויקט כולל 2 תהליכי עבודה אוטומטיים מובנים:

  1. build.yml - בדיקות ובנייה רציפה (CI):

    • מופעל בכל push ו-pull_request.
    • בודק תקינות קוד ומריץ את כל בדיקות היחידה (testDebugUnitTest).
    • מקמפל את ה-APKs ומעלה אותם כ-Artifacts לבדיקה מהירה.
  2. release.yml - העלאה אוטומטית ל-GitHub Releases:

    • מופעל אוטומטית בעת דחיפת תגית גרסה (v*), דחיפה לענף הראשי, או הפעלה ידנית דרך GitHub Actions (Workflow Dispatch) עם אפשרות לבחירת מספר גרסה וכותרת שחרור.
    • בונה קובצי APK יציבים (Release ו-Debug) וקובץ AAB.
    • מייצר אוטומטית תיאור שחרור עשיר, מפורט ומעוצב בעברית ובאנגלית עם פירוט תכונות, הוראות התקנה בנגן, וגיבובי אימות SHA-256.
    • מעלה את כל הקבצים המוכנים ל-Release תחת כותרת מסודרת.

📄 רישיון ושימוש

הפרויקט מיועד למטרות לימודיות, תחזוקה והתאמת נגנים אישיים. כל שינוי בקובצי מערכת באחריות המשתמש בלבד. הפרויקט ברשיון MIT אפשר להעתיק, לערוך, ולפרסם עם קרדיט למקור.

About

אפליקציית ניהול גרסה מתקדמת לנגן m36

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages