{{{
#!html
AVISO - Este projeto está em processo de migração para um repositório Github
}}}
Para encontrar o código-fonte da versão 3.0.19 ou posteriores e documentação atualizada deverá aceder [https://github.com/amagovpt/autenticacao.gov Autenticação.gov no Github]
[[PageOutline(2-4)]]
= 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: [[BR]]
[//projects/ccidadao/browser/middleware-offline/tags/builds svn.gov.pt/projects/ccidadao/browser/middleware-offline/tags/builds ]
|| '''Sistema Operativo''' || '''Versão''' || '''Arquitectura''' || '''Download''' ||
|| '''Microsoft Windows''' ||
|| Windows 7 + || 3.0.19 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/PteidMW-Basic.msi PteidMW-Basic.msi ] ||
|| Windows 7 + || 3.0.19 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/PteidMW-Basic-x64.msi PteidMW-Basic-x64.msi ] ||
|| '''macOS X''' ||
|| macOS 10.10 (Yosemite) + || 3.0.20 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw.pkg pteid-mw.pkg ] ||
|| '''Linux''' ||
|| Caixa Mágica 22 + || 2.4.6 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu14_i386.deb Pteid-mw_cm22_i386.deb ] ||
|| Caixa Mágica 22 + || 2.4.6 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu14_amd64.deb Pteid-mw_cm22_amd64.deb ] ||
|| Fedora 28 + || 3.0.16 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw-fedora.x86_64.rpm Pteid-mw_fedora24_x86_64.rpm ] ||
|| Opensuse 42.2 + || 2.4.6 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw-suse.x86_64.rpm pteid-mw-suse.x86_64.rpm ] ||
|| Ubuntu 14.04 || 2.4.6 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu14_i386.deb Pteid-mw_ubuntu14.04_i386.deb ] ||
|| Ubuntu 14.04 || 2.4.6 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu14_amd64.deb Pteid-mw_ubuntu14.04_amd64.deb ] ||
|| Ubuntu 16.04 + || 2.4.6 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu16_i386.deb Pteid-mw_ubuntu_i386.deb ] ||
|| Ubuntu 16.04 + || 2.4.6 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu16_amd64.deb Pteid-mw_ubuntu_amd64.deb ] ||
|| Ubuntu 18.04 || 3.0.20 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw_ubuntu18_amd64.deb 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. [[BR]]
Existem SDK's para as linguagens C/C++, Java e .NET C#. [[BR]]
Poderá aceder ao manual no seguinte URL: [export:/middleware-offline/trunk/docs/Manual_de_SDK.pdf Manual do SDK]
A documentação da API disponibilizada pelo SDK está disponível nos seguintes URLs:
[export:/middleware-offline/tags/version3.0.16/docs/cppdocs.zip C++]
[export:/middleware-offline/tags/version3.0.16/docs/javadocs.zip Java]
== 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 para Windows, MacOS e Linux: [//projects/ccidadao/browser/middleware-offline pteid-mw]
- Aplicação "Proof of Concept" para Android: [//projects/ccidadao/browser/middleware-android Android ]
=== Linux ===
1 - Instalação das dependências[[BR]]
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 [[BR]]
{{{
svn export https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/_src/eidmw
}}}
3 - Compilar o projecto na directoria eidmw [[BR]]
{{{
cd eidmw
./configure
make
}}}
4 - Caso pretenda instalar a aplicação e as bibliotecas do Middleware [[BR]]
{{{
make install
}}}
A aplicação utilitária será instalada em: /usr/local/bin/eidguiV2
=== 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. [[BR]]
Será assim necessário compilar as seguintes bibliotecas: [[BR]]
[[BR]]
- openSSL 1.0.2 - https://www.openssl.org/source/openssl-1.0.2q.tar.gz [[BR]]
- xerces-c - https://xerces.apache.org/xerces-c/build-3.html#Windows [[BR]]
- xml-security-c - https://santuario.apache.org/download.html [[BR]]
- libcurl - https://curl.haxx.se/download.html [[BR]]
- poppler-qt5 0.52 - https://poppler.freedesktop.org/poppler-0.52.0.tar.xz [[BR]]
[[BR]]
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
[[BR]]
Ferramentas adicionais a instalar:
- 7-zip [[BR]]
- Java JDK [[BR]]
- Swigwin 2.0.12 - disponível em https://sourceforge.net/projects/swig/files/swigwin/swigwin-2.0.12/ [[BR]]
- Windows Platform SDK [[BR]]
[[BR]]
Após configurado o ambiente conforme acima descrito,efetuar os seguintes passos: [[BR]]
1- Checkout do código fonte: https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/ [[BR]]
2- Configurar os caminhos para as dependências (x86 e x64) e ferramentas no ficheiro windows\ezbuild\vc9\set_path_vc9.bat [[BR]]
3- Abrir a Solução de VS2013 através do script windows\ezbuild\vc9\ezbuild_sln_vc9.bat [[BR]]
4- Seleccionar a configuração "Release | Win32" ou "Release | x64" [[BR]]
5- Compilar o projecto através do menu "Build solution" [[BR]]
=== Aplicação "Proof of Concept" para Android ===
A aplicação disponível consiste num projeto autónomo, desenvolvido usando o SDK Android 4.4, que não recorre ao SDK do Middleware para sistemas Desktop.
1 - Preparação do ambiente de compilação [[BR]]
Para preparar o ambiente de compilação do middleware da versão Android, deverá instalar o Eclipse no seu computador. [[BR]]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.