[[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.16 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/PteidMW-Basic.msi PteidMW-Basic.msi ] || || Windows 7 + || 3.0.16 || 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.16 || 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.16 || 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.