Creatore di Add-in
Il Creatore di Add-in le permette di creare e modificare facilmente i pacchetti Add-in di RoboDK. Lo strumento Creatore di Add-in fa parte del Gestore di Add-in.
Il Creatore di Add-in può essere aperto selezionando Strumenti-Gestione Add-in e cliccando sul pulsante Crea Add-in in fondo alla Gestione Add-in.
Quando apre la procedura guidata Add-in Creator, può scegliere tra le seguenti opzioni:
●Creare un nuovo Add-in da zero: questo darà luogo a un nuovo pacchetto RoboDK (file RDKP).
●Crea nuovo add-in da cartella o applicazione legacy: in questo caso può specificare il percorso della cartella in cui si trovano i file del suo add-in. L'opzione Non creare un pacchetto le permette di modificare un add-in direttamente nella cartella in cui risiede, senza creare un pacchetto RoboDK (file RDKP).
●Modifica add-in esistente: apre un pacchetto RoboDK esistente per modificarlo e creare una nuova versione.
Creare o modificare Add-in
Può creare facilmente un nuovo Add-in inserendo le informazioni di base, come il tipo, il nome, le informazioni sull'autore, ecc.
Nella finestra Add-in Creator, troverà i campi obbligatori in grassetto. Ce ne sono cinque in totale:
1.Tipo: Il tipo del suo Add-in, come ad esempio App, Robot Driver, Lingua, ecc.
2.Nome: Il nome del suo Add-in.
3.Identificatore univoco: un identificatore univoco che appartiene a questo specifico componente aggiuntivo. La casella di controllo accanto a questo campo le consente di attivare la modalità di modifica e di impostare un identificatore arbitrario, che può contenere lettere latine, numeri e caratteri aggiuntivi come il segno meno, il punto, il trattino basso.
dominio.azienda.tipo.nome. Sebbene sia possibile utilizzare una forma diversa di identificatore, consigliamo di seguire il formato suggerito.4.Versione: La versione deve essere scritta nel formato di versioning semantico (major.minor.patch).
5.Revisione: Il numero di modifiche dell'add-in, assume valori numerici da 1 in su.
I campi rimanenti sono opzionali, ma le consentono di fornire una descrizione più precisa dell'add-in:
6.Autore: Il nome e il cognome dell'autore, oppure il nome della sua azienda o del suo team (se ci sono più autori).
7.Azienda: Il nome dell'azienda.
8.Lingua: La lingua utilizzata nell'add-in. Sono elencate tutte le lingue dello standard BCP 47 dell'IETF.
9.Stato del contenuto: Stato dell'add-in, ad esempio Finale, Test interno, Beta, ecc.
10.Descrizione: Breve descrizione dell'Add-in.
11.Modificato da: Questo campo può essere utilizzato quando qualcuno modifica l'add-in di un altro autore e vuole essere citato come autore delle modifiche.
12.Creato: Data di creazione della prima versione dell'add-in (da compilare automaticamente).
13.Modificato: Data di modifica dell'add-in (da compilare automaticamente).
14.Indirizzo e-mail: Indirizzo e-mail per scopi di vendita, assistenza o feedback.
15.Sito web: Il sito web della sua azienda (sviluppatore dell'Add-in).
16.Link alla documentazione: Link alla documentazione del suo Add-in.
17.Link al repository: Per gli Add-in open-source, un link al repository GitHub o altro repository pubblico in cui si trova l'add-in.
18.Parole chiave: Un elenco di parole chiave (tag) per semplificare la ricerca del componente aggiuntivo nel Marketplace Add-in.
Dipendenze dell'Add-in
La pagina delle dipendenze dell'Add-in le consente di definire le condizioni che devono essere soddisfatte prima che l'Add-in (o file specifici al suo interno) venga installato. Se una condizione non viene soddisfatta, l'ambito interessato (l'intero pacchetto oppure un singolo file) viene escluso dall'installazione.
Utilizzi i pulsanti nella parte superiore della pagina per gestire le voci:
●Aggiungi: crea una nuova riga di dipendenza con valori predefiniti. Faccia clic su ciascuna cella della riga per configurarla.
●Rimuovi: elimina la riga attualmente selezionata. Selezioni prima una riga facendo clic su di essa.
Ogni riga di dipendenza ha cinque colonne. I campi visualizzati in grigio corsivo indicano un valore non impostato o facoltativo.
Ambito: Pacchetto o Risorsa
●Pacchetto: se il controllo fallisce, l'intero Add-in non viene installato. Utilizzi questa opzione quando l'Add-in non può funzionare affatto senza che il requisito sia soddisfatto.
●Risorsa: se il controllo fallisce, viene escluso solo il file specifico indicato nella colonna Identificatore / Nome file. Il resto dell'Add-in viene installato normalmente.
Gruppi di dipendenze per le risorse
Per le dipendenze con ambito Risorsa, la colonna Nome svolge un ruolo speciale: definisce un gruppo di dipendenze. Più righe con lo stesso nome vengono valutate una dopo l'altra per lo stesso file di risorsa.
Questo è utile quando un file può essere installato in condizioni diverse, ad esempio fornendo una versione del file per Windows e un'altra per Linux. Ogni gruppo viene valutato nel suo insieme: se almeno una riga del gruppo supera il controllo, la risorsa viene inclusa.
Specificare i valori
Il modo in cui inserisce il Valore dipende dal tipo di dipendenza:
●Controllo versione: utilizza la notazione matematica degli intervalli (vedere Intervalli di versione).
●File creato / File modificato: scelga tra tre modalità data/ora (vedere Valori di data e ora).
●Tutti gli altri tipi: durante la modifica, il campo Valore offre un menu a tendina con due opzioni:
●Valore esatto: il controllo viene superato se il valore di sistema corrisponde al valore inserito (il confronto non fa distinzione tra maiuscole e minuscole).
●Espressione regolare: il controllo viene superato se il valore di sistema corrisponde al modello fornito.
Intervalli di versione
I valori di versione utilizzano la notazione matematica standard degli intervalli:
●Una parentesi quadra [ o ] indica che la versione limite è inclusa.
●Una parentesi tonda ( o ) indica che la versione limite è esclusa.
●L'omissione del limite superiore o inferiore indica che non esiste alcun limite in quella direzione.
Valori di data e ora
I controlli di data/ora dei file non utilizzano la notazione a intervalli.
Selezioni invece una delle tre modalità:
●Esatto: la data/ora del file deve corrispondere esattamente alla data/ora specificata.
●Prima: la data/ora del file deve essere precedente alla data/ora specificata.
●Dopo: la data/ora del file deve essere successiva alla data/ora specificata.
Tipi di dipendenza
Tipo | Descrizione |
Nessuno | Non viene eseguito alcun controllo: la dipendenza è sempre considerata soddisfatta. Utile come segnaposto. |
Controllo versione | Verifica che la versione di un componente software selezionato rientri nell’intervallo specificato. 1.Identificatore: selezioni il software da controllare: RoboDK, Add-in Manager, Qt Framework o Sistema operativo. 2.Valore: un intervallo di versione utilizzando la notazione a intervalli (vedere Intervalli di versione). |
Architettura CPU | Verifica che l’architettura del processore del sistema corrisponda al valore previsto. 1.Valore: la stringa di architettura CPU prevista, ad es. x86_64, arm64, o i386. Supporta la corrispondenza esatta o l’espressione regolare. |
Architettura di build | Verifica la stringa completa dell’interfaccia binaria dell’applicazione (ABI) della build in esecuzione. È più dettagliata dell’architettura CPU e include informazioni su compilatore, modello dei dati ed endianness. 2.Valore: ad es. x86_64-little_endian-lp64. Supporta la corrispondenza esatta o l’espressione regolare. |
Tipo di kernel | Verifica l’identificativo del kernel del sistema operativo sottostante. 3.Valore: ad es. winnt (Windows), linux, darwin (macOS). Supporta la corrispondenza esatta o l’espressione regolare. |
Controllo di sistema | Verifica il nome del prodotto del sistema operativo come riportato dal sistema stesso. 4.Valore: ad es. windows, ubuntu. Supporta la corrispondenza esatta o l’espressione regolare. |
Versione del file (solo Windows) | Legge la risorsa di versione incorporata in un eseguibile o libreria Windows (.exe o .dll) e la confronta con il valore o utilizzando un’espressione. 5.Valore: ad es. 1.4.3.3123 supporta la corrispondenza esatta o l’espressione regolare. |
File creato | Verifica la data/ora di creazione del file specificato. 6.Identificatore / Nome file: il percorso del file da controllare. 7.Valore: una data/ora con modalità: Esatto, Prima o Dopo (vedere Valori di data e ora). |
File modificato | Verifica la data/ora dell’ultima modifica del file specificato. 8.Identificatore / Nome file: il percorso del file da controllare. 9.Valore: una data/ora con modalità: Esatto, Prima o Dopo (vedere Valori di data e ora). |
Aggiunta di risorse al suo Add-in
L'Add-in deve contenere una o più risorse. Gli asset possono essere script e icone che definiranno le azioni del suo Add-in.
La pagina Add-in Assets è suddivisa in tre aree funzionali:
1.Area di selezione dell'icona del pacchetto.
2.Area dell'albero dei file.
3.Area di anteprima per i contenuti del file.
Lo scopo dei pulsanti e della casella di controllo di questa pagina:
●Il pulsante TargetPath: Il pulsante Percorso di destinazione apre la finestra delle proprietà del file icona corrente e le permette di impostare la proprietà bersagli (veda la sezione corrispondente sugli interni del pacchetto).
●Il pulsante Cambia icona... le permette di sostituire l'icona del pacchetto attuale con una nuova.
●Il pulsante Rimuovi icona elimina l'icona corrente del pacchetto e imposta l'icona predefinita che corrisponde al tipo di pacchetto che si sta creando.
●Il pulsante Nuova cartella crea una nuova sottocartella nel ramo selezionato della struttura dei file.
●Il pulsante Add-in Asset... aggiunge nuovi file al ramo selezionato dell'albero dei file.
●Il pulsante Rimuovi rimuove gli elementi selezionati dalla struttura dei file, ad eccezione di quelli bloccati.
●La casella di controllo Make Python Package aggiunge il file __init__.py al progetto, in modo che l'interprete Python possa utilizzare i file del progetto come modulo caricabile esternamente.
Gli script Python possono essere contrassegnati per la successiva compilazione in file con estensione .pyc. Il processo di compilazione verrà visualizzato nella pagina successiva della procedura guidata.
Il campo Percorso di destinazione le permette di impostare la proprietà bersagli per ogni file. Questo può essere fatto manualmente, digitando il percorso desiderato e i nomi delle variabili, oppure richiamando la finestra delle proprietà quando clicca sul pulsante a forma di ingranaggio del Percorso di destinazione:
La finestra di dialogo Proprietà del file le permette di impostare i valori della proprietà bersagli e offre un comodo elenco di variabili disponibili. Consente inoltre di definire i parametri della piattaforma di destinazione (tipo e versione del sistema operativo, modello di CPU) su cui verrà distribuito il file.
Compilazione di script Python
La pagina di compilazione Python verrà aperta se è stato selezionato almeno uno script Python quando ha aggiunto le risorse del suo Add-in.
La compilazione verrà eseguita da tutti gli interpreti Python disponibili. L'elenco degli interpreti disponibili e utilizzati può essere modificato nella finestra Impostazioni di Add-in Manager. Il processo di compilazione in sé non richiede l'intervento dell'utente e la pagina visualizza un registro di compilazione dettagliato per individuare potenziali problemi.
Configurazione dell'app
La pagina di Configurazione dell'App le permette di personalizzare il modo in cui le sue azioni o script sono collegati all'interfaccia utente di RoboDK (menu e barra degli strumenti). Vedrà la finestra Configurazione app se sta creando un Add-in di tipo App.
I parametri di questa pagina definiscono il contenuto del file AppConfig.ini. Le chiavi e i valori possibili sono elencati in questa pagina. Ogni App ha il proprio menu e la propria barra degli strumenti in RoboDK. Le voci del menu e i pulsanti della barra degli strumenti sono chiamati Azioni in termini di App. Può definire le condizioni di visualizzazione delle azioni, il loro ordine nel menu e assegnare loro dei tasti di scelta rapida.
Il set di parametri di base comprende:
●Nome del menu: Nome della voce nel menu principale di RoboDK.
●Visibile: Deselezioni questa casella di controllo per evitare che il menu venga visualizzato nel menu principale di RoboDK.
●Menu principale: Selezioni la voce di menu principale per la quale verrà creato il menu figlio dell'App, oppure selezioni Principale per creare una nuova voce di menu principale.
●Priorità: Imposta la priorità che determina l'ordine di visualizzazione dei menu di questa App rispetto ai menu delle altre App (il più basso viene visualizzato per primo).
●Area della barra degli strumenti: Posizione (lato) sulla finestra principale di RoboDK in cui si troverà la barra degli strumenti dell'App.
●Scala della barra degli strumenti: Proporzione delle icone della barra degli strumenti in relazione alla dimensione attuale delle icone della barra degli strumenti di RoboDK.
●Comandi: Comandi API di RoboDK che verranno eseguiti quando l'add-in viene attivato.
Viene creata un'azione per ogni script Python che si trova nella stessa cartella del file AppConfig.ini. Se lo script è di natura ausiliaria, tale azione può essere soppressa utilizzando la proprietà Visible.
Le proprietà dell'azione sono rappresentate dal seguente elenco:
●Nome: il nome dell'azione come appare nel menu e nella barra degli strumenti.
●Descrizione: testo di un suggerimento quando passa il puntatore del mouse su una voce di menu o un pulsante della barra degli strumenti.
●Priorità: l'ordine di visualizzazione dell'azione rispetto alle altre azioni di questa App (la più bassa viene visualizzata per prima).
●Scorciatoia
●Visibile
●Solo per sviluppatori: questa azione sarà visualizzata solo se RoboDK è passato alla modalità sviluppatore (Ctrl+Alt+Shift+G).
●Mostra nel menu
●Mostra nella barra degli strumenti
●Controllabile: crea un'azione controllabile, le azioni controllabili possono anche essere raggruppate per numeri.
●Filtro menu contestuale: definisce i tipi di elementi dell'albero RoboDK per i quali questa azione sarà aggiunta al menu contestuale.
●Filtro doppio clic: definisce i tipi di elementi dell'albero RoboDK per i quali questa azione sarà richiamata al doppio clic.
Creare il suo pacchetto Add-in
La creazione dell'Add-in è completata dalla creazione del pacchetto RoboDK come file RDKP. Questa è la fase finale della creazione del suo Add-in.
Nella fase finale, appena prima di creare il pacchetto, sono disponibili le seguenti opzioni:
●Criptare il pacchetto: criptare il file in modo che possa essere facilmente inviato via e-mail, aggirando i sistemi di rilevamento delle minacce (i servizi di posta elettronica di Google vietano direttamente il trasferimento di file eseguibili e script Python negli allegati).
●Installa dopo la costruzione: lasci che Add-in Manager installi il pacchetto appena creato.
●Aprire la cartella contenente: aprire la cartella in cui è stato creato il pacchetto.
