Manual do utilizador

Este manual tem o objectivo de explicar como devem ser usados o Criador de Kits e o Instalador de Kits.

Criador de Kits

O Criador de Kits é a aplicação que vai permitir a criação de kits como o nome indica, mas também permite mais algumas opções relacionadas com a criação de kits. Assim as opções são:

• Criar um kit
• Criar um kit de sistema
• Abrir um kit existente para edição
• Guardar os dados incompletos

Criar um kit

A criação de um kit é um processo que consiste em 5 etapas. Cada uma destas 5 etapas está separada por um tab. As etapas são:

• Definições - Onde são preenchidas as definições gerais do kit
• Descrição - Aqui define-se a descrição do kit, a sinopse e a descrição propriamente dita.
• Pacotes - Nesta etapa seleccionam-se as aplicações (pacotes) que o kit vai incluir.
• Post-install - Esta etapa é facultativa, mas permite incluir scripts para executar após a instalação do kit.
• Concluir - Finalmente definem-se as ultimas opções e é aqui que se gera o kit.

Há excepção do post-install (etapa 4) todos os campos são de preenchimento obrigatório.

A imagem seguinte exemplifica como pode (deve) ser preenchido os campos das definições gerais. O nome do kit tem o respectivo nome, o campo responsável contem o nome e/ou e-mail do responsável pelo kit, a versão contem a respectiva versão, a arquitectura do sistema para o qual o kit é destinado, a secção onde o kit se engloba e a respectiva prioridade.

Para uma utilização regular e coerente é aconselhado manter o nome do kit com letras minúsculas, no entanto as maiúsculas também podem ser utilizadas.
A prioridade do kit na maioria das vezes irá ser Optional pois são aplicações facultativas que o utilizador resolve instalar, no entanto e como pode haver kits com utilizações mais especificas existem outras opções disponíveis tais como Required, Important, Extra e Standard.

O próximo passo é preencher a descrição do kit. É um passo relativamente simples, com dois campos. A sinopse e a descrição propriamente dita.

A etapa que se segue é a selecção das aplicações (pacotes). Aqui pode ser seleccionado qualquer pacote que exista na cache do sistema. A lista é extensa mas utilizando as funcionalidades do gtk é possível pesquisar pelo nome, seleccionando uma linha e depois escrevendo o nome ou utilizar a caixa de texto para pesquisar sobre qualquer campo (nome, versão, descrição). A acção de seleccionar o pacote é simples, basta clicar na check box.

Como já foi dito anteriormente a etapa 4 é facultativa e é destinada a utilizadores avançados. Está fora do âmbito deste manual explicar o que é o post-install. Quem desejar saber o que é pode fazê-lo  aqui.

Por fim e na ultima etapa definem-se apenas dois campos, o nome do ficheiro e o local onde o mesmo vai ser guardado. Após os campos estarem definidos basta clicar no botão Gerar Kit, para o kit ser gerado. Irá ser mostrada uma mensagem a informar o utilizador se o kit foi gerado com sucesso ou se ocorreu algum erro. Uma nota relativa ao nome do kit, o standard para os nomes é algo deste tipo <foo>_<VersionNumber?>-<DebianRevisionNumber?>_<DebianArchitecture?>.deb. Qualquer outro formato de nome pode ser utilizado, mas o aconselhado é este.

Criar um kit de sistema

O criador de kits disponibiliza uma opção para que possa ser criado um kit que contem todos os pacotes instalados no sistema. Assim é possível fazer um backup ou criar um kit para replicar o sistema noutros computadores.

Esta opção pode ser utilizada em qualquer altura, caso o utilizador já tenha começado a criar um kit, seleccionando a opção Kit de Sistema/backup ou pelo atalho Ctrl+Alt+S, o criador de kits vai adicionar ao trabalho já iniciado os pacotes instalados em sistema. No caso de não haver campo nenhum preenchido, alem dos pacotes vão ser preenchidos automaticamente alguns campos. Após a tarefa ter sido concluída, é permitido ao utilizador modificar os pacotes seleccionados bem como os restantes campos nas diversas opções.

Abrir um kit existente para edição

Para abrir um kit já criado para edição e se poderem alterar dados, basta ir ao menu Ficheiro, Abrir e seleccionar o kit. Ao fazer isto todos os dados já inseridos nos campos serão apagados e passam a ser mostrados os dados do kit.

Guardar os dados incompletos

Para facilitar o trabalho do utilizador, um kit que esteja em processo de criação, entenda-se que está incompleto, pode ser guardado. Assim o utilizador pode parar o trabalho e retomar mais tarde. Todos os kits guardados deste modo têm a extensão .kit e trata-se de um ficheiro que contem os dados guardados no formato xml.

Estes ficheiros .kit podem ser retomados seleccionando o respectivo ficheiro através do menu Ficheiro, Abrir. O menu Ficheiro, Abrir suporta os dois modos, abrir um kit que já tenha sido gerado ou então um kit que tenha sido guardado por estar ainda em desenvolvimento.

Instalador de Kits

O Instalador de Kits é a aplicação que vai gerir a instalação dos kits. Os kits podem ser instalados de dois modos, via repositório ou através de um ficheiro.
Por defeito são carregados na lista os kits do repositório de kits Alinex. Para ver a descrição completa de um kit basta selecciona-lo.
Do lado esquerdo existe uma lista com as secções para facilitar a escolha do kit e ainda para ajudar, existe um campo na parte superior direita da aplicação para efectuar pesquisas.
Finalmente é apenas necessário seleccionar na check box o kit que se pretende instalar e clicar no botão Aplicar.

Para instalar um kit através de um ficheiro basta seleccionar o menu Ficheiro, Abrir e depois seleccionar o respectivo kit.