Instruções para a configuração do conector mysqlc++ no Visual Studio 2015

Transcrição

1 ESCOLA POLITÉCNICA DA UNIVERSIDADE DE SÃO PAULO PCS Laboratório de Engenharia de Software I Instruções para a configuração do conector mysqlc++ no Visual Studio 2015 Pré-requisitos (por Michelet del Carpio Chávez) 1. Windows 7, 8.1, ou Visual Studio 2015 e 2013 instalado. 3. Biblioteca Boost C baixada e descompactada. 4. Conector MySQL x86-64bits C++/mysql-connector-c++-noinstall winx64.zip baixado e descompactado. Passos 1. Criar um projeto CLR ou escolher um projeto já existente. Para criar um projeto CLR em C++, no Visual Studio, vá para File->New->Project

2 Escolha um projeto c++ do tipo CLR, dê um nome e clique em OK. 2. Na barra de ferramentas, alterar a configuração do Visual Studio de Debug para Release e modificar a plataforma de destino para x64 pois as bibliotecas e o sistema operacional são dessa plataforma. Isto é preciso pois o binário do conector mysql-c++ é compilado para ser usado em modo Release. 3. Alterar o toolset do projeto para usar o visual studio Para isso, acesse o menu de propriedades do projeto apertando ALT + F7, ou fazendo click direito no projeto e clicando em Properties.

3 3.1 Vá para General e clique na coluna à frente de Platform Toolset para escolher Visual Studio 2013 (v120).

4 Obs: Isto se deve a que o arquivo binário para windows fornecido pela Oracle (dona do MySql Server), só é compatível com o CLR (common language runtime) da versão 2013 do visual studio. Em aplicações reais, é preciso pegar o código fonte e compilar um binário (o.lib) adequado com a plataforma que se estiver utilizando. O CLR é preciso para criar aplicações gráficas no visual studio. Para aplicações em linha de comando não é necessário ter o Visual Studio 2013 instalado. 4. Incluir os caminhos das bibliotecas (arquivos.h) do conector Mysql para C++ e da biblioteca Boost (que é uma dependência do conector mysql). Essas bibliotecas foram descompactadas dentro da pasta d:\pcs3443 das máquinas do Labprog. Para incluir os cabeçalhos, ainda nas propriedades do projeto, clicar em C/C++ -> General. No campo Additional Include Directories, clicar na coluna em branco na frente dele e logo clicar em Edit. A seguinte deve aparecer a seguinte tela:

5 Se a opção C/C++ não aparecer é porque o projeto ainda não tem nenhum arquivo de código fonte. Adicione um ao projeto que a opção deverá aparecer. 4.1 Agora é preciso clicar na pasta amarela para poder incluir o caminho das bibliotecas: Deve aparecer uma tela do windows explorer para escolher a pasta onde estão as bibliotecas. Vá para d:\pcs3443\boost_1_64_0 e escolha essa pasta.

6 4.2 Depois repita o processo para incluir D:\pcs3443\mysql-connector-c++-noinstall winx64 5. Indicar o caminho onde está a implementação das bibliotecas. Depois de incluir os cabeçalhos, é preciso indicar o local da implementação da biblioteca em si. A biblioteca está em D:\pcs3443\mysql-connector-c++-noinstall winx64\lib e usaremos o arquivo mysqlcppconn-static.lib pois iremos fazer um build estático. Para incluir o caminho da biblioteca, ainda no Configuration Properties, ir para Linker->General e clicar na coluna à frente de Additional Library Directories, no botão mais à direita, e logo clicar em Edit.

7 Deve aparecer uma janela do windows explorer para escolhermos a pasta da biblioteca, navegar até D:\pcs3443\mysql-connector-c++-noinstall winx64\lib e escolher essa pasta. 5.1 Para indicar o arquivo que será utilizado, ir para Linker -> Input e na coluna à frente de Additional Dependencies, digitar: mysqlcppconn-static.lib

8 6. Indicar as directivas do pre-processador para não chamar uma DLL. Como estamos fazendo uma compilação estática, precisamos indicar que o valor CPPCONN_PUBLIC_FUNC esteja vazio. Para isso, ainda na janela de Configuration Properties ir para C/C++ -> Preprocessor, clicar na coluna à frente de Preprocessor Definitions e escolher Edit. Deve aparecer a seguinte tela. Na primeira linha, digitar CPPCONN_PUBLIC_FUNC= Clicar em OK e logo em aplicar.

9 7. Finalmente devemos nos certificar que vamos utilizar a versão dinâmica da biblioteca de tempo de execução do windows. A versão 1.19 da biblioteca exige isso. Para isso, ainda na janela de Configuration Properties, ir para C/C++ -> Code Generation e em Runtime Library deve estar escolhido Multi-threaded DLL (/MD) Agora é possível utilizar a biblioteca de conexão mysql c++ em aplicações que usem a CLR do Windows.