Sviluppo/Creare un'estensione "Ciao Mondo" per LibreOffice
TDF LibreOffice Document Liberation Project Blog comunitari Weblate Nextcloud Redmine Ask LibreOffice Donazione
In questo tutorial creeremo un'estensione per LibreOffice Calc usando il linguaggio di programmazione LibreOffice Basic. Si tratta di un'estensione semplice che ha lo scopo di illustrare alcuni degli elementi di base delle estensioni di LibreOffice. L'estensione aggiungerà un pulsante sulla barra degli strumenti standard (vicino a quello di Esporta come PDF), che, se premuto, visualizzerà una finestra di dialogo con la scritta “Ciao Mondo!”. Il codice sorgente di questo tutorial si trova su github.
Passaggio 1. Creazione di una cartella per l'estensione
1) In un percorso da voi scelto, create una cartella denominata .
Passaggio 2. Creazione di una libreria per la macro
1) Aprite LibreOffice Calc. Nella barra del menu selezionate .
2) Fate clic sul pulsante .
3) Selezionate la scheda e fate clic sul pulsante .
4) Dategli il nome e fate clic su . Potrete vedere la libreria appena create nell'elenco delle librerie.
5) Fate clic sul pulsante per uscire dalla finestra di dialogo .
Passaggio 3. Creazione della macro
1) Selezionate e fate clic su .
2) Copiate la macro sottostante ed incollatela nella IDE Basic di LibreOffice, quindi salvate con Ctrl+S.
Sub HelloWorldMacro
MsgBox "Hello, World!"
End Sub
Passaggio 4. Esportazione della libreria
1) Dalla barra degli strumenti della IDE Basic di LibreOffice, selezionate .
2) Fate clic sul pulsante .
3) Selezionate la scheda , scegliete dall'elenco, quindi fate clic sul pulsante .
4) Selezionate e fate clic su .
5) Salvate la libreria nella cartella , quindi fate clic su per uscire dalle finestre della gestione delle macro Basic di LibreOffice e dalle Macro di LibreOffice Basic. Come vedremo in seguito, la libreria esportata contiene 3 file.
Passaggio 5. Aggiunta di una descrizione dell'estensione
1) Andate nella cartella e create una sottocartella denominate .
2) All'interno della cartella create un file denominato .
3) Incollate il contenuto sottostante nel file , quindi salvate con Ctrl+S e chiudete il file.
Estensione Ciao Mondo per LibreOffice. Copyright (c) il_vostro_nome 2024.
Passaggio 6. Aggiunta di una licenza
1) All'interno della cartella create una sottocartella denominata .
2) Nella cartella create un file denominato ed incollate al suo interno il contenuto che trovate a questo collegamento. Poi salvate con Ctrl+S e chiudete il file.
Passaggio 7. Aggiunta di un file manifesto
1) All'interno della cartella create una sottocartella denominata .
2) Nella cartella create un file denominato ed incollate al suo interno il contenuto che trovate qui di seguito. Quindi salvate con Ctrl+S e chiudete il file.
<?xml version="1.0" encoding="UTF-8"?>
<manifest:manifest>
<manifest:file-entry manifest:full-path="HelloWorldLibrary/" manifest:media-type="application/vnd.sun.star.basic-library"/>
<manifest:file-entry manifest:full-path="pkg-description/pkg-description.en" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=en"/>
<manifest:file-entry manifest:full-path="Addons.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
</manifest:manifest>Passaggio 8. Aggiunta di immagini
1) All'interno della cartella create una sottocartella denominata .
2) Andate a questo collegamento, scaricate 2 delle immagini che trovate e salvatele nella cartella .
Passaggio 9. Aggiunta di un file di descrizione
1) All'interno della cartella create un file denominato .
2) Incollate il contenuto sottostante nel file . Poi salvate con Ctrl+S e chiudete il file.
<?xml version='1.0' encoding='UTF-8'?>
<description
xmlns="http://openoffice.org/extensions/description/2006"
xmlns:dep="http://openoffice.org/extensions/description/2006"
xmlns:xlink="http://www.w3.org/1999/xlink">
<identifier value="org.broffice.helloworldmacro"/>
<icon>
<default xlink:href="icons/image_42.png" />
</icon>
<version value="1.0"/>
<registration>
<simple-license accept-by="admin" default-license-id="ID0" suppress-on-update="true" >
<license-text xlink:href="registration/license.txt" lang="en" license-id="ID0" />
</simple-license>
</registration>
<publisher>
<name xlink:href="mailto:youremail@smt.com">Your Name</name>
</publisher>
<display-name>
<name>Hello World</name>
</display-name>
</description>Passaggio 10. Aggiunta di un pulsante alla barra degli strumenti di LibreOffice Calc
1) All'interno della cartella create un file denominato .
2) Copiate questo codice ed incollatelo nel file . Quindi salvate con Ctrl+S e chiudete il file.
Passaggio 11. A questo punto la struttura dei file è la seguente
Passaggio 12. Creazione di un pacchetto dell'estensione
1) Selezionate tutti i file all'interno della cartella , potete farlo premendo Ctrl+A.
2) Fate clic con il pulsante destro del mouse e comprimete tutto nel file .
3) Rinominate il file in . Ora l'estensione è pronta con il prossimo passaggio verrà installata in LibreOffice Calc.
Passaggio 13. Installazione dell'estensione in LibreOffice Calc
1) Aprite LibreOffice Calc e selezionate .
2) Fate clic sul pulsante e selezionate l'estensione .
3) Per installare l'estensione, accettate la Licenza d'uso dell'estensione.
4) Fate click sul pulsante e riavviate LibreOffice Calc.
Nota: se ricevete un messaggio di errore di avviso "!link" quando provate a installare l'estensione, rimuovete HelloWorldLibrary prima di provare a installare l'estensione, poiché LibreOffice non può installare un'estensione su una libreria macro con lo stesso nome :
- Aprite LibreOffice Calc. Dalla barra dei menu, scegliete Strumenti > Macro > Organizza macro > LibreOffice Basic
- Fate clic sul pulsante Organizzatore, fate clic sulla scheda Librerie, selezionate HelloWorldLibrary dall'elenco Libreria, quindi fate clic su Elimina e confermate che desiderate eliminare la libreria.
- Ora dovreste essere in grado di installare l'estensione seguendo i passaggi da 1 a 4 sopra.
Conclusione
In questo tutorial è stata creata un'estensionde Ciao Mondo per LibreOffice Calc. Potete trovare il codice sorgente completo su github.