Risoluzione problemi plugin
Questa pagina segue il percorso reale Hub → pacchetto firmato → Core. Non aggirare un controllo fallito modificando manualmente l’archivio: correggi la causa e genera una nuova evidenza verificabile.
Il pacchetto viene rifiutato all’upload
Sezione intitolata “Il pacchetto viene rifiutato all’upload”Controlla che:
- l’archivio sia
.tar.gze non contenga path assoluti o..; plugin.source.jsoneplugin.jsonsiano entrambi nella root del plugin;- lo
nametecnico coincida con lo slug registrato nell’Hub; - la versione passata a
package.shusi il formatox.y.z; - non siano presenti cache, test,
__MACOSXo file AppleDouble._*.
Non eliminare plugin.json: il packager lo mantiene e l’Hub lo sostituisce con
il manifest effettivo prima della firma.
La scansione resta in corso
Sezione intitolata “La scansione resta in corso”Il pannello Developer aggiorna lo stato della scansione asincrona. Attendi il completamento prima di inviare la review. Se il job termina senza un esito conclusivo, usa Riesegui scan quando l’azione è disponibile.
Un errore di Bandit, pip-audit o del worker non equivale a «nessun finding»:
l’Hub opera in modalità fail-closed e blocca l’invio finché tutti gli scanner
obbligatori non hanno prodotto un risultato valido.
Lo scan segnala file ._nome.py
Sezione intitolata “Lo scan segnala file ._nome.py”Sono metadata AppleDouble creati da macOS, non sorgenti Python. Rigenera il
pacchetto con lo script ufficiale aggiornato: usa COPYFILE_DISABLE=1 e scarta
._* e __MACOSX. Non approvare ignorando l’errore del parser.
Non posso modificare una versione
Sezione intitolata “Non posso modificare una versione”Una versione pending_review è bloccata per garantire che il reviewer esamini
gli stessi byte e metadata inviati dall’autore. Ritirala quando l’azione è
consentita oppure attendi una richiesta di modifica/rifiuto e prepara la bozza
corretta. Le versioni approvate non vengono riscritte in place.
La versione Beta non compare nel Core
Sezione intitolata “La versione Beta non compare nel Core”Verifica che:
- la versione sia stata approvata nel canale
beta, non sia ancoradraftopending_review; - la licenza attiva includa l’abilitazione
plugin_beta; - il Core abbia aggiornato il catalogo dopo la pubblicazione;
- la versione minima/massima del Core sia compatibile.
La promozione beta → stable è una decisione del backoffice e non richiede al
developer di sostituire l’archivio già firmato. Una correzione dei byte richiede
invece una nuova versione e una nuova review.
Firma o checksum non validi
Sezione intitolata “Firma o checksum non validi”Il Core verifica SHA-256, firma RSA-PSS e keyid con il trust set ricevuto
dalla licenza Hub. Non installare il pacchetto forzando la verifica. Aggiorna la
licenza/catalogo e riprova; se il problema persiste, conserva versione, keyid
e log di verifica e inviali al supporto senza includere activation key o token.
L’aggiornamento richiede un riavvio
Sezione intitolata “L’aggiornamento richiede un riavvio”È previsto quando cambiano codice backend, bundle frontend o pacchetti di sistema. Completa il riavvio proposto dal Core e verifica che il plugin risulti Attivo alla nuova versione. In caso di errore, raccogli i log del plugin e del bootstrap prima di riprovare.
Ritiro e sospensione
Sezione intitolata “Ritiro e sospensione”Il developer può richiedere la disattivazione dal pannello; il backoffice conserva storico e audit. La sospensione dell’autore blocca nuove operazioni ma non cancella silenziosamente plugin, versioni o download già registrati.
Per una vulnerabilità attiva segnala subito versione e impatto al team XIQUIL: il ritiro dal catalogo e l’eventuale comunicazione agli utenti devono essere coordinati, non affidati a una modifica editoriale.