Skip to content

Commit b0b68dd

Browse files
committed
Fix show/hide-all button silently losing track of overlay views
0 parents  commit b0b68dd

48 files changed

Lines changed: 2976 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/build.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Build APK
2+
3+
on:
4+
push:
5+
branches: [ main, master ]
6+
workflow_dispatch: {}
7+
8+
jobs:
9+
build:
10+
runs-on: ubuntu-latest
11+
steps:
12+
- name: Checkout
13+
uses: actions/checkout@v4
14+
15+
- name: Set up JDK 17
16+
uses: actions/setup-java@v4
17+
with:
18+
distribution: temurin
19+
java-version: '17'
20+
21+
- name: Set up Android SDK
22+
uses: android-actions/setup-android@v3
23+
24+
- name: Grant execute permission for gradlew
25+
run: chmod +x gradlew
26+
27+
- name: Build debug APK
28+
run: ./gradlew assembleDebug --stacktrace
29+
30+
- name: Upload APK
31+
uses: actions/upload-artifact@v4
32+
with:
33+
name: OverlayManager-debug-apk
34+
path: app/build/outputs/apk/debug/app-debug.apk

‎.gitignore‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
*.iml
2+
.gradle/
3+
/local.properties
4+
.idea/
5+
.DS_Store
6+
/build
7+
/captures
8+
.externalNativeBuild
9+
.cxx
10+
local.properties
11+
app/build/

‎README.md‎

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
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+
המדויקת ואני אתקן.

‎app/build.gradle.kts‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
plugins {
2+
id("com.android.application")
3+
id("org.jetbrains.kotlin.android")
4+
}
5+
6+
android {
7+
namespace = "com.overlaymanager.app"
8+
compileSdk = 34
9+
10+
defaultConfig {
11+
applicationId = "com.overlaymanager.app"
12+
// minSdk 19 = Android 4.4 (KitKat), enforced for real this time.
13+
//
14+
// No AndroidX (or any other external) library is used anywhere in this
15+
// module on purpose. androidx.appcompat, material and even recent
16+
// core-ktx releases all silently require minSdk 21+ internally, which
17+
// is exactly what broke the previous build even though this file said
18+
// minSdk = 19. Every screen, widget and the notification are built
19+
// with plain android.* framework APIs only, each SDK-version-gated
20+
// by hand where the framework itself changed behaviour across
21+
// versions (see MainActivity, LayerEditActivity and OverlayService).
22+
minSdk = 19
23+
targetSdk = 34
24+
versionCode = 1
25+
versionName = "1.0"
26+
}
27+
28+
buildTypes {
29+
release {
30+
isMinifyEnabled = false
31+
proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
32+
}
33+
}
34+
35+
compileOptions {
36+
sourceCompatibility = JavaVersion.VERSION_17
37+
targetCompatibility = JavaVersion.VERSION_17
38+
}
39+
kotlinOptions {
40+
jvmTarget = "17"
41+
}
42+
}
43+
44+
// No dependencies block: zero external libraries, zero minSdk surprises.

‎app/proguard-rules.pro‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# Add project specific ProGuard rules here.

