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 + 2.4.0 32 bits PteidMW-Basic.msi
Windows 7 + 2.4.0 64 bits PteidMW-Basic-x64.msi
macOS X
macOS 10.9 (Mavericks) + 2.4.0 32 bits / 64 bits Pteidgui.dmg
Linux
Caixa Mágica 22 + 2.4.0 32 bits Pteid-mw_cm22_i386.deb
Caixa Mágica 22 + 2.4.0 64 bits Pteid-mw_cm22_amd64.deb
Fedora 24 + 2.4.0 32 bits Pteid-mw_fedora24_i386.rpm
Fedora 24 + 2.4.0 64 bits Pteid-mw_fedora24_x86_64.rpm
Opensuse 42.2 2.4.0 64 bits pteid-mw_suse42.2_x86_64.rpm
Ubuntu 14.04 2.4.0 32 bits Pteid-mw_ubuntu14.04_i386.deb
Ubuntu 14.04 2.4.0 64 bits Pteid-mw_ubuntu14.04_amd64.deb
Ubuntu 16.04 + 2.4.0 32 bits Pteid-mw_ubuntu_i386.deb
Ubuntu 16.04 + 2.4.0 64 bits Pteid-mw_ubuntu_amd64.deb

Poderá aceder ao manual de utilizador do Middleware no seguinte URL: https://svn.gov.pt/projects/ccidadao/export/349/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: https://svn.gov.pt/projects/ccidadao/export/349/middleware-offline/trunk/docs/Manual_de_SDK.pdf

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:

Linux

1 - Instalação das dependências
As dependências para a compilação do Middleware em Linux, são as seguintes:

libxerces-c-dev libssl-dev libqt4-dev swig libpcsclite-dev qt4-qmake sun-java6-jdk doxygen libpcsclite1 libccid pcscd subversion maven2 libjasper-dev

2 - Download do código

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

3 - Dentro da directoria eidmw executar o comando make e make install

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.2j.tar.gz
- xerces-c -  http://xerces.apache.org/xerces-c/build-3.html#Windows
- xml-security-c -  http://santuario.apache.org/download.html
- libcurl -  https://curl.haxx.se/download.html

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.2 - 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- Configurar a directoria onde se encontra o ficheiro xsec_1.lib do xml-security-c nas propriedades do projecto applayer: Properties -> Linker -> Additional Library Directories
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.