page27
TUTORIAL
COMO FAZER
A pasta raiz, ApagarLinhasVazias, é o nome da extensão; a pasta LinhaVazia é a biblioteca e contém o código fonte BASIC; a pasta META-INF, sempre com este nome, é obrigatória e contém o arquivo manifest.xml. O desenvolvedor pode acrescentar suas próprias pastas; por exemplo, uma para conter os ícones distribuídos com o suplemento e outra para os arquivos da ajuda.
Agora, vamos implementar algumas melhorias em nossa extensão. Desejamos que: (1) uma licença seja apresentada no momento da instalação e (2) uma nova barra de ferramenta, com um ícone para o comando, seja acrescentada na interface gráfica do LibreOffice.
Para o item (1), devemos definir o arquivo description.xml e o arquivo contendo a licença; para o item (2), precisamos criar um ícone, definir o arquivo de configuração XML addons.xcu e editar o arquivo manifest.xml.
Para a edição dos arquivos XML, podemos utilizar um editor de texto simples como o Programmer's Notepad 2 (Windows) ou o gedit (Linux).
Em nossa extensão, todos os arquivos, exceto o manifest.xml e a biblioteca BASIC, serão salvos na pasta ApagarLinhasVazias.
Arquivo description.xml
É um arquivo XML encarregado de passar informações para o Gerenciador de Extensões. Entre os principais elementos XML, temos:
<dependencies> informa as dependências da extensão, por exemplo, a versão mínima do LibreOffice;
<update-information> informa onde encontrar dados sobre as atualizações da extensão;
<registration> contém os dados referentes ao registro da extensão. Note que podemos definir arquivos de licença conforme o idioma definido no atributo lang. Em nosso caso, a licença está no arquivo gpl_pt-BR.txt.