android-widgets 0.1.0__py3-none-any.whl

android-widgets/__init__.py

@@ -0,0 +1,5 @@
+def hello():
+    """
+    Simple hello function for testing the package.
+    """
+    return "Hello from android-widgets!"

android_widgets-0.1.0.dist-info/METADATA

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: android-widgets
+Version: 0.1.0
+Summary: A simple hello world package for Kivy Android widgets.
+Author-email: Fabian <fector101@yahoo.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/kivy-androidwidgets
+Project-URL: Documentation, https://github.com/yourusername/kivy-androidwidgets
+Project-URL: Source, https://github.com/yourusername/kivy-androidwidgets
+Project-URL: Tracker, https://github.com/yourusername/kivy-androidwidgets/issues
+Keywords: kivy,android,widgets,hello-world,python-package
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Android
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: kivy>=2.0.0
+
+Kivy-androidwidgets
+---
+This repo contains how to create An Android Widget.  
+Complete Sample: [working app](https://github.com/Fector101/wallpaper-carousel)
+
+5 Steps For a simple widget
+---
+
+step 1: First you Design How you want the Widget to Look [it's Layout].   
+Store it in: `res/layout/simple_widget.xml`
+This a simple widget with a text
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:orientation="vertical"
+    android:padding="10dp"
+    android:background="#FFFFFF"
+    android:gravity="center"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content">
+
+    <TextView
+        android:id="@+id/widget_text"
+        android:text="Loading..."
+        android:textSize="18sp"
+        android:textColor="#000"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"/>
+
+</LinearLayout>
+```
+step 2: Create an xml containing the info about the widget.  
+Like: size, preview icon and others   
+path: `res/xml/widgetproviderinfo.xml`
+```xml
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+    android:minWidth="120dp"
+    android:minHeight="60dp"
+    android:updatePeriodMillis="1800000"
+    android:initialLayout="@layout/simple_widget"
+    android:previewImage="@drawable/ic_launcher_foreground"
+    android:resizeMode="horizontal|vertical"
+    android:widgetCategory="home_screen">
+</appwidget-provider>
+```
+Create preview image png in right path`res/drawable/ic_launcher_foreground.png`
+
+step 3: Create a `AppWidgetProvider` it's used to receive events for widget.   
+path: `src/SimpleWidget.java`.  
+This will receive an event when widget is add to change it's text
+
+```java
+package org.wally.waller; // Change here from buildozer.spec package.domain+package.name
+
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.Context;
+import android.widget.RemoteViews;
+
+import org.wally.waller.R; // Change here from buildozer.spec package.domain+package.name
+import android.app.PendingIntent;
+import android.content.Intent;
+
+public class SimpleWidget extends AppWidgetProvider {
+
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        for (int appWidgetId : appWidgetIds) {
+
+            RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.simple_widget);
+
+            // Example: Set text
+            views.setTextViewText(R.id.widget_text, "Hello Widget!");
+
+            // Update widget
+            appWidgetManager.updateAppWidget(appWidgetId, views);
+        }
+    }
+}
+```
+Step 4: Automate injecting Receiver in XML
+
+path:`p4a/hook.py`
+
+```py
+from pathlib import Path
+from pythonforandroid.toolchain import ToolchainCL
+
+
+def after_apk_build(toolchain: ToolchainCL):
+    manifest_file = Path(toolchain._dist.dist_dir) / "src" / "main" / "AndroidManifest.xml"
+    text = manifest_file.read_text(encoding="utf-8")
+
+    package = "org.wally.waller"
+    receiver_xml = f'''
+    <receiver android:name="{package}.SimpleWidget"
+              android:enabled="true"
+              android:exported="false">
+        <intent-filter>
+            <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+        </intent-filter>
+        <meta-data android:name="android.appwidget.provider"
+               android:resource="@xml/widgetproviderinfo" />
+    </receiver>
+    '''
+
+    if receiver_xml.strip() not in text:
+        if "</application>" in text:
+            text = text.replace("</application>", f"{receiver_xml}\n</application>")
+            print("Receiver added")
+        else: 
+            print("Could not find </application> to insert receiver")
+    else: 
+        print("Receiver already exists in manifest")
+
+    manifest_file.write_text(text, encoding="utf-8")
+    print("Successfully_101: Manifest update completed successfully!")
+
+```
+Step 5: From `buildozer.spec` tell it you want to add resources, src and p4a hook
+```ini
+android.add_resources = res
+android.add_src = src
+p4a.hook = p4a/hook.py
+```
+
+For More widget customisation check: [How to Customise.md](how-to-customise.md)
+---
+
+Sample Image:
+
+![Rounded corners widget](https://raw.githubusercontent.com/Fector101/kivy-androidwidgets/main/imgs/not-rounded.jpg)

android_widgets-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+android-widgets/__init__.py,sha256=WRXI9lN_Tlq-ftohOfB-VEh3XB6F-hpMJYdBDlY-HZc,121
+android_widgets-0.1.0.dist-info/METADATA,sha256=czVholrwp-n36GiAxmMZBd0c2uvP257wP2HOla_eUyw,5288
+android_widgets-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+android_widgets-0.1.0.dist-info/top_level.txt,sha256=O-3FCfvkKVwYHV4lw2MnTOkWhaV4HtQ3NXxkMDU0aS4,16
+android_widgets-0.1.0.dist-info/RECORD,,

android_widgets-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

android_widgets-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+android-widgets