Розробка/Створення розширення Hello World 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:

    У цьому уроці ми створимо розширення Hello World для LibreOffice Calc за допомогою мови LibreOffice Basic. Це просте розширення для ілюстрації деяких базових елементів розширень у LibreOffice. Розширення додає кнопку (поруч з кнопкою Експортувати як PDF) до стандартної панелі інструментів, яка при натисканні показує діалогове вікно з написом "Hello, World!". Вихідний код цього підручника знаходиться у github.

    Result.png

    Крок 1. Створюємо папку для нашого розширення

    1) Виберіть місце і створіть папку з назвою helloworld.

    Create a folder.png

    Крок 2. Створення бібліотеки для нашого макросу

    1) Відкрийте LibreOffice Calc. У рядку меню виберіть Інструменти > Макроси > Упорядкувати макроси > LibreOffice Basic.

    2) Натисніть кнопку "Упорядкувати".

    Figure2.1.png

    3) Перейдіть на вкладку Бібліотеки і натисніть кнопку Створити.

    Figure2.2.png

    4) Назвіть її HelloWorldLibrary і натисніть ОК. Створену бібліотеку буде показано у списку Бібліотек.

    Figure2.3.png


    Figure2.4.png

    5) Натисніть кнопку Закрити, щоб вийти з діалогового вікна LibreOffice Базовий органайзер макросів.

    Крок 3. Створення макросу

    1) Виберіть Мої макроси > Бібліотека HelloWorldLibrary > Модуль 1 і натисніть кнопку Редагувати.

    Figure3.1.png

    2) Скопіюйте наведений нижче макрос і вставте його у середовище LibreOffice Basic IDE, а потім збережіть.

    Sub HelloWorldMacro
       MsgBox "Hello, World!"
    End Sub

    Figure3.2.png

    Крок 4. Експортуємо нашу бібліотеку

    1) У рядку меню IDE LibreOffice Basic виберіть Інструменти > Впорядкувати макроси > LibreOffice Basic.

    2) Натисніть кнопку "Упорядкувати".

    Figure4.1.png

    3) Перейдіть на вкладку Бібліотеки і виберіть HelloWorldLibrary зі списку бібліотек, а потім натисніть кнопку Експортувати.

    Figure4.2.png

    4) Виберіть Експортувати як бібліотеку BASIC і натисніть ОК.

    Figure4.3.png

    5) Збережіть бібліотеку у нашій теці helloworld, а потім натисніть кнопку Закрити, щоб вийти з органайзера макросів LibreOffice Basic і макросів LibreOffice Basic. Як показано нижче, бібліотека, яку ми експортували, містить 3 файли.

    Figure4.4.png

    Крок 5. Додаємо опис до нашого розширення

    1) Перейдіть до теки helloworld і створіть підтеку з назвою pkg-description.

    Figure5.2.png

    2) У теці pkg-description створіть файл з назвою pkg-description.en.

    Figure5.3.png

    3) Вставте вміст нижче у файл pkg-description.en, натисніть зберегти і закрийте файл.

    Hello World розширення LibreOffice. Авторське право (c) Ваше ім'я 2024.
    

    Крок 6. Додавання ліцензії

    1) У папці helloworld створіть підпапку з назвою registration.

    2) У папці registration створіть файл з назвою license.txt і вставте в нього вміст з цього посилання. Потім збережіть і закрийте файл.

    Крок 7. Додавання файлу маніфесту

    1) У папці helloworld створіть підпапку з назвою META-INF.

    2) У папці META-INF створіть файл manifest.xml і вставте в нього вміст, наведений нижче. Потім збережіть і закрийте файл.

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

    Крок 8. Додавання зображень

    1) У папці helloworld створіть підпапку з назвою icons.

    Figure8.1.png

    2) Перейдіть за цим посиланням і завантажте звідти 2 зображення, збережіть їх у папку icons.

    Крок 9. Додавання файлу опису

    1) У папці helloworld створіть файл з назвою description.xml.

    Figure9.1.png

    2) Вставте вміст нижче у файл description.xml. Потім збережіть і закрийте файл.

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

    Крок 10. Додавання кнопки на панель інструментів LibreOffice Calc

    1) У папці helloworld створіть файл Addons.xcu.

    2) Скопіюйте цей код і вставте у файл Addons.xcu. Потім збережіть і закрийте файл.

    Крок 11. Наразі це наша файлова структура

    Figure11.1.png

    Крок 12. Пакування розширення

    1) У папці helloworld виділіть усі файли (Ctrl+A).

    2) Клацніть правою кнопкою миші та стисніть до файлу helloworld.zip.

    Figure12.1.png

    3) Перейменуйте файл helloworld.zip на helloworld.oxt. Тепер наше розширення готове і на наступному кроці ми встановимо його у LibreOffice Calc.

    Figure12.2.png

    Крок 13. Встановлення нашого розширення в LibreOffice Calc

    1) Відкрийте LibreOffice Calc і виберіть Інструменти > Диспетчер розширень.

    2) Натисніть кнопку Додати і виберіть наше розширення helloworld.oxt.

    3) Прийміть Ліцензійну угоду на програмне забезпечення розширення, щоб встановити розширення.

    Figure13.1.png

    4) Натисніть кнопку Закрити і перезапустіть LibreOffice Calc.

    Примітка: якщо під час спроби встановлення розширення ви отримаєте попереджувальне повідомлення про помилку "!link", вилучіть бібліотеку HelloWorldLibrary, перш ніж намагатися встановити розширення, оскільки LibreOffice не може встановити розширення поверх однойменної макробібліотеки:

    • Відкрийте LibreOffice Calc. У рядку меню виберіть Інструменти > Макроси > Впорядкувати макроси > LibreOffice Basic
    • Натисніть кнопку Організатор, перейдіть на вкладку Бібліотеки, виберіть HelloWorldLibrary зі списку, потім натисніть кнопку Видалити і підтвердіть, що ви бажаєте видалити бібліотеку.
    • Після цього ви зможете встановити розширення, виконавши кроки з 1 по 4 вище.

    Висновок

    У цьому підручнику ми створили розширення Hello World для LibreOffice Calc. Повний вихідний код можна знайти у github.