O objectivo deste projecto é disponibilizar uma nova versão de middleware que facilite e potencie a utilização do cartão de cidadão.

O Manual de Utilização pretende descrever todas as funcionalidades providenciadas pelo middleware do Cartão de Cidadão.

Manual de Utilização (online)

Manual de Utilização (download pdf)

Está disponível um SDK, com o objetivo de disponibilizar a integração com outras aplicações, das funcionalidades desenvolvidas no âmbito deste projeto. Existem SDK's para as linguagens C, C++, JAVA e C#.

Poderá aceder ao manual no seguinte URL:

Manual do SDK (online)

Manual do SDK (download pdf)

A documentação da API disponibilizada pelo SDK está disponível nos seguintes URLs:

Documentação Técnica do SDK C++ (online)

Documentação Técnica do SDK Java (online)

1. Instalação das dependências. As dependências para a compilação do Middleware em Linux (nomes de pacotes válidos para a distribuição Ubuntu 18.04), são as seguintes:

   sudo apt install libpcsclite-dev libpoppler-qt5-dev libzip-dev libopenjp2-7-dev libpng-dev openjdk-8-jdk qtbase5-dev qt5-qmake qtbase5-private-dev qt5-default qtdeclarative5-dev qtquickcontrols2-5-dev qml-module-qtquick-controls2 libssl1.0-dev libxerces-c-dev libxml-security-c-dev swig libcurl4-nss-dev libnsspem

2. Clonar o repositório

   git clone REPOSITORY_URL

3. Compilar o projecto na directoria eidmw

   cd eidmw
   qmake pteid-mw.pro
   make

4. Caso pretenda instalar a aplicação

   make install

   A aplicação utilitária será instalada em: /usr/local/bin/eidguiV2

   As dependências para a execução do Middleware na distribuição Ubuntu 18.04 estão disponíveis em "Depends" no seguinte URL: Dependências

Instruções para build em Windows (Visual Studio 2013)

É importante assegurar que as dependências são compiladas com a mesma versão de Visual Studio que será usada para compilar o Middleware. Será assim necessário compilar as seguintes bibliotecas:

• openSSL 1.0.2 - https://www.openssl.org/source/openssl-1.0.2t.tar.gz
• xerces-c - https://xerces.apache.org/xerces-c/build-3.html
• libcurl - https://curl.haxx.se/download.html
• zlib - http://www.zlib.net/zlib-1.2.11.tar.gz
• libzip - https://libzip.org/download/
• libpng - http://www.libpng.org/pub/png/libpng.html
• openjpeg - https://www.openjpeg.org/

Para o caso do Qt5 (versão igual ou superior a 5.9) estão disponíveis binários pré-compilados, poderá ser utilizado o instalador disponível em: https://download.qt.io/archive/online_installers/2.0/

Ferramentas adicionais a instalar:

• 7-zip
• Windows Platform SDK
• Visual Studio
• doxygen - disponível em http://www.doxygen.nl/download.html
• Swigwin 4.0.1 - disponível em https://sourceforge.net/projects/swig/files/swigwin/swigwin-4.0.1/
• Java JDK
• Wix - disponível em https://wixtoolset.org/releases/
• Wix Visual Studio Extension - https://marketplace.visualstudio.com/items?itemName=WixToolset.WixToolsetVisualStudio2013Extension

Após configurado o ambiente conforme acima descrito, efetuar os seguintes passos:

1. Clonar repositório
2. Configurar os caminhos para as dependências (x86 e x64) e ferramentas no ficheiro pteid-mw-pt\windows\set_path_autenticacao.gov.bat
3. Abrir a Solução de VS2013 através do script `pteid-mw-pt\windows\ezbuild_sln_autenticacao.gov.bat
4. Seleccionar a configuração Release | Win32 ou Release | x64
5. Compilar o projecto através do menu Build solution

Em alternativa, pode ser editado o script pteid-mw-pt\windows\ezbuild_sln_autenticacao.gov.bat para compilar na consola. As instruções estão no próprio ficheiro.

Para questões, sugestões ou comentários envie um e-mail para [email protected].