7 | | |
8 | | |
9 | | [[PageOutline(2-4)]] |
10 | | |
11 | | = Projeto Open Source do Middleware do Cartão de Cidadão Português = |
12 | | |
13 | | |
14 | | == Introdução == |
15 | | |
16 | | === Objectivos === |
17 | | |
18 | | O objectivo deste projecto é disponibilizar uma nova versão de middleware que facilite e potencie a utilização do Cartão de Cidadão. |
19 | | |
20 | | |
21 | | == Instalação da versão Offline == |
22 | | A instalação da versão Offline do middleware, está disponível para vários sistemas operativos em formato de pacotes de instalação. |
23 | | Poderá assim descarregar os pacotes preparados para instalação na seguinte localização: [[BR]] |
24 | | |
25 | | |
26 | | [//projects/ccidadao/browser/middleware-offline/tags/builds svn.gov.pt/projects/ccidadao/browser/middleware-offline/tags/builds ] |
27 | | |
28 | | |
29 | | || '''Sistema Operativo''' || '''Versão''' || '''Arquitectura''' || '''Download''' || |
30 | | || '''Microsoft Windows''' || |
31 | | || Windows 7 + || 3.0.19 || 32 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/PteidMW-Basic.msi PteidMW-Basic.msi ] || |
32 | | || Windows 7 + || 3.0.19 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/PteidMW-Basic-x64.msi PteidMW-Basic-x64.msi ] || |
33 | | || '''macOS X''' || |
34 | | || macOS 10.10 (Yosemite) + || 3.0.20 || 64 bits || [//projects/ccidadao/repository/middleware-offline/tags/builds/lastversion/pteid-mw.pkg pteid-mw.pkg ] || |
35 | | |
36 | | || '''Linux''' || |
37 | | || 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 ] || |
38 | | || 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 ] || |
39 | | || 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 ] || |
40 | | || 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 ] || |
41 | | || 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 ] || |
42 | | || 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 ] || |
43 | | || 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 ] || |
44 | | || 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 ] || |
45 | | || 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 ] || |
46 | | |
47 | | 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 |
48 | | |
49 | | |
50 | | == SDK == |
51 | | |
52 | | 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]] |
53 | | Existem SDK's para as linguagens C/C++, Java e .NET C#. [[BR]] |
54 | | |
55 | | Poderá aceder ao manual no seguinte URL: [export:/middleware-offline/trunk/docs/Manual_de_SDK.pdf Manual do SDK] |
56 | | |
57 | | A documentação da API disponibilizada pelo SDK está disponível nos seguintes URLs: |
58 | | |
59 | | [export:/middleware-offline/tags/version3.0.16/docs/cppdocs.zip C++] |
60 | | |
61 | | [export:/middleware-offline/tags/version3.0.16/docs/javadocs.zip Java] |
62 | | |
63 | | |
64 | | == Compilar o Middleware do Cartão de Cidadão == |
65 | | |
66 | | === Download do Código fonte === |
67 | | |
68 | | Todo o código fonte está disponível nos seguintes URL's: |
69 | | - Middleware para Windows, MacOS e Linux: [//projects/ccidadao/browser/middleware-offline pteid-mw] |
70 | | |
71 | | - Aplicação "Proof of Concept" para Android: [//projects/ccidadao/browser/middleware-android Android ] |
72 | | |
73 | | |
74 | | |
75 | | === Linux === |
76 | | |
77 | | 1 - Instalação das dependências[[BR]] |
78 | | As dependências para a compilação do Middleware em Linux (nomes de pacotes para a distribuição Ubuntu), são as seguintes: |
79 | | {{{ |
80 | | 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 |
81 | | }}} |
82 | | |
83 | | 2 - Checkout do código-fonte [[BR]] |
84 | | {{{ |
85 | | svn export https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/_src/eidmw |
86 | | }}} |
87 | | |
88 | | 3 - Compilar o projecto na directoria eidmw [[BR]] |
89 | | {{{ |
90 | | cd eidmw |
91 | | ./configure |
92 | | make |
93 | | }}} |
94 | | |
95 | | 4 - Caso pretenda instalar a aplicação e as bibliotecas do Middleware [[BR]] |
96 | | {{{ |
97 | | make install |
98 | | }}} |
99 | | A aplicação utilitária será instalada em: /usr/local/bin/eidguiV2 |
100 | | |
101 | | === Windows === |
102 | | |
103 | | '''Instruções para build em Windows (Visual Studio 2013)''' |
104 | | |
105 | | É 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]] |
106 | | Será assim necessário compilar as seguintes bibliotecas: [[BR]] |
107 | | [[BR]] |
108 | | - openSSL 1.0.2 - https://www.openssl.org/source/openssl-1.0.2q.tar.gz [[BR]] |
109 | | - xerces-c - https://xerces.apache.org/xerces-c/build-3.html#Windows [[BR]] |
110 | | - xml-security-c - https://santuario.apache.org/download.html [[BR]] |
111 | | - libcurl - https://curl.haxx.se/download.html [[BR]] |
112 | | - poppler-qt5 0.52 - https://poppler.freedesktop.org/poppler-0.52.0.tar.xz [[BR]] |
113 | | [[BR]] |
114 | | 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 |
115 | | [[BR]] |
116 | | Ferramentas adicionais a instalar: |
117 | | - 7-zip [[BR]] |
118 | | - Java JDK [[BR]] |
119 | | - Swigwin 2.0.12 - disponível em https://sourceforge.net/projects/swig/files/swigwin/swigwin-2.0.12/ [[BR]] |
120 | | - Windows Platform SDK [[BR]] |
121 | | [[BR]] |
122 | | Após configurado o ambiente conforme acima descrito,efetuar os seguintes passos: [[BR]] |
123 | | 1- Checkout do código fonte: https://svn.gov.pt/projects/ccidadao/repository/middleware-offline/trunk/ [[BR]] |
124 | | 2- Configurar os caminhos para as dependências (x86 e x64) e ferramentas no ficheiro windows\ezbuild\vc9\set_path_vc9.bat [[BR]] |
125 | | 3- Abrir a Solução de VS2013 através do script windows\ezbuild\vc9\ezbuild_sln_vc9.bat [[BR]] |
126 | | 4- Seleccionar a configuração "Release | Win32" ou "Release | x64" [[BR]] |
127 | | 5- Compilar o projecto através do menu "Build solution" [[BR]] |
128 | | |
129 | | === Aplicação "Proof of Concept" para Android === |
130 | | 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. |
131 | | |
132 | | 1 - Preparação do ambiente de compilação [[BR]] |
133 | | 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. |
134 | | |
135 | | 2 - Deverá instalar os devidos plugins(Android Development Tools) e configurar o ambiente de desenvolvimento Android no Eclipse. |
136 | | |
137 | | 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. |
138 | | |
139 | | |