|
1 | 1 | # ------------------------------------------------------------------- |
2 | | -# Broadcast receiver bridge |
| 2 | +# Broadcast receiver bridge for Kivy + Pyjnius |
| 3 | +# Safe start/stop with Android lifecycle integration |
| 4 | +# ------------------------------------------------------------------- |
3 | 5 |
|
4 | 6 | from jnius import autoclass, PythonJavaClass, java_method |
5 | 7 | from android.config import JAVA_NAMESPACE, JNI_NAMESPACE, ACTIVITY_CLASS_NAME, SERVICE_CLASS_NAME |
6 | 8 |
|
7 | 9 |
|
8 | | -class BroadcastReceiver(object): |
9 | | - |
| 10 | +class BroadcastReceiver: |
10 | 11 | class Callback(PythonJavaClass): |
11 | 12 | __javainterfaces__ = [JNI_NAMESPACE + '/GenericBroadcastReceiverCallback'] |
12 | 13 | __javacontext__ = 'app' |
13 | 14 |
|
14 | 15 | def __init__(self, callback, *args, **kwargs): |
15 | 16 | self.callback = callback |
16 | | - PythonJavaClass.__init__(self, *args, **kwargs) |
| 17 | + super().__init__(*args, **kwargs) |
17 | 18 |
|
18 | 19 | @java_method('(Landroid/content/Context;Landroid/content/Intent;)V') |
19 | 20 | def onReceive(self, context, intent): |
20 | 21 | self.callback(context, intent) |
21 | 22 |
|
22 | 23 | def __init__(self, callback, actions=None, categories=None): |
23 | | - super().__init__() |
24 | | - self.callback = callback |
25 | | - |
26 | 24 | if not actions and not categories: |
27 | 25 | raise Exception('You need to define at least actions or categories') |
28 | 26 |
|
29 | | - def _expand_partial_name(partial_name): |
30 | | - if '.' in partial_name: |
31 | | - return partial_name # Its actually a full dotted name |
32 | | - else: |
33 | | - name = 'ACTION_{}'.format(partial_name.upper()) |
34 | | - if not hasattr(Intent, name): |
35 | | - raise Exception('The intent {} does not exist'.format(name)) |
36 | | - return getattr(Intent, name) |
| 27 | + self.callback = callback |
| 28 | + self._is_registered = False |
| 29 | + self._handlerthread_started = False |
37 | 30 |
|
38 | | - # resolve actions/categories first |
| 31 | + # Expand intent names |
39 | 32 | Intent = autoclass('android.content.Intent') |
40 | | - resolved_actions = [_expand_partial_name(x) for x in actions or []] |
41 | | - resolved_categories = [_expand_partial_name(x) for x in categories or []] |
42 | | - |
43 | | - # resolve android API |
44 | | - GenericBroadcastReceiver = autoclass(JAVA_NAMESPACE + '.GenericBroadcastReceiver') |
45 | | - IntentFilter = autoclass('android.content.IntentFilter') |
46 | | - HandlerThread = autoclass('android.os.HandlerThread') |
47 | 33 |
|
48 | | - # create a thread for handling events from the receiver |
49 | | - self.handlerthread = HandlerThread('handlerthread') |
50 | | - |
51 | | - # create a listener |
| 34 | + def _expand(partial): |
| 35 | + if '.' in partial: |
| 36 | + return partial |
| 37 | + name = 'ACTION_' + partial.upper() |
| 38 | + if not hasattr(Intent, name): |
| 39 | + raise Exception(f'Intent {name} does not exist') |
| 40 | + return getattr(Intent, name) |
| 41 | + |
| 42 | + self.resolved_actions = [_expand(a) for a in actions or []] |
| 43 | + self.resolved_categories = [_expand(c) for c in categories or []] |
| 44 | + |
| 45 | + # Java classes |
| 46 | + self.GenericBroadcastReceiver = autoclass(JAVA_NAMESPACE + '.GenericBroadcastReceiver') |
| 47 | + self.IntentFilter = autoclass('android.content.IntentFilter') |
| 48 | + self.Handler = autoclass('android.os.Handler') |
| 49 | + self.HandlerThreadClass = autoclass('android.os.HandlerThread') |
| 50 | + |
| 51 | + # Build filter |
| 52 | + self.receiver_filter = self.IntentFilter() |
| 53 | + for action in self.resolved_actions: |
| 54 | + self.receiver_filter.addAction(action) |
| 55 | + for category in self.resolved_categories: |
| 56 | + self.receiver_filter.addCategory(category) |
| 57 | + |
| 58 | + # Receiver and callback |
52 | 59 | self.listener = BroadcastReceiver.Callback(self.callback) |
53 | | - self.receiver = GenericBroadcastReceiver(self.listener) |
54 | | - self.receiver_filter = IntentFilter() |
55 | | - for x in resolved_actions: |
56 | | - self.receiver_filter.addAction(x) |
57 | | - for x in resolved_categories: |
58 | | - self.receiver_filter.addCategory(x) |
| 60 | + self.receiver = self.GenericBroadcastReceiver(self.listener) |
| 61 | + |
| 62 | + # Init thread placeholder |
| 63 | + self.handlerthread = None |
| 64 | + self.handler = None |
59 | 65 |
|
60 | 66 | def start(self): |
61 | | - Handler = autoclass('android.os.Handler') |
62 | | - self.handlerthread.start() |
63 | | - self.handler = Handler(self.handlerthread.getLooper()) |
64 | | - self.context.registerReceiver( |
65 | | - self.receiver, self.receiver_filter, None, self.handler) |
| 67 | + if self._is_registered: |
| 68 | + print("[BroadcastReceiver] Already registered.") |
| 69 | + return |
| 70 | + |
| 71 | + if not self._handlerthread_started: |
| 72 | + self.handlerthread = self.HandlerThreadClass('BroadcastReceiverThread') |
| 73 | + try: |
| 74 | + self.handlerthread.start() |
| 75 | + self._handlerthread_started = True |
| 76 | + except Exception as e: |
| 77 | + print(f"[BroadcastReceiver] HandlerThread start failed: {e}") |
| 78 | + return |
| 79 | + |
| 80 | + try: |
| 81 | + self.handler = self.Handler(self.handlerthread.getLooper()) |
| 82 | + self.context.registerReceiver(self.receiver, self.receiver_filter, None, self.handler) |
| 83 | + self._is_registered = True |
| 84 | + print("[BroadcastReceiver] Registered.") |
| 85 | + except Exception as e: |
| 86 | + print(f"[BroadcastReceiver] registerReceiver failed: {e}") |
66 | 87 |
|
67 | 88 | def stop(self): |
68 | | - self.context.unregisterReceiver(self.receiver) |
69 | | - self.handlerthread.quit() |
| 89 | + if self._is_registered: |
| 90 | + try: |
| 91 | + self.context.unregisterReceiver(self.receiver) |
| 92 | + print("[BroadcastReceiver] Unregistered.") |
| 93 | + except Exception as e: |
| 94 | + print(f"[BroadcastReceiver] unregisterReceiver failed: {e}") |
| 95 | + self._is_registered = False |
| 96 | + |
| 97 | + if self._handlerthread_started: |
| 98 | + try: |
| 99 | + self.handlerthread.quitSafely() |
| 100 | + print("[BroadcastReceiver] HandlerThread quit safely.") |
| 101 | + except Exception as e: |
| 102 | + print(f"[BroadcastReceiver] thread quit failed: {e}") |
| 103 | + self._handlerthread_started = False |
| 104 | + self.handlerthread = None |
| 105 | + self.handler = None |
70 | 106 |
|
71 | 107 | @property |
72 | 108 | def context(self): |
|
0 commit comments