Sviluppo/Creare un'estensione "Ciao Mondo" per LibreOffice

    From The Document Foundation Wiki
    This page is a translated version of the page Development/Create a Hello World LibreOffice extension and the translation is 100% complete.
    Other languages:

    In questo tutorial creeremo un'estensione Ciao Mondo 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.

    Result.png

    Passaggio 1. Creazione di una cartella per l'estensione

    1) In un percorso da voi scelto, create una cartella denominata ciaomondo.

    Create a folder.png

    Passaggio 2. Creazione di una libreria per la macro

    1) Aprite LibreOffice Calc. Nella barra del menu selezionate Strumenti > Macro > Organizza Macro> LibreOffice Basic.

    2) Fate clic sul pulsante Gestione.

    Figure2.1.png

    3) Selezionate la scheda Librerie e fate clic sul pulsante Nuovo.

    Figure2.2.png

    4) Dategli il nome LibreriaCiaoMondo e fate clic su OK. Potrete vedere la libreria appena create nell'elenco delle librerie.

    Figure2.3.png


    Figure2.4.png

    5) Fate clic sul pulsante Chiudi per uscire dalla finestra di dialogo LibreOffice: Gestione macro Basic.

    Passaggio 3. Creazione della macro

    1) Selezionate Macro personali > LibreriaCiaoMondo >Module1 e fate clic su Modifica.

    Figure3.1.png

    2) Copiate la macro sottostante ed incollatela nella IDE Basic di LibreOffice, quindi salvate con Ctrl+S.

    Sub HelloWorldMacro
       MsgBox "Hello, World!"
    End Sub

    Figure3.2.png

    Passaggio 4. Esportazione della libreria

    1) Dalla barra degli strumenti della IDE Basic di LibreOffice, selezionate Strumenti > Organizza Macro > LibreOffice Basic.

    2) Fate clic sul pulsante Gestione.

    Figure4.1.png

    3) Selezionate la scheda Librerie, scegliete LibreriaCiaoMondo dall'elenco, quindi fate clic sul pulsante Esporta.

    Figure4.2.png

    4) Selezionate Esporta come libreria BASIC e fate clic su OK.

    Figure4.3.png

    5) Salvate la libreria nella cartella ciaomondo, quindi fate clic su Chiudi 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.

    Figure4.4.png

    Passaggio 5. Aggiunta di una descrizione dell'estensione

    1) Andate nella cartella ciaomondo e create una sottocartella denominate pkg-description.

    Figure5.2.png

    2) All'interno della cartella pkg-description create un file denominato pkg-description.en.

    Figure5.3.png

    3) Incollate il contenuto sottostante nel file pkg-description.en, 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 ciamondo create una sottocartella denominata registration.

    2) Nella cartella registration create un file denominato license.txt 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 ciaomondo create una sottocartella denominata META-INF.

    2) Nella cartella META-INF create un file denominato manifest.xml 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 ciamondo create una sottocartella denominata icons.

    Figure8.1.png

    2) Andate a questo collegamento, scaricate 2 delle immagini che trovate e salvatele nella cartella icons.

    Passaggio 9. Aggiunta di un file di descrizione

    1) All'interno della cartella ciamondo create un file denominato description.xml.

    Figure9.1.png

    2) Incollate il contenuto sottostante nel file description.xml. 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 ciamondo create un file denominato Addons.xcu.

    2) Copiate questo codice ed incollatelo nel file Addons.xcu. Quindi salvate con Ctrl+S e chiudete il file.

    Passaggio 11. A questo punto la struttura dei file è la seguente

    Figure11.1.png

    Passaggio 12. Creazione di un pacchetto dell'estensione

    1) Selezionate tutti i file all'interno della cartella ciaomondo, potete farlo premendo Ctrl+A.

    2) Fate clic con il pulsante destro del mouse e comprimete tutto nel file ciaomondo.zip.

    Figure12.1.png

    3) Rinominate il file ciaomondo.zip in ciaomondo.oxt. Ora l'estensione è pronta con il prossimo passaggio verrà installata in LibreOffice Calc.

    Figure12.2.png

    Passaggio 13. Installazione dell'estensione in LibreOffice Calc

    1) Aprite LibreOffice Calc e selezionate Strumenti > Gestione estensioni.

    2) Fate clic sul pulsante Aggiungi e selezionate l'estensione ciaomondo.oxt.

    3) Per installare l'estensione, accettate la Licenza d'uso dell'estensione.

    Figure13.1.png

    4) Fate click sul pulsante Chiudi 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.