|
1 | 1 | <div align="center"> |
2 | | - <img width="210em" height="auto" src="./.resources/images/ic_launcher.png" alt="Logo" border="0"> |
| 2 | + <img width="210" height="auto" src="./.resources/images/ic_launcher.png" alt="Current Activity Logo" border="0"> |
| 3 | + |
| 4 | + # Current Activity |
| 5 | + |
| 6 | + **🔍 App Activity Inspector: Real-Time Foreground Status Monitor** |
| 7 | + |
| 8 | + An essential tool for **Android Developers** and **Reverse Engineers** |
| 9 | + Instantly displays the *package name* and *class name* of the application currently in the foreground. |
| 10 | + Quickly inspect any active app on your device for development or debugging. |
| 11 | + |
| 12 | + [](LICENSE) |
| 13 | + [](https://www.android.com/) |
| 14 | + [](https://github.com/codehasan/Current-Activity/releases) |
| 15 | + |
| 16 | + <a href='https://play.google.com/store/apps/details?id=io.github.ratul.topactivity'> |
| 17 | + <img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png' width='200'/> |
| 18 | + </a> |
| 19 | + |
3 | 20 | </div> |
4 | | -<h1 align="center"> |
5 | | - <b>Current Activity</b> |
6 | | -</h1> |
7 | | -<div align="center"> |
8 | 21 |
|
9 | | -[](https://github.com/RatulHasan8/Current-Activity/releases/tag/app-n-source) |
10 | | -[](https://github.com/RatulHasan8/Current-Activity/releases/tag/app-n-source) |
11 | | -[](./LICENSE) |
12 | | -[](https://github.com/ratsan/Current-Activity/graphs/commit-activity) |
13 | | -[](https://github.com/ratsan/Current-Activity/pulls) |
14 | | -[](https://github.com/ratsan/Current-Activity/graphs/contributors) |
15 | | -<br/> |
| 22 | +--- |
16 | 23 |
|
17 | | -<p align="center"> |
18 | | -<srong>App Activity Inspector: Real-Time Foreground Status Monitor</strong> |
| 24 | +## ⚠️ Important Note |
19 | 25 |
|
20 | | -An essential tool for <strong>Android Developers</strong> and <strong>Reverse Engineers</strong>. Instantly displays the <i>package name</i> and <i>class name</i> of the application currently in the foreground. Quickly inspect any active app on your device for development or debugging. |
21 | | -</p> |
| 26 | +> **Note:** Google prohibits the usage of **QUERY_ALL_PACKAGES** permission and **AccessibilityService** without a strong explanation. For that reason, the Play Store version of **Current Activity** won't have either of these features. While the app will still function, performance will vary. |
| 27 | +> |
| 28 | +> **💡 Recommendation:** It is strongly recommended to use the latest **Global** version from [**Releases**](https://github.com/codehasan/Current-Activity/releases) rather than from **Play Store**. |
22 | 29 |
|
23 | | -</div> |
| 30 | +--- |
| 31 | + |
| 32 | +## ✨ Key Features |
| 33 | + |
| 34 | +- **📱 Real-Time Tracking:** View the **package name** and the **class name** of the app currently visible to the user (i.e., the top app). |
| 35 | +- **🛠️ Development & Debugging:** Quickly verify which components are launched, aid in deep-link development, and confirm third-party app interaction. |
| 36 | +- **🔧 Reverse Engineering:** Identify key components and packages in external applications for analysis. |
| 37 | + |
| 38 | +--- |
| 39 | + |
| 40 | +## ⚙️ How It Works |
| 41 | + |
| 42 | +The monitoring is made possible with two main services: **PackageMonitoringService** and **AccessibilityMonitoringService**. |
| 43 | + |
| 44 | +1. **PackageMonitoringService** actively checks for app state changes in the last 10 seconds, doing this every 500ms. Each time a state change is detected and confirmed to be in foreground, the popup window is updated to inform the user. |
| 45 | + |
| 46 | +2. **AccessibilityMonitoringService** complements **PackageMonitoringService** by actively observing window state changes. If a change is detected and confirmed not to be a System class (e.g., `android.view.View`), it immediately updates the popup window. |
| 47 | + |
| 48 | +--- |
| 49 | + |
| 50 | +## 📸 Screenshots |
24 | 51 |
|
25 | | -<a href='https://play.google.com/store/apps/details?id=io.github.ratul.topactivity'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png' width='200'/></a> |
26 | | - |
27 | | - |
28 | | -> [!NOTE] |
29 | | -> Google prohibits the usage of **QUERY_ALL_PACKAGES** permission and **AccessibilityService** without a strong explanation. For that reason, play store version of **Current Activity** won't have either of these features. While the app will still function, performance will vary. It is strongly recommended to use the latest **Global** version from [Releases](https://github.com/codehasan/Current-Activity/releases) rather than from **Play Store**. |
30 | | -
|
31 | | - |
32 | | -<h1 align="left"> |
33 | | - <b> Key Features</b> |
34 | | -</h1> |
35 | | - |
36 | | -<ul> |
37 | | - <li><strong>Real-Time Tracking:</strong> View the <strong>package name</strong> and the <strong>class name</strong> of the app currently visible to the user (i.e., the top app).</li> |
38 | | - <li><strong>Development & Debugging:</strong> Quickly verify which components are launched, aid in deep-link development, and confirm third-party app interaction.</li> |
39 | | - <li><strong>Reverse Engineering:</strong> Identify key components and packages in external applications for analysis.</li> |
40 | | -</ul> |
41 | | - |
42 | | -<h1 align="left"> |
43 | | - <b> How it works</b> |
44 | | -</h1> |
45 | | -<p> |
46 | | - The monitoring is possible with mainly two services, <b>PackageMonitoringService</b> and <b>AccessibilityMonitoringService</b>. |
47 | | -</p> |
48 | | -<ol> |
49 | | - <li> |
50 | | - <i>PackageMonitoringService</i> actively checks for app state changes in the last 10 secods. And it does this for every 500ms time passed. Each time a state change is detected and confirmed to be in foreground, the popup window is updated to let the user know. |
51 | | - </li> |
52 | | - <li> |
53 | | - <i>AccessibilityMonitoringService</i> compliments <i>PackageMonitoringService</i> by actively observing window state changes, if a change is detected and it was confirmed not be a System class (i.e. <i>android.view.View</i>), it immediately updates the popup window to let the user know. |
54 | | - </li> |
55 | | -</ol> |
56 | | - |
57 | | -<h1 align="left"> |
58 | | - <b> Screenshots</b> |
59 | | -</h1> |
60 | 52 | <div align="center"> |
61 | | -<a href="./.resources/images/screenshot_2.png"><img width="140" height="249" src="./.resources/images/screenshot_2.png"></a> |
62 | | -<a href="./.resources/images/screenshot_3.png"><img width="140" height="249" src="./.resources/images/screenshot_3.png"></a> |
| 53 | + <img src="./.resources/images/screenshot_1.jpg" width="160" height="356" alt="Screenshot 1"> |
| 54 | + <img src="./.resources/images/screenshot_2.jpg" width="160" height="356" alt="Screenshot 2"> |
| 55 | + <img src="./.resources/images/screenshot_3.jpg" width="160" height="356" alt="Screenshot 3"> |
| 56 | + <img src="./.resources/images/screenshot_4.jpg" width="160" height="356" alt="Screenshot 4"> |
| 57 | + <img src="./.resources/images/screenshot_5.jpg" width="160" height="356" alt="Screenshot 5"> |
63 | 58 | </div> |
64 | | -<h1 align="left"> |
65 | | - <b> Credits</b> |
66 | | -</h1> |
67 | 59 |
|
68 | | -* [Wen](https://github.com/109021017) for [project base](https://github.com/109021017/android-TopActivity). |
69 | | -* [Muhtaseem Al Mahmud](https://github.com/KingMahmud) for project optimization. |
| 60 | +--- |
| 61 | + |
| 62 | +## 🙏 Credits |
70 | 63 |
|
71 | | -<h1 align="left"> |
72 | | - <b> License</b> |
73 | | -</h1> |
| 64 | +- [**Wen**](https://github.com/109021017) for the [project base](https://github.com/109021017/android-TopActivity) |
| 65 | +- [**Muhtaseem Al Mahmud**](https://github.com/KingMahmud) for project optimization |
74 | 66 |
|
75 | | -[](LICENSE) |
76 | | -<br/><br/> |
77 | | -Current Activity is licensed under [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0.html) v3 or later. |
| 67 | +--- |
| 68 | + |
| 69 | +## 📄 License |
| 70 | + |
| 71 | +<div align="center"> |
| 72 | + |
| 73 | + [](LICENSE) |
| 74 | + |
| 75 | + Current Activity is licensed under [**GNU General Public License v3.0**](https://www.gnu.org/licenses/gpl-3.0.html) or later. |
| 76 | + |
| 77 | +</div> |
0 commit comments