Data Access → Drivers → How To Implement a Data Access Driver
Passo 1: Documentação do projeto do driver na wiki:
- todo driver deverá conter uma entrada na seção principal da documentação Design and Implemenation.
- todo driver terá uma breve explicação na seção drivers dizendo se ele é nativo ou não, apontando para sua página principal.
- página principoal contendo os detalhes do projeto, seguindo a nomenclatura/hierarquia de páginas dos outros drivers:
:wiki:designimplementation:dataaccess:drivers:mydriver
Passo 2: Criação do módulo no repositório da TerraLib:
- criar uma pasta em
src/terralib
com um nome que ajude a identificar o driver - criar um arquivo chamado README na raíz desta pasta contendo informações de dependência e build do driver
- criar um arquivo template com as informações do driver para carga como plugin e colocá-lo em
resources/xml/mydriver-plugin.xml.in
Passo 3: Criar o projeto de build (CMake) para o driver
- criar uma pasta em
build/terralib
com o sufixo do driver. Exemplo: terralib_mydriver - criar os arquivos
CMakeLists.txt
emydriver.cmake
- acrescentar a entrada de build do driver em
build/terralib/CMakeLists.txt
- acrescentar o arquivo Find das bibliotecas auxiliares do driver na pasta
build/modules
- Editar o arquivo TerraLibConfig.h.in e incluir uma macro com o template:
#cmakedefine01 TE_USE_MYDRIVER
- No arquivo mydriver.cmake do projeto do driver incluir a linha:
set (TE_USE_MYDRIVER TRUE PARENT_SCOPE)
- Fazer com que o template do arquivo de configuração do plugin do driver seja gerado na pasta do plugin
Passo 4: No caso do Windows, acrescentar as bibliotecas de dependência do driver no arquivo de bibliotecas de terceiros
Passo 5: Especificar na documentação do driver as bibliotecas de terceiro que deverão estar instaladas, principalmente no Linux e Mac OSX.
Passo 6: ….