‎app/src/main/AndroidManifest.xml‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
3+
4+
<!-- Draw floating layers over other apps (equivalent of WS_EX_LAYERED | WS_EX_TOPMOST) -->
5+
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
6+
7+
<!-- Keep the overlay(s) alive in the background -->
8+
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
9+
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
10+
11+
<!-- Required to show the persistent notification on Android 13+ (equivalent of the tray icon) -->
12+
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
13+
14+
<!-- Optional: relaunch the overlay service after a reboot (equivalent of "auto-start with Windows") -->
15+
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
16+
17+
<!-- Required to even show the "ignore battery optimizations" system dialog (SecurityActivity's
18+
battery-exemption button). Without this, Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
19+
throws a SecurityException at the OS level and the button silently does nothing. -->
20+
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
21+
22+
<application
23+
android:allowBackup="true"
24+
android:icon="@mipmap/ic_launcher"
25+
android:label="@string/app_name"
26+
android:theme="@style/Theme.OverlayManager"
27+
android:supportsRtl="true">
28+
29+
<activity
30+
android:name=".LockActivity"
31+
android:exported="true"
32+
android:launchMode="singleTop">
33+
<intent-filter>
34+
<action android:name="android.intent.action.MAIN" />
35+
<category android:name="android.intent.category.LAUNCHER" />
36+
</intent-filter>
37+
</activity>
38+
39+
<activity
40+
android:name=".MainActivity"
41+
android:exported="false"
42+
android:launchMode="singleTop" />
43+
44+
<activity
45+
android:name=".SecurityActivity"
46+
android:exported="false"
47+
android:label="@string/security_title" />
48+
49+
<activity
50+
android:name=".LayerEditActivity"
51+
android:exported="false"
52+
android:label="@string/edit_layer_title" />
53+
54+
<receiver
55+
android:name=".AppDeviceAdminReceiver"
56+
android:permission="android.permission.BIND_DEVICE_ADMIN"
57+
android:exported="true">
58+
<meta-data
59+
android:name="android.app.device_admin"
60+
android:resource="@xml/device_admin_receiver" />
61+
<intent-filter>
62+
<action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
63+
</intent-filter>
64+
</receiver>
65+
66+
<service
67+
android:name=".OverlayService"
68+
android:exported="false"
69+
android:foregroundServiceType="specialUse">
70+
<property
71+
android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE"
72+
android:value="Floating watermark/logo overlay windows requested by the user" />
73+
</service>
74+
75+
<receiver
76+
android:name=".BootReceiver"
77+
android:exported="true">
78+
<intent-filter>
79+
<action android:name="android.intent.action.BOOT_COMPLETED" />
80+
</intent-filter>
81+
</receiver>
82+
83+
</application>
84+
</manifest>
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
package com.overlaymanager.app
2+
3+
import android.app.admin.DeviceAdminReceiver
4+
import android.app.admin.DevicePolicyManager
5+
import android.content.Context
6+
import android.content.Intent
7+
import android.widget.Toast
8+
9+
/**
10+
* Anti-theft deterrent only - NOT real uninstall protection.
11+
*
12+
* Android lets any user disable a normal app's device-admin rights from
13+
* system Settings at any time; a regular (non-Device-Owner) app cannot put
14+
* its own password screen in front of that system flow. What this class
15+
* *can* do, and does:
16+
* - onDisableRequested(): shown as a warning inside Android's own
17+
* "Deactivate this device admin app?" confirmation dialog, and
18+
* immediately locks the screen (dpm.lockNow()) as a deterrent while
19+
* admin rights are still active.
20+
* - onDisabled(): fires after admin rights are actually removed - too late
21+
* to block anything, but still logged/toasted for visibility.
22+
*/
23+
class AppDeviceAdminReceiver : DeviceAdminReceiver() {
24+
25+
override fun onEnabled(context: Context, intent: Intent) {
26+
super.onEnabled(context, intent)
27+
Toast.makeText(context, R.string.admin_enabled_toast, Toast.LENGTH_LONG).show()
28+
}
29+
30+
override fun onDisableRequested(context: Context, intent: Intent): CharSequence {
31+
try {
32+
val dpm = context.getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
33+
dpm.lockNow()
34+
} catch (e: Exception) {
35+
// Best-effort only.
36+
}
37+
return context.getString(R.string.admin_disable_warning)
38+
}
39+
40+
override fun onDisabled(context: Context, intent: Intent) {
41+
super.onDisabled(context, intent)
42+
Toast.makeText(context, R.string.admin_disabled_toast, Toast.LENGTH_LONG).show()
43+
}
44+
}
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
package com.overlaymanager.app
2+
3+
import android.content.BroadcastReceiver
4+
import android.content.Context
5+
import android.content.Intent
6+
import android.content.SharedPreferences
7+
import android.os.Build
8+
import android.provider.Settings
9+
10+
/**
11+
* Equivalent of "auto-start with Windows". Only relaunches the service if
12+
* the user previously enabled it AND the overlay permission is still granted -
13+
* otherwise the service would immediately fail to draw anything.
14+
*/
15+
class BootReceiver : BroadcastReceiver() {
16+
override fun onReceive(context: Context, intent: Intent) {
17+
if (intent.action != Intent.ACTION_BOOT_COMPLETED) return
18+
19+
val prefs: SharedPreferences = context.getSharedPreferences(Prefs.NAME, Context.MODE_PRIVATE)
20+
val autoStart = prefs.getBoolean(Prefs.KEY_AUTO_START, false)
21+
if (!autoStart) return
22+
23+
val canDraw = Build.VERSION.SDK_INT < Build.VERSION_CODES.M || Settings.canDrawOverlays(context)
24+
if (canDraw) {
25+
OverlayService.start(context)
26+
}
27+
}
28+
}
29+
30+
object Prefs {
31+
const val NAME = "overlay_manager_prefs"
32+
const val KEY_AUTO_START = "auto_start_enabled"
33+
const val KEY_PIN_HASH = "pin_hash"
34+
const val KEY_OWNER_NAME = "owner_name"
35+
const val KEY_OWNER_PHONE = "owner_phone"
36+
// true = user explicitly chose "continue without a PIN"; LockActivity
37+
// skips straight to MainActivity while this is set, even if a PIN hash
38+
// exists from a previous setup.
39+
const val KEY_LOCK_DISABLED = "lock_disabled"
40+
// false = user chose to hide the persistent "overlay running" notification.
41+
// Default true because Android requires it for a *foreground* service -
42+
// turning it off means the service runs as a plain background service
43+
// instead, which trades away the survive-after-swipe-away guarantee.
44+
const val KEY_SHOW_NOTIFICATION = "show_notification"
45+
}

0 commit comments

Comments
 (0)