Projeto Open Source do Middleware do Cartão de Cidadão Português

Introdução

Objectivos

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

Instalação da versão Offline

A instalação da versão Offline do middleware, está disponível para vários sistemas operativos em formato de pacotes de instalação. Poderá assim descarregar os pacotes preparados para instalação na seguinte localização:

svn.gov.pt/projects/ccidadao/browser/middleware-offline/tags/builds

Sistema Operativo	Versão	Arquitectura	Download
Microsoft Windows
Windows 7 +	3.0.15	32 bits	PteidMW-Basic.msi
Windows 7 +	3.0.15	64 bits	PteidMW-Basic-x64.msi
macOS X
macOS 10.10 (Yosemite) +	3.0.15	64 bits	pteid-mw.pkg
Linux
Caixa Mágica 22 +	2.4.6	32 bits	Pteid-mw_cm22_i386.deb
Caixa Mágica 22 +	2.4.6	64 bits	Pteid-mw_cm22_amd64.deb
Fedora 24 +	2.4.6	32 bits	Pteid-mw_fedora24_i386.rpm
Fedora 24 +	2.4.6	64 bits	Pteid-mw_fedora24_x86_64.rpm
Opensuse 42.2 +	2.4.6	64 bits	pteid-mw-suse.x86_64.rpm
Ubuntu 14.04	2.4.6	32 bits	Pteid-mw_ubuntu14.04_i386.deb
Ubuntu 14.04	2.4.6	64 bits	Pteid-mw_ubuntu14.04_amd64.deb
Ubuntu 16.04 +	2.4.6	32 bits	Pteid-mw_ubuntu_i386.deb
Ubuntu 16.04 +	2.4.6	64 bits	Pteid-mw_ubuntu_amd64.deb
Ubuntu 18.04	3.0.15	64 bits	Pteid-mw_ubuntu18_amd64.deb

Poderá aceder ao manual de utilizador do Middleware no seguinte URL: https://svn.gov.pt/projects/ccidadao/export/353/middleware-offline/trunk/docs/Manual_de_Utilizacao.pdf

SDK

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, JAVA e .NET C#.
Poderá aceder à documentação no seguinte URL: Manual do SDK

Compilar o Middleware do Cartão de Cidadão

Download do Código fonte

Todo o código fonte está disponível nos seguintes URL's:

• Middleware offline: offline

• Middleware Android: android

Linux

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

libpcsclite-dev default-jdk qtbase5-dev qt5-qmake qt5-default libssl-dev libxerces-c-dev swig libcurl4-openssl-dev libpoppler-qt5-dev libxml-security-c-dev

2 - Checkout do código-fonte

svn export https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/_src/eidmw

3 - Compilar o projecto na directoria eidmw

cd eidmw
./configure
make

4 - Caso pretenda instalar a aplicação

make install

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

Windows

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.2n.tar.gz
- xerces-c -  https://xerces.apache.org/xerces-c/build-3.html#Windows
- xml-security-c -  https://santuario.apache.org/download.html
- libcurl -  https://curl.haxx.se/download.html
- poppler-qt5 0.52 -  https://poppler.freedesktop.org/poppler-0.52.0.tar.xz

Para o caso do Qt 5.6 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/qt-unified-windows-x86-2.0.3-online.exe
Ferramentas adicionais a instalar: - 7-zip
- Java JDK
- Swigwin 2.0.12 - disponível em  https://sourceforge.net/projects/swig/files/swigwin/swigwin-2.0.12/
- Windows Platform SDK

Após configurado o ambiente conforme acima descrito,efetuar os seguintes passos:
1- Checkout do código fonte: https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/
2- Configurar os caminhos para as dependências (x86 e x64) e ferramentas no ficheiro windows\ezbuild\vc9\set_path_vc9.bat
3- Abrir a Solução de VS2013 através do script windows\ezbuild\vc9\ezbuild_sln_vc9.bat
4- Seleccionar a configuração "Release | Win32" ou "Release | x64"
5- Compilar o projecto através do menu "Build solution"

Android

1 - Preparação do ambiente de compilação
Para preparar o ambiente de compilação do middleware da versão Android, deverá instalar o Eclipse no seu computador.
A versão de código disponibilizada no repositório, foi desenvolvida em Eclipse versão Luna. Aconselha-se a utilização da mesma versão.

2 - Deverá instalar os devidos plugins(Android Development Tools) e configurar o ambiente de desenvolvimento Android no Eclipse.

3 - Download do código fonte do middleware, disponível em https://svn.gov.pt/projects/ccidadao/repository/middleware-android/tags/PTeId_Mobile_v1, e importação para o Eclipse.