|
| 1 | +# Overlay Manager — Android |
| 2 | + |
| 3 | +גרסת אנדרואיד לתוכנת ה-Windows המקורית. שכבות תמונה צפות (כולל GIF מונפש) מעל |
| 4 | +כל שאר האפליקציות, עם עוגן+אחוזים למיקום, שקיפות, טינט, נעילה ל-click-through, |
| 5 | +ושירות רקע קבוע עם התראה לניהול מהיר. |
| 6 | + |
| 7 | +## תאימות גרסאות |
| 8 | +האפליקציה תומכת כעת מ-**Android 4.4 (KitKat, API 19) ומעלה** — כלומר כמעט כל |
| 9 | +מכשיר אנדרואיד קיים. הדברים הבאים משתנים אוטומטית לפי גרסת המכשיר: |
| 10 | + |
| 11 | +| תכונה | API 19-22 | API 23-25 | API 26-27 | API 28+ | |
| 12 | +|---|---|---|---|---| |
| 13 | +| הרשאת overlay | ניתנת אוטומטית בהתקנה | אישור ידני בהגדרות | אישור ידני בהגדרות | אישור ידני בהגדרות | |
| 14 | +| סוג חלון | TYPE_PHONE | TYPE_PHONE | TYPE_APPLICATION_OVERLAY | TYPE_APPLICATION_OVERLAY | |
| 15 | +| GIF מונפש | ✅ (Movie API ידני) | ✅ (Movie API ידני) | ✅ (Movie API ידני) | ✅ (AnimatedImageDrawable) | |
| 16 | +| טינט צבע על GIF | ❌ לא נתמך | ❌ לא נתמך | ❌ לא נתמך | ✅ | |
| 17 | +| שירות רקע | startService רגיל | startService רגיל | startForegroundService | startForegroundService + סוג שירות | |
| 18 | + |
| 19 | +**הערה:** תמונות סטטיות (לא GIF) מקבלות תמיכה מלאה בטינט צבע בכל הגרסאות. |
| 20 | +המגבלה על טינט נוגעת רק ל-GIF מונפש בגרסאות ישנות מ-Android 9, כי ה-API הישן |
| 21 | +(`android.graphics.Movie`) לא מאפשר להחיל ColorFilter על הציור בצורה נקייה. |
| 22 | + |
| 23 | + |
| 24 | +- אין "tray icon" — יש התראה קבועה (foreground service notification) עם כפתורי |
| 25 | + "הצג/הסתר הכל" ו"כבה". |
| 26 | +- אין Ctrl+Alt+H גלובלי — הפעולה המקבילה זמינה מתוך ההתראה. |
| 27 | +- הרשאת "הצגה מעל אפליקציות אחרות" (SYSTEM_ALERT_WINDOW) חייבת אישור ידני של |
| 28 | + המשתמש בהגדרות המערכת — אנדרואיד לא מאפשרת לתת אותה אוטומטית. |
| 29 | +- click-through מוגבל יותר: כשהשכבה "נעולה" היא לא תופסת מגע כלל (FLAG_NOT_TOUCHABLE), |
| 30 | + בדיוק כמו במקור, אבל כשהיא "פתוחה" לעריכה היא תופסת מגע (לצורך גרירה עתידית). |
| 31 | +- תמיכה במסכים מרובים לא מומשה בגרסה הזו (Android תומך בזה טכנית, אבל זה |
| 32 | + משמעותית פחות נפוץ מאשר ב-Windows ודורש טיפול נפרד ב-`DisplayManager`). |
| 33 | + |
| 34 | +## מבנה הפרויקט |
| 35 | +``` |
| 36 | +app/src/main/java/com/overlaymanager/app/ |
| 37 | + OverlayLayer.kt - מודל נתונים לשכבה בודדת + סריאליזציה ל-JSON |
| 38 | + LayerStore.kt - שמירה/טעינה של רשימת השכבות (מקביל ל-config.ini) |
| 39 | + OverlayService.kt - השירות שמצייר את כל חלונות ה-overlay בפועל |
| 40 | + MainActivity.kt - מסך רשימת השכבות + הפעלה/כיבוי + הרשאות |
| 41 | + LayerEditActivity.kt - טופס עריכת שכבה עם תצוגה מקדימה חיה |
| 42 | + LayerAdapter.kt - RecyclerView adapter לרשימה |
| 43 | + BootReceiver.kt - הפעלה מחדש אוטומטית אחרי ריסטארט (אופציונלי) |
| 44 | +``` |
| 45 | + |
| 46 | +## בנייה - דרך Android Studio (מומלץ) |
| 47 | +1. פתחו את התיקייה `OverlayManagerAndroid` כפרויקט קיים ב-Android Studio |
| 48 | + (Hedgehog/2023.1 ומעלה, עם Kotlin 1.9+ ו-AGP 8.5+). |
| 49 | +2. ה-Gradle Wrapper כבר כלול בפרויקט (`gradlew`, `gradlew.bat`, `gradle/wrapper/`). |
| 50 | +3. Run על מכשיר/אמולטור עם Android 9 (API 28) ומעלה, או Build → Build APK(s). |
| 51 | + |
| 52 | +## בנייה משורת פקודה (מחשב עם Android SDK מותקן) |
| 53 | +``` |
| 54 | +./gradlew assembleDebug |
| 55 | +``` |
| 56 | +ה-APK ייווצר תחת `app/build/outputs/apk/debug/app-debug.apk`. |
| 57 | + |
| 58 | +## בנייה בענן עם GitHub Actions (בלי להתקין כלום במחשב) — מומלץ אם אין לכם Android Studio |
| 59 | +בפרויקט כבר כלול הקובץ `.github/workflows/build.yml` שבונה APK אוטומטית. |
| 60 | + |
| 61 | +**שלבים:** |
| 62 | +1. צרו ריפו חדש וריק ב-GitHub (למשל `OverlayManagerAndroid`), **בלי** README/gitignore |
| 63 | + אוטומטיים (כדי למנוע התנגשות). |
| 64 | +2. בטרמינל, בתוך תיקיית הפרויקט: |
| 65 | + ``` |
| 66 | + git init |
| 67 | + git add . |
| 68 | + git commit -m "Initial commit" |
| 69 | + git branch -M main |
| 70 | + git remote add origin https://github.com/<שם-המשתמש-שלכם>/OverlayManagerAndroid.git |
| 71 | + git push -u origin main |
| 72 | + ``` |
| 73 | +3. עברו ל-GitHub → לשונית **Actions** בריפו שלכם. ה-workflow "Build APK" ירוץ |
| 74 | + אוטומטית תוך כמה דקות (אפשר גם להריץ ידנית עם "Run workflow"). |
| 75 | +4. כשהוא מסתיים בהצלחה (✔ ירוק), לחצו על ה-run שרץ → גללו למטה ל-**Artifacts** → |
| 76 | + הורידו את `OverlayManager-debug-apk` (קובץ zip שמכיל את ה-APK בפנים). |
| 77 | +5. פתחו את ה-zip, תמצאו את `app-debug.apk` — זה קובץ ההתקנה. |
| 78 | + |
| 79 | +## התקנת ה-APK על הטלפון |
| 80 | +1. העבירו את `app-debug.apk` לטלפון (וואטסאפ לעצמך, גוגל דרייב, כבל USB וכו'). |
| 81 | +2. פתחו את הקובץ בטלפון. אם זו הפעם הראשונה שמתקינים APK מחוץ ל-Play Store, |
| 82 | + אנדרואיד יבקש לאשר "התקנה ממקורות לא ידועים" — אשרו רק לאפליקציה שממנה |
| 83 | + פתחתם את הקובץ (למשל "קבצים" או "דרייב"). |
| 84 | +3. לחצו התקן. בסיום, פתחו את "Overlay Manager". |
| 85 | + |
| 86 | + |
| 87 | +## שימוש |
| 88 | +1. פתחו את האפליקציה, לחצו "הוסף שכבה", תנו שם ובחרו תמונה. |
| 89 | +2. קבעו רוחב/גובה, עוגן, מרחק באחוזים, שקיפות וטינט — כל שינוי מוצג מיד על |
| 90 | + המסך אם השירות פעיל. |
| 91 | +3. הדליקו את המתג הראשי במסך הבית כדי להתחיל להציג את כל השכבות הפעילות. |
| 92 | + בפעם הראשונה תתבקשו לאשר הרשאת "הצגה מעל אפליקציות אחרות". |
| 93 | +4. ההתראה הקבועה מאפשרת "הצג/הסתר הכל" בלחיצה אחת (מקביל ל-Ctrl+Alt+H). |
| 94 | +5. "הפעלה אוטומטית עם המכשיר" תדליק את השירות שוב אחרי ריסטארט, בתנאי |
| 95 | + שההרשאה עדיין קיימת. |
| 96 | + |
| 97 | +## הערות טכניות |
| 98 | +- GIF מונפש מוצג באמצעות `AnimatedImageDrawable` (API 28+) — חלק מה-SDK |
| 99 | + הרשמי של אנדרואיד, בלי ספריית תמונות חיצונית (Glide/Coil), בדיוק כמו |
| 100 | + שהמקור מסתמך רק על GDI+ מובנה ב-Windows. |
| 101 | +- כל שכבה היא `WindowManager.LayoutParams` נפרד מסוג `TYPE_APPLICATION_OVERLAY` |
| 102 | + עם `FLAG_NOT_TOUCHABLE` כשהיא נעולה — המקבילה הישירה ל- |
| 103 | + `WS_EX_LAYERED | WS_EX_TOPMOST | WS_EX_TRANSPARENT` בגרסת Windows. |
| 104 | +- ההגדרות נשמרות כ-JSON בזיכרון הפנימי של האפליקציה ונטענות מחדש אוטומטית |
| 105 | + בכל הפעלה של השירות או המסך הראשי. |
| 106 | + |
| 107 | +## מגבלה חשובה |
| 108 | +בסביבה שבה נכתב הקוד אין גישה ל-Android SDK / Google Maven, ולכן **לא בוצעה כאן |
| 109 | +בנייה מלאה שמוודאת הידור 100%**. הקוד נכתב בקפידה לפי ה-API הרשמי של אנדרואיד, |
| 110 | +אבל אחרי push ל-GitHub או פתיחה ב-Android Studio ייתכן שיצוצו שגיאות קומפילציה |
| 111 | +קטנות (למשל אי-התאמות גרסאות ספריות) — אם זה קורה, שלחו לי את הודעת השגיאה |
| 112 | +המדויקת ואני אתקן. |
0 commit comments