Розробка/Створення розширення Hello World LibreOffice
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate
У цьому уроці ми створимо розширення Hello World для LibreOffice Calc за допомогою мови LibreOffice Basic. Це просте розширення для ілюстрації деяких базових елементів розширень у LibreOffice. Розширення додає кнопку (поруч з кнопкою Експортувати як PDF) до стандартної панелі інструментів, яка при натисканні показує діалогове вікно з написом "Hello, World!". Вихідний код цього підручника знаходиться у github.
Крок 1. Створюємо папку для нашого розширення
1) Виберіть місце і створіть папку з назвою helloworld.
Крок 2. Створення бібліотеки для нашого макросу
1) Відкрийте LibreOffice Calc. У рядку меню виберіть Інструменти > Макроси > Упорядкувати макроси > LibreOffice Basic.
2) Натисніть кнопку "Упорядкувати".
3) Перейдіть на вкладку Бібліотеки і натисніть кнопку Створити.
4) Назвіть її HelloWorldLibrary і натисніть ОК. Створену бібліотеку буде показано у списку Бібліотек.
5) Натисніть кнопку Закрити, щоб вийти з діалогового вікна LibreOffice Базовий органайзер макросів.
Крок 3. Створення макросу
1) Виберіть Мої макроси > Бібліотека HelloWorldLibrary > Модуль 1 і натисніть кнопку Редагувати.
2) Скопіюйте наведений нижче макрос і вставте його у середовище LibreOffice Basic IDE, а потім збережіть.
Sub HelloWorldMacro
MsgBox "Hello, World!"
End Sub
Крок 4. Експортуємо нашу бібліотеку
1) У рядку меню IDE LibreOffice Basic виберіть Інструменти > Впорядкувати макроси > LibreOffice Basic.
2) Натисніть кнопку "Упорядкувати".
3) Перейдіть на вкладку Бібліотеки і виберіть HelloWorldLibrary зі списку бібліотек, а потім натисніть кнопку Експортувати.
4) Виберіть Експортувати як бібліотеку BASIC і натисніть ОК.
5) Збережіть бібліотеку у нашій теці helloworld, а потім натисніть кнопку Закрити, щоб вийти з органайзера макросів LibreOffice Basic і макросів LibreOffice Basic. Як показано нижче, бібліотека, яку ми експортували, містить 3 файли.
Крок 5. Додаємо опис до нашого розширення
1) Перейдіть до теки helloworld і створіть підтеку з назвою pkg-description.
2) У теці pkg-description створіть файл з назвою pkg-description.en.
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.
2) Перейдіть за цим посиланням і завантажте звідти 2 зображення, збережіть їх у папку icons.
Крок 9. Додавання файлу опису
1) У папці helloworld створіть файл з назвою description.xml.
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. Наразі це наша файлова структура
Крок 12. Пакування розширення
1) У папці helloworld виділіть усі файли (Ctrl+A).
2) Клацніть правою кнопкою миші та стисніть до файлу helloworld.zip.
3) Перейменуйте файл helloworld.zip на helloworld.oxt. Тепер наше розширення готове і на наступному кроці ми встановимо його у LibreOffice Calc.
Крок 13. Встановлення нашого розширення в LibreOffice Calc
1) Відкрийте LibreOffice Calc і виберіть Інструменти > Диспетчер розширень.
2) Натисніть кнопку Додати і виберіть наше розширення helloworld.oxt.
3) Прийміть Ліцензійну угоду на програмне забезпечення розширення, щоб встановити розширення.
4) Натисніть кнопку Закрити і перезапустіть LibreOffice Calc.
Примітка: якщо під час спроби встановлення розширення ви отримаєте попереджувальне повідомлення про помилку "!link", вилучіть бібліотеку HelloWorldLibrary, перш ніж намагатися встановити розширення, оскільки LibreOffice не може встановити розширення поверх однойменної макробібліотеки:
- Відкрийте LibreOffice Calc. У рядку меню виберіть Інструменти > Макроси > Впорядкувати макроси > LibreOffice Basic
- Натисніть кнопку Організатор, перейдіть на вкладку Бібліотеки, виберіть HelloWorldLibrary зі списку, потім натисніть кнопку Видалити і підтвердіть, що ви бажаєте видалити бібліотеку.
- Після цього ви зможете встановити розширення, виконавши кроки з 1 по 4 вище.
Висновок
У цьому підручнику ми створили розширення Hello World для LibreOffice Calc. Повний вихідний код можна знайти у github.