8.5. Aplicação de pacotes customizados (pacotes assinados)

Para a aplicação de pacotes customizados, será necessário acesso à plataforma CodeAnalysis (https://codeanalysis.totvs.com.br/).

Nela, iremos fazer algumas validações nos fontes enviados, apontando alguns possíveis erros ou melhorias a serem feitas. O pacote será gerado na sequência.

Em caso de dúvidas, verifique a documentação completa do CodeAnalysis aqui.

8.5.1 - Acesso

Caso já tenha acesso, prossiga com o login normalmente. Agora, se for um usuário novo, clique em "Novo cliente" e siga os passos de cadastro.

É necessário ter um TotvsID para se cadastrar na plataforma e fazer seu uso.

Após fazer o login corretamente, vamos agora para o passo a passo do processo.

8.5.2 - Criando um Projeto

O primeiro passo para gerar o pacote customizado, vai ser a criação de um projeto.

Um mesmo projeto será usado para a análise e geração de pacotes de um grupo de fontes, pois o histórico de qualidade e análises estáticas ficará gravado nele.

No menu "Projetos", clique em "+ Projeto" para adicionar um novo projeto à sua conta.

Na sequência faça o preenchimento dos campos:

Nome do Projeto: Nome identificador do projeto. Esse nome será usado na nomenclatura do pacote gerado;

Descrição do Projeto: Descrição mais detalhada sobre o projeto em questão;

Tipo de Acesso dos arquivos: A forma de envio dos Fontes para análise e compilação. Por enquanto, temos apenas a possibilidade via upload direto.

Usuários: Que usuários do Code Analysis poderão ter acesso e trabalhar com esse projeto.

ADVPL Include: Os includes já são adicionados automaticamente na análise do projeto. Mas se enviar eles junto, aqui deve ser informado a subpasta que eles estarão.

Confirme a criação e pronto! Já temos um projeto para iniciar a análise e geração de pacotes.

8.5.3 - Agendamento de Análises

Para iniciar uma análise, clique no menu de contexto do projeto e selecione a opção "Agendar":

Clique em "Select file" e escolha um arquivo zip com os fontes a serem analisados e compilados. E na sequência clique em "Agendar".

Agora vamos acompanhar o processamento dessa análise e compilação:

8.5.4 - Tela de Agendamento e Download

No menu lateral, selecione a opção "Agendamentos":

A análise agendada no passo anterior estará numa fila de processamento.

Quando concluída, não só você terá o acesso ao Link do SonarQube atualizado com as análises finais sobre os fontes enviados, apontando posśiveis erros e melhorias, como também, já poderá fazer o download do pacote.

É só clicar no menu de contexto e escolher a opção "Download Patch"

O arquivo zip virá com o pacote customizado no formato ".ptm", a assinatura desse pacote e uma chave pública para verificação.

Atenção: O arquivo zip estará disponível até o final do dia. Para fazer download no dia seguinte, faça um novo agendamento.

8.5.5 - Aplicando no seu ambiente

Após gerado o pacote (Arquivo ZIP), basta entrar no seu repositório de fontes (GIT - 8.1. SmartERP Protheus - Personalizando via programas em AdvPL) e copiar o arquivo para dentro da pasta "patch" (se não existir, basta criar a pasta).

Neste momento, o processo é identifico à subida de um fonte comum, basta seguir os passos de PULL, ADD, COMMIT e PUSH (8.1. SmartERP Protheus - Personalizando via programas em AdvPL) para subir o pacote (ZIP) e aplicar em seu ambiente.