android-notify 1.60.5.dev0__tar.gz → 1.60.6__tar.gz

android_notify-1.60.6/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.4
+Name: android-notify
+Version: 1.60.6
+Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
+Author-email: Fabian <fector101@yahoo.com>
+License-Expression: MIT
+Project-URL: Homepage, https://android-notify.vercel.app
+Project-URL: Documentation, https://android-notify.vercel.app/
+Project-URL: Source, https://github.com/fector101/android_notify
+Project-URL: Tracker, https://github.com/fector101/android_notify/issues
+Project-URL: Funding, https://www.buymeacoffee.com/fector101
+Keywords: android,notifications,kivy,mobile,post-notifications,pyjnius,android-notifications,kivy-notifications,python-android,mobile-development,push-notifications,mobile-app,kivy-application
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Android
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: pyjnius>=1.4.2
+Provides-Extra: dev
+Requires-Dist: kivy>=2.0.0; extra == "dev"
+
+<div align="center">
+    <br>
+    <h1> Android-Notify </h1>
+    <p><a href='https://android-notify.vercel.app'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy and Flet apps.</p>
+    <p>Supports various styles and ensures seamless integration, customization and Pythonic APIs.</p>
+    <!-- <br> -->
+    <!-- <img src="https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/democollage.jpg"> -->
+</div>
+<!-- Channel [CRUD]
+The Android Notify package provides a simple yet comprehensive way to create and manage rich notifications on Android devices directly from your Python code. This library bridges the gap between Python and Android's notification system, giving you full control over notifications with a clean, Pythonic API. -->
+
+## Features
+
+- **Multiple Notification Styles**: Support for various notification styles including:
+  - Simple text notifications
+  - [Progress bar notifications](https://android-notify.vercel.app/components#progress-bars) (determinate and indeterminate)
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+  - Custom notification Icon - [images section](https://android-notify.vercel.app/components#images)
+  - Big text notifications
+  - Inbox-style notifications
+  - Colored texts and Icons
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - [Update notification](https://android-notify.vercel.app/advanced-methods#updating-notification) content dynamically
+  - Manage progress bars with fine-grained control
+  - [Custom notification channels](https://android-notify.vercel.app/advanced-methods#channel-management) for Android 8.0+ (Creating and Deleting)
+  - Silent notifications
+  - Persistent notifications
+  - Click handlers and callbacks
+  - Cancel Notifications
+
+## Quick Start
+
+```python
+from android_notify import Notification
+
+# Simple notification
+Notification(
+    title="Hello",
+    message="This is a basic notification."
+).send()
+
+```
+
+**Sample Image:**  
+![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
+
+## Installation
+
+<details>
+<summary><b>Kivy apps:</b></summary>
+<br/>
+
+In your **`buildozer.spec`** file, ensure you include the following:
+
+```ini
+# Add pyjnius so ensure it's packaged with the build
+requirements = python3, kivy, pyjnius, android-notify
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+
+# Required dependencies (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+</details>
+
+
+<details>
+<summary><b>Flet apps:</b></summary>
+<br/>
+
+ In your `pyproject.toml` file, ensure you include the following:
+
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "pyjnius","android-notify>=1.60.6.dev0"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+- example of [complete flet pyproject.toml](https://github.com/Fector101/flet-app/blob/main/pyproject.toml)
+
+</details>
+
+<details>
+
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+</details>
+
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify>=1.60.6.dev0` to install via `pip`
+
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify>=1.60.6.dev0
+```
+
+</details>
+
+<details>
+
+<summary><b>On Pydroid 3</b></summary>
+<br/>
+
+On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
+- In pip section where you're asked to insert `Libary name` paste `android-notify>=1.60.6.dev0`
+- Minimal working example 
+```py
+# Testing with `android-notify>=1.60.6.dev0` on pydroid
+from kivy.app import App
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.button import Button
+from android_notify import Notification
+from android_notify.core import asks_permission_if_needed
+
+
+class AndroidNotifyDemoApp(App):
+    def build(self):
+        layout = BoxLayout(orientation='vertical', spacing=10, padding=20)
+        layout.add_widget(Button(
+            text="Ask Notification Permission",
+            on_release=self.request_permission
+        ))
+        layout.add_widget(Button(
+            text="Send Notification",
+            on_release=self.send_notification
+        ))
+        return layout
+
+    def request_permission(self, *args):
+        asks_permission_if_needed(no_androidx=True)
+
+    def send_notification(self, *args):
+        Notification(
+            title="Hello from Android Notify",
+            message="This is a basic notification.",
+            channel_id="android_notify_demo",
+            channel_name="Android Notify Demo"
+        ).send()
+
+
+if __name__ == "__main__":
+    AndroidNotifyDemoApp().run()
+```
+
+</details>
+
+
+
+## Documentation
+For Dev Version use
+```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip```
+
+### To talk to BroadCast Listener From Buttons
+
+- Make things happen without being in your app
+```python
+
+from android_notify import Notification
+notification = Notification(title="Reciver Notification")
+notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
+notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
+```
+You can use this [wiki](https://github.com/Fector101/android_notify/wiki/How-to#use-with-broadcast-listener-in-kivy) as a guide create a broadcast listener
+
+### To use colored text in your notifications
+
+- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
+- Lastly in your `buildozer.spec` file  
+Add `source.include_exts = xml` and `android.add_resources = # path you pasted`
+
+### To use Custom Sounds
+
+- Put audio files in `res/raw` folder,
+- Then from `buildozer.spec` point to res folder `android.add_resources = res`
+- and includes it's format `source.include_exts = wav`.
+
+Lastly From the code 
+```py
+# Create a custom notification channel with a unique sound resource for android 8+
+Notification.createChannel(
+    id="weird_sound_tester",
+    name="Weird Sound Tester",
+    description="A test channel used to verify custom notification sounds from the res/raw folder.",
+    res_sound_name="sneeze" # file name without .wav or .mp3
+)
+
+# Send a notification through the created channel
+n=Notification(
+    title="Custom Sound Notification",
+    message="This tests playback of a custom sound (sneeze.wav) stored in res/raw.",
+    channel_id="weird_sound_tester" # important tells notification to use right channel
+)
+n.setSound("sneeze")# for android 7 below 
+n.send()
+```
+
+### For full documentation, examples, and advanced usage, API reference visit the [documentation](https://android-notify.vercel.app)
+
+## ☕ Support the Project
+
+If you find this project helpful, any support would help me continue working on open-source projects. I’m currently saving for a laptop to keep developing.
+[donate](https://www.buymeacoffee.com/fector101)

android_notify-1.60.6/README.md

@@ -0,0 +1,227 @@
+<div align="center">
+    <br>
+    <h1> Android-Notify </h1>
+    <p><a href='https://android-notify.vercel.app'>Android Notify</a> is a Python library for effortlessly creating and managing Android notifications in Kivy and Flet apps.</p>
+    <p>Supports various styles and ensures seamless integration, customization and Pythonic APIs.</p>
+    <!-- <br> -->
+    <!-- <img src="https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/democollage.jpg"> -->
+</div>
+<!-- Channel [CRUD]
+The Android Notify package provides a simple yet comprehensive way to create and manage rich notifications on Android devices directly from your Python code. This library bridges the gap between Python and Android's notification system, giving you full control over notifications with a clean, Pythonic API. -->
+
+## Features
+
+- **Multiple Notification Styles**: Support for various notification styles including:
+  - Simple text notifications
+  - [Progress bar notifications](https://android-notify.vercel.app/components#progress-bars) (determinate and indeterminate)
+  - Large icon notifications
+  - Big picture notifications
+  - Combined image styles
+  - Custom notification Icon - [images section](https://android-notify.vercel.app/components#images)
+  - Big text notifications
+  - Inbox-style notifications
+  - Colored texts and Icons
+
+- **Rich Functionality**:
+  - Add action buttons with custom callbacks
+  - [Update notification](https://android-notify.vercel.app/advanced-methods#updating-notification) content dynamically
+  - Manage progress bars with fine-grained control
+  - [Custom notification channels](https://android-notify.vercel.app/advanced-methods#channel-management) for Android 8.0+ (Creating and Deleting)
+  - Silent notifications
+  - Persistent notifications
+  - Click handlers and callbacks
+  - Cancel Notifications
+
+## Quick Start
+
+```python
+from android_notify import Notification
+
+# Simple notification
+Notification(
+    title="Hello",
+    message="This is a basic notification."
+).send()
+
+```
+
+**Sample Image:**  
+![basic notification img sample](https://raw.githubusercontent.com/Fector101/android_notify/main/docs/imgs/basicnoti.jpg)
+
+## Installation
+
+<details>
+<summary><b>Kivy apps:</b></summary>
+<br/>
+
+In your **`buildozer.spec`** file, ensure you include the following:
+
+```ini
+# Add pyjnius so ensure it's packaged with the build
+requirements = python3, kivy, pyjnius, android-notify
+# Add permission for notifications
+android.permissions = POST_NOTIFICATIONS
+
+# Required dependencies (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core:1.6.0, androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+</details>
+
+
+<details>
+<summary><b>Flet apps:</b></summary>
+<br/>
+
+ In your `pyproject.toml` file, ensure you include the following:
+
+
+```toml
+[tool.flet.android]
+dependencies = [
+  "pyjnius","android-notify>=1.60.6.dev0"
+]
+
+[tool.flet.android.permission]
+"android.permission.POST_NOTIFICATIONS" = true
+```
+- example of [complete flet pyproject.toml](https://github.com/Fector101/flet-app/blob/main/pyproject.toml)
+
+</details>
+
+<details>
+
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
+```
+
+</details>
+
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify>=1.60.6.dev0` to install via `pip`
+
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify>=1.60.6.dev0
+```
+
+</details>
+
+<details>
+
+<summary><b>On Pydroid 3</b></summary>
+<br/>
+
+On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) mobile app for running python code you can test some features.
+- In pip section where you're asked to insert `Libary name` paste `android-notify>=1.60.6.dev0`
+- Minimal working example 
+```py
+# Testing with `android-notify>=1.60.6.dev0` on pydroid
+from kivy.app import App
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.button import Button
+from android_notify import Notification
+from android_notify.core import asks_permission_if_needed
+
+
+class AndroidNotifyDemoApp(App):
+    def build(self):
+        layout = BoxLayout(orientation='vertical', spacing=10, padding=20)
+        layout.add_widget(Button(
+            text="Ask Notification Permission",
+            on_release=self.request_permission
+        ))
+        layout.add_widget(Button(
+            text="Send Notification",
+            on_release=self.send_notification
+        ))
+        return layout
+
+    def request_permission(self, *args):
+        asks_permission_if_needed(no_androidx=True)
+
+    def send_notification(self, *args):
+        Notification(
+            title="Hello from Android Notify",
+            message="This is a basic notification.",
+            channel_id="android_notify_demo",
+            channel_name="Android Notify Demo"
+        ).send()
+
+
+if __name__ == "__main__":
+    AndroidNotifyDemoApp().run()
+```
+
+</details>
+
+
+
+## Documentation
+For Dev Version use
+```requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip```
+
+### To talk to BroadCast Listener From Buttons
+
+- Make things happen without being in your app
+```python
+
+from android_notify import Notification
+notification = Notification(title="Reciver Notification")
+notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
+notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
+```
+You can use this [wiki](https://github.com/Fector101/android_notify/wiki/How-to#use-with-broadcast-listener-in-kivy) as a guide create a broadcast listener
+
+### To use colored text in your notifications
+
+- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
+- Lastly in your `buildozer.spec` file  
+Add `source.include_exts = xml` and `android.add_resources = # path you pasted`
+
+### To use Custom Sounds
+
+- Put audio files in `res/raw` folder,
+- Then from `buildozer.spec` point to res folder `android.add_resources = res`
+- and includes it's format `source.include_exts = wav`.
+
+Lastly From the code 
+```py
+# Create a custom notification channel with a unique sound resource for android 8+
+Notification.createChannel(
+    id="weird_sound_tester",
+    name="Weird Sound Tester",
+    description="A test channel used to verify custom notification sounds from the res/raw folder.",
+    res_sound_name="sneeze" # file name without .wav or .mp3
+)
+
+# Send a notification through the created channel
+n=Notification(
+    title="Custom Sound Notification",
+    message="This tests playback of a custom sound (sneeze.wav) stored in res/raw.",
+    channel_id="weird_sound_tester" # important tells notification to use right channel
+)
+n.setSound("sneeze")# for android 7 below 
+n.send()
+```
+
+### For full documentation, examples, and advanced usage, API reference visit the [documentation](https://android-notify.vercel.app)
+
+## ☕ Support the Project
+
+If you find this project helpful, any support would help me continue working on open-source projects. I’m currently saving for a laptop to keep developing.
+[donate](https://www.buymeacoffee.com/fector101)

{android_notify-1.60.5.dev0 → android_notify-1.60.6}/android_notify/an_types.py

@@ -108,9 +108,6 @@ class Uri:
 class NotificationManager:
     pass
 
-class NotificationManagerClass:
-    pass
-
 
 class NotificationChannel:
     def __init__(self, channel_id, channel_name, importance):
@@ -172,12 +169,6 @@ class NotificationManagerCompat:
     IMPORTANCE_MIN = ''
     IMPORTANCE_NONE = ''
 
-class AndroidNotification:
-    DEFAULT_ALL = 3
-    PRIORITY_HIGH = 4
-    PRIORITY_DEFAULT = ''
-    PRIORITY_LOW = ''
-    PRIORITY_MIN = ''
 
 class NotificationCompat:
     DEFAULT_ALL = 3
@@ -196,19 +187,15 @@ class MActions:
 class NotificationCompatBuilder:
     def __init__(self, context, channel_id):
         self.mActions = MActions()
-        print(f"[MOCK] NotificationCompatBuilder initialized with context={context}, channel_id={channel_id}")
-
-    def setProgress(self, max_value, current_value, endless):
-        print(f"[MOCK] setProgress called with max={max_value}, current={current_value}, endless={endless}")
-
-    def setStyle(self, style):
-        print(f"[MOCK] setStyle called with style={style}")
-
-    def setContentTitle(self, title):
-        print(f"[MOCK] setContentTitle called with title={title}")
-
-    def setContentText(self, text):
-        print(f"[MOCK] setContentText called with text={text}")
+        pass
+    def setProgress(self,max_value,current_value,endless):
+        pass
+    def setStyle(self,style):
+        pass
+    def setContentTitle(self,title):
+        pass
+    def setContentText(self,text):
+        pass
 
     def setSmallIcon(self, icon):
         print(f"[MOCK] setSmallIcon called with icon={icon}")

{android_notify-1.60.5.dev0 → android_notify-1.60.6}/android_notify/an_utils.py

@@ -4,11 +4,11 @@ import inspect, os, re, traceback
 from .config import autoclass
 from .an_types import Importance
 from .config import (
-    get_python_activity_context, app_storage_path, ON_ANDROID,
-    BitmapFactory, BuildVersion, Bundle,
-    NotificationManagerClass, AndroidNotification, Intent, Settings, Uri, String, Manifest
-
-)
+                     get_python_activity_context, app_storage_path,ON_ANDROID,
+                     BitmapFactory, BuildVersion, Bundle,
+                     NotificationManagerCompat,NotificationCompat,
+                     Intent, Settings, Uri, String, Manifest
+                    )
 
 if ON_ANDROID:
     Color = autoclass('android.graphics.Color')
@@ -41,15 +41,15 @@ def get_android_importance(importance: Importance):
         return None
     value = ''
     if importance == 'urgent':
-        value = AndroidNotification.PRIORITY_HIGH if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_HIGH
+        value = NotificationCompat.PRIORITY_HIGH if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_HIGH
     elif importance == 'high':
-        value = AndroidNotification.PRIORITY_DEFAULT if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_DEFAULT
+        value = NotificationCompat.PRIORITY_DEFAULT if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_DEFAULT
     elif importance == 'medium':
-        value = AndroidNotification.PRIORITY_LOW if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_LOW
+        value = NotificationCompat.PRIORITY_LOW if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_LOW
     elif importance == 'low':
-        value = AndroidNotification.PRIORITY_MIN if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_MIN
+        value = NotificationCompat.PRIORITY_MIN if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_MIN
     elif importance == 'none':
-        value = '' if BuildVersion.SDK_INT <= 25 else NotificationManagerClass.IMPORTANCE_NONE
+        value = '' if BuildVersion.SDK_INT <= 25 else NotificationManagerCompat.IMPORTANCE_NONE
 
     return value
     # side-note 'medium' = NotificationCompat.PRIORITY_LOW and 'low' = NotificationCompat.PRIORITY_MIN # weird but from docs
@@ -78,10 +78,10 @@ def get_img_from_path(relative_path):
     app_folder = os.path.join(app_storage_path(), 'app')
     img_full_path = os.path.join(app_folder, relative_path)
     if not os.path.exists(img_full_path):
-        print(f'\nImage: "{img_full_path}" Not Found, (Local images gotten from App Path)')
+        print(f'Image: "{img_full_path}" Not Found, (Local images gotten from App Path)')
         try:
             print("- These are the existing files in your app Folder:")
-            print('[' + ', '.join(os.listdir(app_folder)) + ']\n')
+            print('[' + ', '.join(os.listdir(app_folder)) + ']')
         except Exception as could_not_get_files_in_path_error:
             print('Exception: ', could_not_get_files_in_path_error)
             print("Couldn't get Files in App Folder")

{android_notify-1.60.5.dev0 → android_notify-1.60.6}/android_notify/config.py

@@ -1,7 +1,8 @@
 import os, traceback
 
 ON_ANDROID = False
-__version__ = "1.60.5.dev0"
+__version__ = "1.60.6"
+
 
 def is_platform_android():
     if os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME"):
@@ -51,10 +52,9 @@ if is_platform_android():
         PendingIntent = autoclass('android.app.PendingIntent')
         BitmapFactory = autoclass('android.graphics.BitmapFactory')
         BuildVersion = autoclass('android.os.Build$VERSION')
-        NotificationManagerClass = autoclass('android.app.NotificationManager')
+        NotificationManager = autoclass('android.app.NotificationManager')
         NotificationChannel = autoclass('android.app.NotificationChannel')
         RemoteViews = autoclass('android.widget.RemoteViews')
-        AndroidNotification = autoclass("android.app.Notification")
         Settings = autoclass("android.provider.Settings")
         Uri = autoclass("android.net.Uri")
         Manifest = autoclass('android.Manifest$permission')
@@ -71,17 +71,25 @@ else:
 
 if ON_ANDROID:
     try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+        IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
         Color = autoclass('android.graphics.Color')
 
         # Notification Design
-        NotificationCompatBuilder = autoclass('android.app.Notification$Builder')
-        NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
-        NotificationCompatBigPictureStyle = autoclass('android.app.Notification$BigPictureStyle')
-        NotificationCompatInboxStyle = autoclass('android.app.Notification$InboxStyle')
-        # NotificationCompatDecoratedCustomViewStyle = autoclass('androidx.core.app.NotificationCompat$DecoratedCustomViewStyle')
-
-    except Exception as styles_import_error:
-        print('styles_import_error: ', styles_import_error)
+        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
+        NotificationCompatBigTextStyle = autoclass('androidx.core.app.NotificationCompat$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('androidx.core.app.NotificationCompat$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('androidx.core.app.NotificationCompat$InboxStyle')
+        NotificationCompatDecoratedCustomViewStyle = autoclass('androidx.core.app.NotificationCompat$DecoratedCustomViewStyle')
+
+    except Exception as dependencies_import_error:
+        print('dependencies_import_error: ', dependencies_import_error)
+        print("""
+        Dependency Error: Add the following in buildozer.spec:
+        * android.gradle_dependencies = androidx.core:core-ktx:1.15.0, androidx.core:core:1.6.0
+        * android.enable_androidx = True
+        """)
 
         from .an_types import *
 else:
@@ -149,7 +157,7 @@ def get_notification_manager():
     if not ON_ANDROID:
         return None
     notification_service = context.getSystemService(context.NOTIFICATION_SERVICE)
-    return cast(NotificationManagerClass, notification_service)
+    return cast(NotificationManager, notification_service)
 
 
 def app_storage_path():
@@ -161,3 +169,7 @@ def app_storage_path():
             return kivy_app_storage_path()
         except Exception as e:
             return './'  # TODO return file main.py path (not android)
+
+
+def get_package_name():
+    return context.getPackageName()  # package.domain + "." + package.name