Erstellen einer Hello World LibreOffice-Erweiterung

From The Document Foundation Wiki
Jump to navigation Jump to search
This page is a translated version of the page Development/Create a Hello World LibreOffice extension and the translation is 99% complete.
Other languages:
Deutsch • ‎English • ‎dansk • ‎italiano • ‎עברית

In diesem Tutorial werden wir eine "Hello World"-Erweiterung für LibreOffice Calc unter Verwendung der LibreOffice Basic-Sprache erstellen. Es ist eine einfache Erweiterung, um einige der grundlegenden Elemente einer Erweiterung in LibreOffice zu veranschaulichen. Die Erweiterung fügt eine Schaltfläche (neben der Schaltfläche "Als PDF exportieren") zur Standardsymbolleiste hinzu, und wenn sie angeklickt wird, wird ein Dialog mit "Hello, World!" angezeigt. Der Quellcode für dieses Tutorial ist auf github.

Result.png

Schritt 1. Erstellen eines Ordners für unsere Erweiterung

1) Choose a location and create a folder named helloworld.

Create a folder.png

Schritt 2. Erstellen einer Bibliothek für unser Makro

1) Öffnen Sie LibreOffice Calc. Wählen Sie in der Menüleiste Werkzeuge > Makros > Makros organisieren > LibreOffice Basic.

2) Klicken Sie auf die Schaltfläche Organisation.

Figure2.1.png

3) Wählen Sie die Registerkarte Bibliotheken und klicken Sie auf die Schaltfläche Neu.

Figure2.2.png

4) Nennen Sie sie HelloWorldLibrary und klicken Sie auf OK. Die erstellte Bibliothek ist in der Liste Library zu sehen.

Figure2.3.png


Figure2.4.png

5) Klicken Sie auf die Schaltfläche Schließen, um das Dialogfeld LibreOffice Basic Macro Organisation zu verlassen.

Schritt 3. Erstellen des Makros

1) Wählen Sie Meine Makros > HelloWorldLibrary >Module1 und klicken Sie auf die Schaltfläche Bearbeiten.

Figure3.1.png

2) Kopieren Sie das unten stehende Makro und fügen Sie es in die LibreOffice Basic IDE ein, dann speichern Sie es (Strg+S).

Sub HelloWorldMacro
   Print "Hello, World!"
End Sub

Figure3.2.png

Schritt 4. Exportieren unserer Bibliothek

1) Wählen Sie in der Menüleiste der LibreOffice Basic IDE Werkzeuge > Makros organisieren > LibreOffice Basic.

2) Klicken Sie auf die Schaltfläche Organisation.

Figure4.1.png

3) Wählen Sie die Registerkarte Bibliotheken und wählen Sie HelloWorldLibrary aus der Bibliotheksliste, dann klicken Sie auf die Schaltfläche Exportieren.

Figure4.2.png

4) Wählen Sie Export als BASIC-Bibliothek und klicken Sie auf OK.

Figure4.3.png

5) Speichern Sie die Bibliothek in unserem Ordner helloworld und klicken Sie dann auf Schließen, um die LibreOffice Basic Makro Organisation und LibreOffice Basic Makros zu verlassen. Wie wir unten sehen, enthält die exportierte Bibliothek 3 Dateien.

Figure4.4.png

Schritt 5. Hinzufügen einer Beschreibung zu unserer Erweiterung

1) Gehen Sie zum Ordner helloworld und erstellen Sie einen Unterordner mit dem Namen Pkg-Beschreibung.

Figure5.2.png

2) Erstellen Sie im Ordner der pkg-Beschreibung eine Datei namens pkg-beschreibung.de.

Figure5.3.png

3) Fügen Sie den folgenden Inhalt in die Datei pkg-beschreibung.de ein, klicken Sie auf Speichern (Strg+S) und schließen Sie die Datei.

Hello World LibreOffice-Erweiterung. Copyright (c) Ihr Name 2019.

Schritt 6. Hinzufügen einer Lizenz

1) Erstellen Sie im Ordner helloworld einen Unterordner mit dem Namen Registrierung.

2) Erstellen Sie im Ordner Registrierung eine Datei mit dem Namen Lizenz.txt, und fügen Sie den Inhalt von diesem Link ein. Speichern Sie dann (Strg+S) und schließen Sie die Datei.

Schritt 7. Hinzufügen der Manifestdatei

1) Erstellen Sie im Ordner helloworld einen Unterordner namens META-INF.

2) Erstellen Sie im Ordner META-INF eine Datei mit dem Namen manifest.xml und fügen Sie den unten stehenden Inhalt ein. Speichern Sie dann (Strg+S) und schließen Sie die Datei.

<?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-desc/pkg-description.en" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=en"/>
   <manifest:file-entry manifest:full-path="pkg-desc/pkg-description.pt-BR" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=pt-BR"/>
   <manifest:file-entry manifest:full-path="Addons.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
</manifest:manifest>

Schritt 8. Hinzufügen von Bildern

1) Erstellen Sie im Ordner helloworld einen Unterordner namens Symbole.

Figure8.1.png

2) Gehen Sie zu diesem Link und laden Sie dort die 2 Bilder herunter, speichern Sie sie im Ordner "Symbole".

Schritt 9. Hinzufügen der Beschreibungsdatei

1) Erstellen Sie im Ordner helloworld eine Datei namens Beschreibung.xml.

Figure9.1.png

2) Fügen Sie den folgenden Inhalt in die Datei Beschreibung.xml ein. Dann speichern (Strg+S) und Datei schließen.

<?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>

Schritt 10. Hinzufügen einer Schaltfläche zur Symbolleiste von LibreOffice Calc

1) Erstellen Sie im Ordner helloworld eine Datei namens Addons.xcu.

2) Kopieren Sie diesen Code und fügen Sie ihn in die Datei Addons.xcu ein. Dann speichern (Ctrl+S) und Datei schließen.

Schritt 11. Dies ist unsere bisherige Dateistruktur

Figure11.1.png

Schritt 12. Verpacken der Erweiterung

1) Wählen Sie im Ordner helloworld alle Dateien aus (Strg+A).

2) Klicken Sie mit der rechten Maustaste, und komprimieren Sie zu helloworld.zip.

Figure12.1.png

3) Benennen Sie helloworld.zip in helloworld.oxt um. Jetzt ist unsere Erweiterung fertig und im nächsten Schritt werden wir sie in LibreOffice Calc installieren.

Figure12.2.png

Schritt 13. Installieren unserer Erweiterung in LibreOffice Calc

1) Öffnen Sie LibreOffice Calc und wählen Sie Werkzeuge > Erweiterungsmanager.

2) Klicken Sie auf die Schaltfläche Hinzufügen und wählen Sie unsere Erweiterung helloworld.oxt.

3) Akzeptieren Sie die Lizenzvereinbarung für die Erweiterungssoftware, um die Erweiterung zu installieren.

Figure13.1.png

4) Klicken Sie auf die Schaltfläche Schließen und starten Sie LibreOffice Calc neu.

Schlussfolgerung

In diesem Tutorial haben wir eine Hello World-Erweiterung für LibreOffice Calc erstellt. Den vollständigen Quellcode finden Sie unter github.