fix: make cash drawer failures visible and service binding recoverable

[FrenkyDema]

Il problema

L'app di esempio non si avviava sui dispositivi Android 11+: BIND_SERVICE non si risolveva mai, quindi await bindingService() prima di runApp() restava appeso all'infinito e la UI non compariva.

Diagnosticato su un Sunmi D3 (Android 14, targetSdk 36). Due cause in cascata:

1. Package visibility. Senza una dichiarazione <queries> il servizio Sunmi è invisibile all'app, quindi bindService() ritorna false:

AppsFilter: ...sunmi_task_printer_example -> woyou.aidlservice.jiuiv5 BLOCKED
ActivityManager: Unable to start service Intent { act=woyou.aidlservice.jiuiv5.IWoyouService
                 pkg=woyou.aidlservice.jiuiv5 } U=0: not found

Il servizio è installato e funzionante sul device — semplicemente l'app non poteva vederlo. La dichiarazione ora sta nel manifest del plugin, così le app host la ereditano dal manifest merger senza doversene ricordare.

2. Il Result pendente non veniva mai completato. Era risolto solo da onServiceConnected, che non viene mai invocato se il bind è rifiutato. Ora ogni via d'uscita lo completa: ritorno false di bindService(), SecurityException, onNullBinding, onBindingDied.

Perché tocca il cassetto

Lo stesso stato di binding morto è esattamente ciò che si osserva quando il cassetto non si apre, e il plugin lo mascherava:

• openDrawer() risolveva success(true) appena la chiamata AIDL era stata dispatchata, passando un callback dummy che scartava onRunResult e onRaiseException. Un kick rifiutato dal firmware veniva riportato come riuscito.
• drawerStatus() e drawerTimesOpen() ritornavano false / 0 quando il servizio era irraggiungibile — indistinguibile da un cassetto semplicemente non collegato, il che sposta la diagnosi sull'hardware invece che sul binding.

Modifiche

• Breaking: openDrawer() si completa solo quando il firmware conferma il kick; in caso contrario lancia PlatformException con codice OPERATION_FAILED, PRINTER_EXCEPTION, UNAVAILABLE o TIMEOUT.
• Breaking: drawerStatus() e drawerTimesOpen() lanciano PlatformException con codice UNAVAILABLE invece di riportare hardware assente.
• Aggiunte le <queries> per woyou.aidlservice.jiuiv5 al manifest del plugin.
• BIND_SERVICE si risolve sempre, su ogni percorso.
• Riconnessione dopo onBindingDied, e i comandi che trovano il servizio mancante schedulano un reconnect. Prima un riavvio del servizio Sunmi lasciava il plugin rotto in modo permanente fino al riavvio dell'app host.
• unbindService() rilascia anche un bind richiesto ma mai completato (era un leak), e il plugin fa cleanup sul detach dell'engine.
• I callback AIDL in volo sono tenuti con una reference forte, così non vengono garbage collected prima della risposta della stampante, con timeout di 5s.
• L'esempio non blocca più runApp() sul binding.

Verifica

Sul D3 (D402P5CCJ1651), dopo il fix:

[SunmiDebug] Service binding returned: true
[SunmiDebug] Metadata fetched successfully. Size: 80, Version: 1.04, Serial: B97E3BCA...

• Apertura fisica del cassetto verificata sull'hardware.
• flutter test 11/11 verdi, inclusi due nuovi test sui percorsi di errore del cassetto.
• flutter analyze pulito a parte un unnecessary_library_name preesistente in lib/enums.dart.

Note

• Versione portata a 0.2.0 per il breaking change.
• Resta un percorso silenzioso non toccato in questa PR: getPrinterStatus() ritorna PrinterStatus.ERROR quando il servizio è irraggiungibile, senza distinguerlo da un errore reale della stampante.