android-notify 1.60.10__tar.gz → 1.60.10.dev0__tar.gz

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.10
+Version: 1.60.10.dev0
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -81,14 +81,9 @@ 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
+requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
-
-# Required dependency (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-android.api = 35
 ```
 
 </details>
@@ -98,7 +93,7 @@ android.api = 35
 <summary><b>Flet apps:</b></summary>
 <br/>
 
- In your `pyproject.toml` file, ensure you include the following:
+In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
@@ -114,35 +109,7 @@ dependencies = [
 
 </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.10.dev0` to install via `pip`
-
-<details>
-<summary><b>In Kivy</b></summary>
-<br/>
-
-```ini
-# buildozer.spec
-requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
-```
 
-</details>
 
 <details>
 
@@ -193,11 +160,23 @@ if __name__ == "__main__":
 </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>
 
 ## Documentation
-For Dev Version usage
+For Dev Version use
 ```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
 ```
 
 <details>
@@ -206,7 +185,7 @@ requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_noti
 - Make things happen without being in your app
 ```python
 from android_notify import Notification
-notification = Notification(title="Reciver Notification")
+notification = Notification(title="Receiver Notification")
 notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
 notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
 ```
@@ -269,7 +248,7 @@ Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
 
 n=Notification(title='Vibrate',channel_id='shake')
 n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate
+n.fVibrate() # To Force Vibrate (when user turned off in settings)
 n.send()
 ```
 
@@ -307,5 +286,9 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ Support the Project
 
-If you find this project helpful, your support would help me continue working on open-source projects
-[donate](https://www.buymeacoffee.com/fector101)
+If you find this project helpful, consider buying me a coffee! 😊  
+Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+
+<a href="https://www.buymeacoffee.com/fector101" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
+</a>

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/README.md

@@ -58,14 +58,9 @@ 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
+requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
-
-# Required dependency (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-android.api = 35
 ```
 
 </details>
@@ -75,7 +70,7 @@ android.api = 35
 <summary><b>Flet apps:</b></summary>
 <br/>
 
