Versão 17

01. Dependências

• @angular
  • Angular na versão 17

• @po-ui
  • ng-components@^17.0.0
  • ng-templates@^17.0.0
• subsink
• totvs/po-theme
  • po-theme@^17.0.0

02. Instalação

Caso já seja um projeto existente, basta instalar a dependência do protheus-lib-core

npm i @totvs/protheus-lib-core@latest

Caso o CLI do Angular ainda não esteja instalado, é necessário instalar o mesmo:

npm i -g @angular/cli@17

Para iniciar um projeto Angular, de forma macro, os comandos são os seguintes

ng new my-protheus-app
cd my-protheus-app
ng add @po-ui/ng-components@latest
ng add @po-ui/ng-templates@latest
npm i subsink
npm i @totvs/protheus-lib-core@latest
ng serve

03. Atualização da versão 15 para a 17

Para atualizar o @totvs/protheus-lib-core da versão 15 para a 17 deve-se seguir alguns passos:

1. Atualizar o Angular e o PO-UI do projeto para a versão 16;
2. Após atualizar para a versão 16, atualizar para a versão 17 (Documento de atualização do PO-UI: https://po-ui.io/guides/migration-poui);
3. Após realizar a atualização dos pacotes acima para a versão 17, instalar o protheus-lib-core:

npm i @totvs/protheus-lib-core@latest

04. Utilização

Para utilizar o protheus-lib-core, basta importar o módulo principal no projeto:

import { ProtheusLibCoreModule } from '@totvs/protheus-lib-core';

Também adicionar o módulo no imports:

  imports: [
    ProtheusLibCoreModule,
  ],

05. Exemplo

Importar um dos serviços do protheus-lib-core, como o ProAppConfigService que permite a comunicação do app com a camada ADVPL, permitindo por exemplo fechar a dialog a qual o app foi aberto:

import { ProAppConfigService } from '@totvs/protheus-lib-core';

Criar o constructor para utilizar o serviço importado:

constructor(private proAppConfigService: ProAppConfigService) {
}

Método para fechar o app no Protheus, podendo ser chamado no menu, em algum botão etc:

private closeApp() {
  if (this.proAppConfigService.insideProtheus()) {
    this.proAppConfigService.callAppClose();
  } else {
    alert('O App não está sendo executado dentro do Protheus.');
  }
}

06. Geração do aplicativo

Gerar o app com o comando de build do Angular CLI:

ng build

Compactar a pasta do projeto gerada dentro da pasta dist
A compatação deve ser feita, mantendo o nome da pasta original, sendo uma compactação utilizando ZIP, porém com a extensão app.
Criar um fonte ADVPL contendo a chamada da função FWCallApp, esse fonte deve ser incluso no menu. O parâmetro da função FWCappApp deve ser o nome do app, nome do arquivo gerado .app, sem extensão.

Para maiores informações sobre abrir o aplicativo dentro do Protheus: FwCallApp - Abrindo aplicativos Web no Protheus