- In your `pyproject.toml` file, ensure you include the following:
+In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
@@ -91,35 +86,7 @@ dependencies = [
 
 </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.10.dev0` to install via `pip`
-
-<details>
-<summary><b>In Kivy</b></summary>
-<br/>
-
-```ini
-# buildozer.spec
-requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
-```
 
-</details>
 
 <details>
 
@@ -170,11 +137,23 @@ if __name__ == "__main__":
 </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>
 
 ## Documentation
-For Dev Version usage
+For Dev Version use
 ```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
 ```
 
 <details>
@@ -183,7 +162,7 @@ requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_noti
 - Make things happen without being in your app
 ```python
 from android_notify import Notification
-notification = Notification(title="Reciver Notification")
+notification = Notification(title="Receiver Notification")
 notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
 notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
 ```
@@ -246,7 +225,7 @@ Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
 
 n=Notification(title='Vibrate',channel_id='shake')
 n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate
+n.fVibrate() # To Force Vibrate (when user turned off in settings)
 n.send()
 ```
 
@@ -284,5 +263,9 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ Support the Project
 
-If you find this project helpful, your support would help me continue working on open-source projects
-[donate](https://www.buymeacoffee.com/fector101)
+If you find this project helpful, consider buying me a coffee! 😊  
+Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+
+<a href="https://www.buymeacoffee.com/fector101" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
+</a>

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/config.py

@@ -1,6 +1,7 @@
 import os
 
-__version__ = "1.60.10"
+__version__ = "1.60.10.dev0"
+
 
 from .internal.java_classes import autoclass, cast, NotificationManager
 from .internal.logger import logger

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/core.py

@@ -6,7 +6,7 @@ from android_notify.internal.logger import logger
 from android_notify.config import get_python_activity, on_android_platform, get_python_activity_context
 from android_notify.internal.permissions import has_notification_permission, ask_notification_permission
 from android_notify.internal.java_classes import autoclass, BuildVersion, BitmapFactory, NotificationChannel, NotificationManagerCompat, NotificationCompat, NotificationCompatBuilder, \
-    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle, IconCompat
+    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle
 
 
 
@@ -60,6 +60,7 @@ def get_image_uri(relative_path):
 
 def get_icon_object(uri):
     context = get_python_activity_context()
+    IconCompat = autoclass('android.graphics.drawable.Icon')
     bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
     return IconCompat.createWithBitmap(bitmap)
 
@@ -114,9 +115,7 @@ def send_notification(
         return None
     context = get_python_activity_context()
 
-
-    asks_permission_if_needed()
-
+    asks_permission_if_needed(legacy=True)
     channel_id = channel_name.replace(' ', '_').lower().lower() if not channel_id else channel_id
     # Get notification manager
     notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/internal/java_classes.py

@@ -39,31 +39,24 @@ if on_android_platform():
         Manifest = autoclass('android.Manifest$permission')
         Color = autoclass('android.graphics.Color')
         Context = autoclass('android.content.Context')
+        PackageManager = autoclass("android.content.pm.PackageManager")
     except Exception as e:
         from .facade import *
         logger.exception("Didn't get Basic Java Classes")
 
     # noinspection PyBroadException
     try:
-        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')
-        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
-        NotificationCompatBuilder = autoclass('androidx.core.app.NotificationCompat$Builder')
-        IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
-
-        # Notification Design
-        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:
-        logger.exception("""
-        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
-        """)
+        NotificationManagerCompat = NotificationManager # I need other files identical to main branch so it's easier to maintain
+        NotificationCompat = autoclass("android.app.Notification")
+        NotificationCompatBuilder = autoclass('android.app.Notification$Builder')
+        NotificationCompatBigTextStyle = autoclass('android.app.Notification$BigTextStyle')
+        NotificationCompatBigPictureStyle = autoclass('android.app.Notification$BigPictureStyle')
+        NotificationCompatInboxStyle = autoclass('android.app.Notification$InboxStyle')
 
+    except Exception as styles_import_error:
+        logger.exception(styles_import_error)
         from .facade import *
+
 else:
     cast = lambda x, y: x
     autoclass = lambda x: None

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/internal/permissions.py

@@ -5,7 +5,7 @@ import os.path
 
 from .logger import logger
 from android_notify.config import on_android_platform, on_flet_app, get_python_activity_context
-from android_notify.internal.java_classes import autoclass, BuildVersion, Manifest, Intent, String, Settings, Uri, NotificationManagerCompat
+from android_notify.internal.java_classes import autoclass, BuildVersion, Manifest, Intent, String, Settings, Uri, PackageManager, NotificationManagerCompat
 from android_notify.internal.helper import execute_callback
 
 
@@ -19,10 +19,10 @@ def has_notification_permission():
 
     if BuildVersion.SDK_INT < 33:  # Android 12 and below
         try:
+            # NotificationManagerCompat is actually NotificationManager from android_notify.internal.java_classes
             context = get_python_activity_context()
-            func_from = getattr(NotificationManagerCompat, "from")
-            compat_manager = func_from(context)
-            return compat_manager.areNotificationsEnabled()
+            nm = context.getSystemService(NotificationManagerCompat)
+            return nm.areNotificationsEnabled()
         except Exception as error_checking_permission:
             logger.exception(f"On Android 12 and below Error checking permission: {error_checking_permission}")
             return None
@@ -30,10 +30,8 @@ def has_notification_permission():
     if on_flet_app():
         context = get_python_activity_context()
         permission = Manifest.POST_NOTIFICATIONS
-        ContextCompat = autoclass('androidx.core.content.ContextCompat')
-        # if you get error `Failed to find class: androidx/core/app/ActivityCompat`
-        # in proguard-rules.pro add `-keep class androidx.core.app.ActivityCompat { *; }`
-        return ContextCompat.checkSelfPermission(context, permission)
+
+        return PackageManager.PERMISSION_GRANTED == context.checkSelfPermission(permission)
     else:
         from android.permissions import Permission, check_permission  # type: ignore
         return check_permission(Permission.POST_NOTIFICATIONS)
@@ -82,21 +80,10 @@ def ask_notification_permission(callback=None, set_requesting_state=None, legacy
         execute_callback(callback, grants[0])
         execute_callback(set_requesting_state, False,from_who="package")
 
-    if legacy:
+    if legacy or on_flet_app():
         # TODO Handle activity with request code
-        PackageManager = autoclass("android.content.pm.PackageManager")
-        permission = Manifest.POST_NOTIFICATIONS
-
-        granted = context.checkSelfPermission(permission)
-        if granted != PackageManager.PERMISSION_GRANTED:
-            context.requestPermissions([permission], 101)
-        return None
-    elif on_flet_app():
-        # TODO Callback when user answers request question
-        # Can't bind activity result method is from p4a which is only on kivy
-        ActivityCompat = autoclass('androidx.core.app.ActivityCompat')
         permission = Manifest.POST_NOTIFICATIONS
-        ActivityCompat.requestPermissions(context, [permission], 101)
+        context.requestPermissions([permission], 101)
         return None
     else:
         from android.permissions import request_permissions, Permission  # type: ignore

android_notify-1.60.10.dev0/android_notify/tests/flet/basic/src/core.py

@@ -0,0 +1,221 @@
+""" Non-Advanced Stuff """
+import random
+import os
+ON_ANDROID = False
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+def get_activity_class_name():
+    ACTIVITY_CLASS_NAME = os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME") # flet python
+    if not ACTIVITY_CLASS_NAME:
+        try:
+            from android import config
+            ACTIVITY_CLASS_NAME = getattr(config, "JAVA_NAMESPACE", None)
+        except (ImportError, AttributeError):
+            ACTIVITY_CLASS_NAME = 'org.kivy.android'
+    return ACTIVITY_CLASS_NAME
+
+try:
+
+    from jnius import autoclass # Needs Java to be installed
+    # Get the required Java classes
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    context = PythonActivity.mActivity # Get the app's context 
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')    
+    ON_ANDROID=True
+except Exception as e:
+    print('\nThis Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" to see design patterns and more info.\n')
+
+if ON_ANDROID:
+    try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')                                       
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+
+        # Notification Design
+        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')
+    except Exception as e:
+        print("""\n
+        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
+        * android.permissions = POST_NOTIFICATIONS\n
+        """)
+
+
+def get_app_root_path():
+    if on_flet_app():
+        return os.path.join(context.getFilesDir().getAbsolutePath(),'flet')
+    else:
+        from android.storage import app_storage_path # type: ignore
+        return app_storage_path()
+    
+def asks_permission_if_needed():
+    """
+    Ask for permission to send notifications if needed.
+    """
+    if on_flet_app():
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+        ContextCompat = autoclass('androidx.core.content.ContextCompat')
+        # if you get error `Failed to find class: androidx/core/app/ActivityCompat`
+        #in proguard-rules.pro add `-keep class androidx.core.app.ActivityCompat { *; }`
+        ActivityCompat = autoclass('androidx.core.app.ActivityCompat')
+        Manifest = autoclass('android.Manifest$permission')
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+
+        if BuildVersion.SDK_INT >= VERSION_CODES.TIRAMISU:
+            permission = Manifest.POST_NOTIFICATIONS
+            granted = ContextCompat.checkSelfPermission(context, permission)
+
+            if granted != 0:  # PackageManager.PERMISSION_GRANTED == 0
+                ActivityCompat.requestPermissions(context, [permission], 101)
+    else: # android package is from p4a which is for kivy
+        try:
+            from android.permissions import request_permissions, Permission,check_permission # type: ignore
+            permissions=[Permission.POST_NOTIFICATIONS]
+            if not all(check_permission(p) for p in permissions):
+                request_permissions(permissions)
+        except Exception as e:
+            print("android_notify- error trying to request notification access: ", e)
+
+def get_image_uri(relative_path):
+    """
+    Get the absolute URI for an image in the assets folder.
+    :param relative_path: The relative path to the image (e.g., 'assets/imgs/icon.png').
+    :return: Absolute URI java Object (e.g., 'file:///path/to/file.png').
+    """
+    app_root_path = get_app_root_path() 
+    output_path = os.path.join(app_root_path,'app', relative_path)
+    # print(output_path,'output_path')  # /data/user/0/org.laner.lan_ft/files/app/assets/imgs/icon.png
+    
+    if not os.path.exists(output_path):
+        raise FileNotFoundError(f"\nImage not found at path: {output_path}\n")
+    
+    Uri = autoclass('android.net.Uri')
+    return Uri.parse(f"file://{output_path}")
+
+def get_icon_object(uri):
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
+
+    bitmap= BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+    return IconCompat.createWithBitmap(bitmap)
+
+def insert_app_icon(builder,custom_icon_path):
+    if custom_icon_path:
+        try:
+            uri = get_image_uri(custom_icon_path)
+            icon = get_icon_object(uri)
+            builder.setSmallIcon(icon)
+        except Exception as e:
+            print('android_notify- error: ',e)
+            builder.setSmallIcon(context.getApplicationInfo().icon)
+    else:
+        print('Found res icon -->',context.getApplicationInfo().icon,'<--')
+        builder.setSmallIcon(context.getApplicationInfo().icon)
+
+def send_notification(
+    title:str,
+    message:str,
+    style=None,
+    img_path=None,
+    channel_name="Default Channel",
+    channel_id:str="default_channel",
+    custom_app_icon_path="",
+
+    big_picture_path='',
+    large_icon_path='',
+    big_text="",
+    lines=""
+    ):
+    """
+    Send a notification on Android.
+
+    :param title: Title of the notification.
+    :param message: Message body.
+    :param style: Style of the notification ('big_text', 'big_picture', 'inbox', 'large_icon').
+    :param img_path: Path to the image resource.
+    :param channel_id: Notification channel ID.(Default is lowercase channel name arg in lowercase)
+    """
+    if not ON_ANDROID:
+        print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" for Documentation.')
+        return
+
+    asks_permission_if_needed()
+    channel_id=channel_name.replace(' ','_').lower().lower() if not channel_id else channel_id
+    # Get notification manager
+    notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
+
+    # importance= autoclass('android.app.NotificationManager').IMPORTANCE_HIGH # also works #NotificationManager.IMPORTANCE_DEFAULT
+    importance= NotificationManagerCompat.IMPORTANCE_HIGH #autoclass('android.app.NotificationManager').IMPORTANCE_HIGH also works #NotificationManager.IMPORTANCE_DEFAULT
+
+    # Notification Channel (Required for Android 8.0+)
+    if BuildVersion.SDK_INT >= 26:
+        channel = NotificationChannel(channel_id, channel_name,importance)
+        notification_manager.createNotificationChannel(channel)
+
+    # Build the notification
+    builder = NotificationCompatBuilder(context, channel_id)
+    builder.setContentTitle(title)
+    builder.setContentText(message)
+    insert_app_icon(builder,custom_app_icon_path)
+    builder.setDefaults(NotificationCompat.DEFAULT_ALL)
+    builder.setPriority(NotificationCompat.PRIORITY_HIGH)
+
+    if img_path:
+        print('android_notify- img_path arg deprecated use "large_icon_path or big_picture_path or custom_app_icon_path"instead ')
+
+    big_picture = None
+    if big_picture_path:
+        try:
+            big_picture = get_image_uri(big_picture_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for big_picture_path: ',e)
+
+    large_icon = None
+    if large_icon_path:
+        try:
+            large_icon = get_image_uri(large_icon_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for large_icon_path: ',e)
+
+
+    # Apply notification styles
+    try:
+        if big_text:
+            big_text_style = NotificationCompatBigTextStyle()
+            big_text_style.bigText(big_text)
+            builder.setStyle(big_text_style)
+
+        elif lines:
+            inbox_style = NotificationCompatInboxStyle()
+            for line in lines.split("\n"):
+                inbox_style.addLine(line)
+            builder.setStyle(inbox_style)
+
+        if large_icon:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(large_icon))
+            builder.setLargeIcon(bitmap)
+
+        if big_picture:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(big_picture))
+            builder.setLargeIcon(bitmap)
+            big_picture_style = NotificationCompatBigPictureStyle().bigPicture(bitmap)
+            builder.setStyle(big_picture_style)
+
+    except Exception as e:
+        print('android_notify- Error Failed Adding Style: ',e)
+    # Display the notification
+    notification_id = random.randint(0, 100)
+    notification_manager.notify(notification_id, builder.build())
+    return notification_id
+

android_notify-1.60.10.dev0/android_notify/tests/flet/flet-working/src/core.py

@@ -0,0 +1,221 @@
+""" Non-Advanced Stuff """
+import random
+import os
+ON_ANDROID = False
+
+def on_flet_app():
+    return os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME")
+
+def get_activity_class_name():
+    ACTIVITY_CLASS_NAME = os.getenv("MAIN_ACTIVITY_HOST_CLASS_NAME") # flet python
+    if not ACTIVITY_CLASS_NAME:
+        try:
+            from android import config
+            ACTIVITY_CLASS_NAME = getattr(config, "JAVA_NAMESPACE", None)
+        except (ImportError, AttributeError):
+            ACTIVITY_CLASS_NAME = 'org.kivy.android'
+    return ACTIVITY_CLASS_NAME
+
+try:
+
+    from jnius import autoclass # Needs Java to be installed
+    # Get the required Java classes
+    ACTIVITY_CLASS_NAME = get_activity_class_name()
+    PythonActivity = autoclass(ACTIVITY_CLASS_NAME)
+    context = PythonActivity.mActivity # Get the app's context 
+    NotificationChannel = autoclass('android.app.NotificationChannel')
+    String = autoclass('java.lang.String')
+    Intent = autoclass('android.content.Intent')
+    PendingIntent = autoclass('android.app.PendingIntent')
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    BuildVersion = autoclass('android.os.Build$VERSION')    
+    ON_ANDROID=True
+except Exception as e:
+    print('\nThis Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" to see design patterns and more info.\n')
+
+if ON_ANDROID:
+    try:
+        NotificationManagerCompat = autoclass('androidx.core.app.NotificationManagerCompat')                                       
+        NotificationCompat = autoclass('androidx.core.app.NotificationCompat')
+
+        # Notification Design
+        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')
+    except Exception as e:
+        print("""\n
+        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
+        * android.permissions = POST_NOTIFICATIONS\n
+        """)
+
+
+def get_app_root_path():
+    if on_flet_app():
+        return os.path.join(context.getFilesDir().getAbsolutePath(),'flet')
+    else:
+        from android.storage import app_storage_path # type: ignore
+        return app_storage_path()
+    
+def asks_permission_if_needed():
+    """
+    Ask for permission to send notifications if needed.
+    """
+    if on_flet_app():
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+        ContextCompat = autoclass('androidx.core.content.ContextCompat')
+        # if you get error `Failed to find class: androidx/core/app/ActivityCompat`
+        #in proguard-rules.pro add `-keep class androidx.core.app.ActivityCompat { *; }`
+        ActivityCompat = autoclass('androidx.core.app.ActivityCompat')
+        Manifest = autoclass('android.Manifest$permission')
+        VERSION_CODES = autoclass('android.os.Build$VERSION_CODES')
+
+        if BuildVersion.SDK_INT >= VERSION_CODES.TIRAMISU:
+            permission = Manifest.POST_NOTIFICATIONS
+            granted = ContextCompat.checkSelfPermission(context, permission)
+
+            if granted != 0:  # PackageManager.PERMISSION_GRANTED == 0
+                ActivityCompat.requestPermissions(context, [permission], 101)
+    else: # android package is from p4a which is for kivy
+        try:
+            from android.permissions import request_permissions, Permission,check_permission # type: ignore
+            permissions=[Permission.POST_NOTIFICATIONS]
+            if not all(check_permission(p) for p in permissions):
+                request_permissions(permissions)
+        except Exception as e:
+            print("android_notify- error trying to request notification access: ", e)
+
+def get_image_uri(relative_path):
+    """
+    Get the absolute URI for an image in the assets folder.
+    :param relative_path: The relative path to the image (e.g., 'assets/imgs/icon.png').
+    :return: Absolute URI java Object (e.g., 'file:///path/to/file.png').
+    """
+    app_root_path = get_app_root_path() 
+    output_path = os.path.join(app_root_path,'app', relative_path)
+    # print(output_path,'output_path')  # /data/user/0/org.laner.lan_ft/files/app/assets/imgs/icon.png
+    
+    if not os.path.exists(output_path):
+        raise FileNotFoundError(f"\nImage not found at path: {output_path}\n")
+    
+    Uri = autoclass('android.net.Uri')
+    return Uri.parse(f"file://{output_path}")
+
+def get_icon_object(uri):
+    BitmapFactory = autoclass('android.graphics.BitmapFactory')
+    IconCompat = autoclass('androidx.core.graphics.drawable.IconCompat')
+
+    bitmap= BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
+    return IconCompat.createWithBitmap(bitmap)
+
+def insert_app_icon(builder,custom_icon_path):
+    if custom_icon_path:
+        try:
+            uri = get_image_uri(custom_icon_path)
+            icon = get_icon_object(uri)
+            builder.setSmallIcon(icon)
+        except Exception as e:
+            print('android_notify- error: ',e)
+            builder.setSmallIcon(context.getApplicationInfo().icon)
+    else:
+        print('Found res icon -->',context.getApplicationInfo().icon,'<--')
+        builder.setSmallIcon(context.getApplicationInfo().icon)
+
+def send_notification(
+    title:str,
+    message:str,
+    style=None,
+    img_path=None,
+    channel_name="Default Channel",
+    channel_id:str="default_channel",
+    custom_app_icon_path="",
+
+    big_picture_path='',
+    large_icon_path='',
+    big_text="",
+    lines=""
+    ):
+    """
+    Send a notification on Android.
+
+    :param title: Title of the notification.
+    :param message: Message body.
+    :param style: Style of the notification ('big_text', 'big_picture', 'inbox', 'large_icon').
+    :param img_path: Path to the image resource.
+    :param channel_id: Notification channel ID.(Default is lowercase channel name arg in lowercase)
+    """
+    if not ON_ANDROID:
+        print('This Package Only Runs on Android !!! ---> Check "https://github.com/Fector101/android_notify/" for Documentation.')
+        return
+
+    asks_permission_if_needed()
+    channel_id=channel_name.replace(' ','_').lower().lower() if not channel_id else channel_id
+    # Get notification manager
+    notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)
+
+    # importance= autoclass('android.app.NotificationManager').IMPORTANCE_HIGH # also works #NotificationManager.IMPORTANCE_DEFAULT
+    importance= NotificationManagerCompat.IMPORTANCE_HIGH #autoclass('android.app.NotificationManager').IMPORTANCE_HIGH also works #NotificationManager.IMPORTANCE_DEFAULT
+
+    # Notification Channel (Required for Android 8.0+)
+    if BuildVersion.SDK_INT >= 26:
+        channel = NotificationChannel(channel_id, channel_name,importance)
+        notification_manager.createNotificationChannel(channel)
+
+    # Build the notification
+    builder = NotificationCompatBuilder(context, channel_id)
+    builder.setContentTitle(title)
+    builder.setContentText(message)
+    insert_app_icon(builder,custom_app_icon_path)
+    builder.setDefaults(NotificationCompat.DEFAULT_ALL)
+    builder.setPriority(NotificationCompat.PRIORITY_HIGH)
+
+    if img_path:
+        print('android_notify- img_path arg deprecated use "large_icon_path or big_picture_path or custom_app_icon_path"instead ')
+
+    big_picture = None
+    if big_picture_path:
+        try:
+            big_picture = get_image_uri(big_picture_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for big_picture_path: ',e)
+
+    large_icon = None
+    if large_icon_path:
+        try:
+            large_icon = get_image_uri(large_icon_path)
+        except FileNotFoundError as e:
+            print('android_notify- Error Getting Uri for large_icon_path: ',e)
+
+
+    # Apply notification styles
+    try:
+        if big_text:
+            big_text_style = NotificationCompatBigTextStyle()
+            big_text_style.bigText(big_text)
+            builder.setStyle(big_text_style)
+
+        elif lines:
+            inbox_style = NotificationCompatInboxStyle()
+            for line in lines.split("\n"):
+                inbox_style.addLine(line)
+            builder.setStyle(inbox_style)
+
+        if large_icon:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(large_icon))
+            builder.setLargeIcon(bitmap)
+
+        if big_picture:
+            bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(big_picture))
+            builder.setLargeIcon(bitmap)
+            big_picture_style = NotificationCompatBigPictureStyle().bigPicture(bitmap)
+            builder.setStyle(big_picture_style)
+
+    except Exception as e:
+        print('android_notify- Error Failed Adding Style: ',e)
+    # Display the notification
+    notification_id = random.randint(0, 100)
+    notification_manager.notify(notification_id, builder.build())
+    return notification_id
+

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/widgets/images.py

@@ -4,7 +4,7 @@ For image related things
 import os
 
 from android_notify.config import app_storage_path, on_flet_app, on_android_platform, get_python_activity_context
-from android_notify.internal.java_classes import autoclass, BitmapFactory, Uri, BuildVersion, Color, IconCompat
+from android_notify.internal.java_classes import autoclass, BitmapFactory, Uri, BuildVersion, Color
 from android_notify.internal.helper import get_package_path
 from android_notify.internal.logger import logger
 
@@ -128,6 +128,7 @@ def set_small_icon_with_bitmap(bitmap, builder):
         logger.warning("Bitmap Insert as Icon Not available below Android 6")
         return False
     try:
+        IconCompat = autoclass('android.graphics.drawable.Icon')
         icon = IconCompat.createWithBitmap(bitmap)
         builder.setSmallIcon(icon)
         return True

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify/widgets/texts.py

@@ -106,7 +106,7 @@ def set_lines(builder, lines):
 
 
 
-from android_notify.internal.java_classes import Color, RemoteViews, NotificationCompatDecoratedCustomViewStyle
+from android_notify.internal.java_classes import Color, RemoteViews
 from android_notify.internal.logger import logger
 from android_notify.config import get_python_activity_context
 
@@ -121,6 +121,10 @@ def setLayoutText(layout, text_id, text, color):
 
 def set_custom_colors(builder, title, message, title_color, message_color):
     # Load layout
+    from android_notify.internal.java_classes import autoclass
+    NotificationCompatDecoratedCustomViewStyle = autoclass(
+        'android.app.Notification$DecoratedCustomViewStyle')
+
     context = get_python_activity_context()
     resources = context.getResources()
     package_name = context.getPackageName()

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.60.10
+Version: 1.60.10.dev0
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -81,14 +81,9 @@ 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
+requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
-
-# Required dependency (write exactly as shown, no quotation marks)
-android.gradle_dependencies = androidx.core:core-ktx:1.15.0
-android.enable_androidx = True
-android.api = 35
 ```
 
 </details>
@@ -98,7 +93,7 @@ android.api = 35
 <summary><b>Flet apps:</b></summary>
 <br/>
 
- In your `pyproject.toml` file, ensure you include the following:
+In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
@@ -114,35 +109,7 @@ dependencies = [
 
 </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.10.dev0` to install via `pip`
-
-<details>
-<summary><b>In Kivy</b></summary>
-<br/>
-
-```ini
-# buildozer.spec
-requirements = python3, kivy, pyjnius, android-notify==1.60.10.dev0
-```
 
-</details>
 
 <details>
 
@@ -193,11 +160,23 @@ if __name__ == "__main__":
 </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>
 
 ## Documentation
-For Dev Version usage
+For Dev Version use
 ```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
 ```
 
 <details>
@@ -206,7 +185,7 @@ requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_noti
 - Make things happen without being in your app
 ```python
 from android_notify import Notification
-notification = Notification(title="Reciver Notification")
+notification = Notification(title="Receiver Notification")
 notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
 notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
 ```
@@ -269,7 +248,7 @@ Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
 
 n=Notification(title='Vibrate',channel_id='shake')
 n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate
+n.fVibrate() # To Force Vibrate (when user turned off in settings)
 n.send()
 ```
 
@@ -307,5 +286,9 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ Support the Project
 
-If you find this project helpful, your support would help me continue working on open-source projects
-[donate](https://www.buymeacoffee.com/fector101)
+If you find this project helpful, consider buying me a coffee! 😊  
+Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+
+<a href="https://www.buymeacoffee.com/fector101" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
+</a>

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/android_notify.egg-info/SOURCES.txt

@@ -41,7 +41,9 @@ android_notify/tests/test_notification_styles.py
 android_notify/tests/flet/adv/main.py
 android_notify/tests/flet/adv/tests/__init__.py
 android_notify/tests/flet/adv/tests/test_android_notify_full.py
+android_notify/tests/flet/basic/src/core.py
 android_notify/tests/flet/basic/src/main.py
+android_notify/tests/flet/flet-working/src/core.py
 android_notify/tests/flet/flet-working/src/main.py
 android_notify/tests/p4a/hook.py
 android_notify/tests/serivces/wallpaper.py

{android_notify-1.60.10 → android_notify-1.60.10.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "android-notify"
-version = "1.60.10"
+version = "1.60.10.dev0"
 description = "A Python package that simplifies creating Android notifications in Kivy and Flet apps."
 readme = { file = "README.md", content-type = "text/markdown" }
 authors = [