| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <meta http-equiv="content-type" content="text/html; charset=UTF-8"> |
| <meta name="author" content="alexey.vladykin@sun.com"> |
| <meta name="description" content="A short guide to working with Qt applications in NetBeans IDE or |
| Oracle Solaris Studio IDE."> |
| <meta name="keywords" content="NetBeans, Oracle Solaris Studio, IDE, Qt application, |
| tutorial, guide, user, documentation, open source, C, C++, make, dbx, gdb"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" > |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> |
| <title>Trabalhando com Aplicações Qt - Tutorial do NetBeans IDE</title> |
| </head> |
| |
| <body style="padding: 2px;"> |
| <h1>Trabalhando com Aplicações Qt - Tutorial do NetBeans IDE</h1> |
| <div class="articledate" style="margin-left: 0px;font-style:italic;"> |
| <p><em>Contribuição de <i>Alexey Vladykin</i></a> e mantida por <a href="mailto:susan.morgan@oracle.com"><i>Susan Morgan</i><br>Outubro de 2013</em> [Número da versão: V7.4-1]</div> |
| <p>Este tutorial vai orientá-lo durante a criação de um projeto de aplicação Qt simples no NetBeans IDE. A origem Qt Toolkit é uma plataforma cruzada do framework de desenvolvimento de aplicação.</p> |
| |
| <p><b>Conteúdo</b></p> |
| <img alt="O conteúdo desta página se aplica ao NetBeans IDE 6.8, 6.9, 7.3 e 7.4" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-74-73.png" title="O conteúdo desta página se aplica ao NetBeans IDE 7.3 e 7.4"> |
| |
| <ul class="toc"> |
| <li><a href="#requirements">Requisitos</a></li> |
| <li><a href="#intro">Introdução</a></li> |
| <li><a href="#qtinstall">Instalando o Software Qt 4</a></li> |
| <li><a href="#creating">Criando uma Aplicação Qt Simples</a></li> |
| <li><a href="#conclusion">Conclusão</a></li> |
| |
| </ul> |
| |
| <h2><a NAME="requirements"></a>Requisitos</h2> |
| |
| <p><b>Para seguir este tutorial, você precisa do software a seguir.</b></p> |
| <table> |
| <tbody> |
| <tr> |
| <th class="tblheader" scope="col">Software</th> |
| <th class="tblheader" scope="col">Versão Necessária</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">NetBeans IDE</a> (incluindo o suporte ao C/C++)</td> |
| <td class="tbltd1">versão 7.3 ou 7.4 do NetBeans com o plug-in C/C++</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java Development Kit</a> (JDK)</td> |
| <td class="tbltd1">Versão 7</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="../../../community/releases/74/cpp-setup-instructions.html">Compiladores C/C++ GNU (GCC)</a></td> |
| <td class="tbltd1">Versões suportadas pelo NetBeans IDE. <br>No Windows, o MinGW é obrigatório. </td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="#qtinstall">Bibliotecas Qt</a></td> |
| <td class="tbltd1">Versão 4.8 <br>Observe que Qt 5 não trabalha com este tutorial</td> |
| </tr><tr><td> |
| </tr> |
| </tbody> |
| </table> |
| <br> |
| <p>Consulte as <a href="../../../community/releases/74/install.html">Instruções de Instalação do NetBeans IDE</a> para obter informações sobre o download e a instalação do software NetBeans requerido. |
| </p> |
| |
| |
| <h2><a name="intro"></a>Introdução</h2> |
| |
| <P>O NetBeans IDE suporta a criação, construção, execução e depuração de projetos Qt sem deixar o IDE. As ferramentas Qt como qmake, moc e uic são iniciadas automaticamente conforme o necessário. Não é necessário conhecê-las nem saber nada sobre elas. Este artigo mostra como configurar o NetBeans IDE para usar o Qt 4.8 e criar uma aplicação Qt simples. </P> |
| |
| <h2><a name="qtinstall"></a>Instalando o Software Qt para Uso no NetBeans IDE</h2> |
| <p>Você deve instalar o software Qt e configurar o NetBeans para usá-lo antes de criar aplicações do Qt no IDE. </p> |
| <p class="notes"><strong>Importante: é necessário usar o Qt 4.8 para seguir este tutorial.<br><br> Se quiser usar Qt 5, consulte este artigo: <br> <a href="http://wiki.netbeans.org/Talk:HowToSetup64-BitQt5WithNetBeans7.4OnWindows"> Como Configurar o Qt 5 de 64 Bits com o NetBeans 7.4 no Windows</a></strong><br> </p> |
| <p>Consulte as instruções para configurar o Qt para sua plataforma:</p> |
| <ul type="disc"> |
| <li><a href="#setupwin">Configurando o Qt para NetBeans IDE no Windows</a></li> |
| <li><a href="#setuplinmac">Configurando Qt para NetBeans IDE em Plataformas Linux ou Mac OS X</a></li> |
| <li><a href="#setupsolaris">Configurando o Qt para NetBeans IDE nas Plataformas Solaris</a></li> |
| </ul> |
| |
| <h3><a name="setupwin"></a>Configurando o Qt 4.8 para NetBeans IDE no Windows</h3> |
| <p>Estas instruções descrevem o software que foi instalado no Windows para criar este tutorial. </p> |
| <h4>Faça Download do Software Necessário para Windows</h4> |
| <ol> |
| <li>Instale o NetBeans IDE e o módulo de plug-in C/C++, como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html"> Configurando o NetBeans IDE para C/C++/Fortran</a>. Não instale compiladores ainda.</li> |
| <li>Saia do NetBeans IDE.</li> |
| <li>Efetue download do instalador do MinGW em <a href="http://sourceforge.net/projects/mingw">http://sourceforge.net/projects/mingw</a>.</li> |
| <li>Execute o instalador do MinGW, que deve ter um nome de arquivo semelhante a <tt>mingw-get-inst-20120426.exe</tt>.</li> |
| <li>No instalador do MinGW, selecione os seguintes componentes para instalação: |
| <ul><li>C</li> |
| <li>C++</li> |
| <li>Sistema Básico MSYS</li> |
| <li>Kit de Ferramentas para Desenvolvedor do MinGW</li> |
| </ul> |
| O instalador leva alguns momentos para fazer download e extrair os pacotes de software. Por padrão, o MinGW é instalado no <tt>C:\MinGW</tt>.</li> |
| <li>Faça download do software Qt de <a href="http://qt-project.org/downloads">http://qt-project.org/downloads</a> e instale-o. <br> |
| <ul><li>Bibliotecas de Qt 4.8.5 para Windows (minGW 4.4 317 MB) </li> |
| <li>Criador do Qt 2.8.1 para Windows (51 MB) </li></ul> |
| </ol> |
| <h4>Edite o Caminho para o Windows</h4> |
| <p>É necessário editar a variável de ambiente PATH no Windows para adicionar os caminhos aos binários para Qt, MinGW e MSYS. Se você tiver instalado com o default, os caminhos são:</p> |
| <ul> |
| <li><tt>C:\Qt\4.8.5\bin</tt></li> |
| <li><tt>C:\MinGW\bin</tt></li> |
| <li><tt>C:\MinGW\MSYS\1.0\bin</tt></li> |
| </ul> |
| <p><b>Para adicionar os caminhos à sua variável de caminho do ambiente:</b></p> |
| <ol> |
| <li>Abra a janela Variáveis de Ambiente: |
| <ul> |
| <li>No Windows XP e Windows 2000: clique com o botão direito do mouse em Meu Computador > Propriedades > guia Avançadas > botão Variáveis do Ambiente.</li> |
| <li>No Windows Vista e Windows 7: clique com o botão direito do mouse em Meu Computador > Propriedades > link Configurações Avançadas do Sistema > botão Variáveis do Ambiente.</li></ul> |
| <li>Na janela Variáveis do Ambiente, selecione a variável Path na seção Variáveis do Sistema e clique em Editar.</li> |
| <li>No final do caminho, insira um ponto-e-vírgula e adicione os caminhos até os executáveis para Qt, MinGW e MSYS. Use pontos-e-vírgulas entre os caminhos e não use nenhum espaço. Tenha cuidado para não remover nada do PATH ou seu computador pode não funcionar corretamente. <br> |
| <p>Quando terminar, o caminho deve ser semelhante ao seguinte:</p> |
| <pre>%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem; |
| %SYSTEMROOT%\System32\WindowsPowerShell\v1.0;C:\MinGW\bin;C:\MinGW\MSYS\1.0\bin;C:\Qt\4.8.5\bin</pre> |
| </li> |
| <li>Clique em OK na janela Variáveis do Ambiente.</li> |
| </ol> |
| |
| <h4>Criar um Conjunto de Ferramentas para MinGW e Qt</h4> |
| <p>Você deve criar um novo conjunto de ferramentas que use compiladores MinGW, os comandos de MSYS e comandos do Qt.</p> |
| <p><b>Para criar um novo conjunto de ferramentas:</b></p><ol> |
| <li>Inicie o NetBeans IDE e abra a janela Serviços escolhendo Janela > Serviços. |
| <li>Expanda o nó Hosts da Compilação C/C++, clique com o botão direito do mouse no nó Conjunto de Ferramentas e selecione Adicionar Novo Grupo de Ferramentas.<br><br> <img alt="Tela da opção Adicionar Novo Conjunto de Ferramentas" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-addtool.png"></li> |
| <li>Especifique o diretório de instalação bin MinGW como o diretório de base de conjunto de ferramentas (por exemplo, <tt>C:\mingw\bin</tt>). <br> A Família do Conjunto de Ferramentas e o Nome do Conjunto de Ferramentas deverão ser preenchidos automaticamente em um MinGW. |
| </li> |
| <li>Altere o Nome do Conjunto de Ferramentas para MinGW_Qt e clique em OK.<br> |
| </li> |
| <li>Clique com o botão direito do mouse no novo conjunto de ferramentas MinGW_Qt, no nó Conjunto de Ferramentas, na janela Serviços, e selecione Propriedades. <br>Os caminhos para as ferramentas devem ser semelhantes à imagem a seguir. <br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-toolpaths.png" alt="Tela mostrando caminhos de ferramenta o MinGW." class="margin-around"> |
| </li> |
| <li>Verifique os comandos para o Comando Make e o Comando QMake e corrija-os, se necessário.<br> O comando Make deve ser <tt>C:\MinGW\MSYS\1.0\bin\make.exe</tt> e o comando QMake deve ser <tt>C:\Qt\4.8.5\bin\qmake.exe</tt>.</li> |
| <li>Clique no botão Default enquanto MinGW_Qt é selecionado para torná-lo o conjunto de ferramentas default.</li> |
| <li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li> |
| </ol> |
| |
| <h3><a name="setuplinmac"></a>Configurando Qt para NetBeans IDE em Plataformas Linux ou Mac OS X</h3> |
| <ol><li>Faça download das bibliotecas de Qt para sua plataforma Linux ou Mac OS X em <a href="http://qt-project.org/downloads" target="_blank">http://qt-project.org/downloads</a> ou obtenha-as no repositório do pacote Linux.</li> |
| <li>Se os compiladores ainda não estiverem presentes no seu sistema, instale-os como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html">Configurando o NetBeans IDE para C/C++/Fortran</a>. </li> |
| <li>Adicione os caminhos para os compiladores e ferramentas de Qt para sua variável de caminho PATH</li> |
| <li>Em uma janela de terminal, digite <tt>qmake -v</tt> e <tt>gcc --version</tt> para verificar se os comandos estão no seu caminho.</li> |
| <li>Quando as ferramentas estiverem disponíveis na linha de comando, inicie o NetBeans IDE e verifique as propriedades dos Conjuntos de Ferramentas para conferir se os caminhos para compiladores, comando make e comando qmake estão corretos.</li> |
| <li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li> |
| </ol> |
| |
| |
| <h3><a name="setupsolaris"></a>Configurando o Qt para NetBeans IDE nas Plataformas Oracle Solaris</h3> |
| <p>Binários para Qt não estão disponíveis para plataformas Oracle Solaris. No entanto, é possível criar o Qt da compilação da origem e usá-la com o NetBeans IDE. |
| </p> |
| <ol> |
| <li>Instale seus compiladores como explicado em <a href="../../../community/releases/74/cpp-setup-instructions.html"> Configurando o NetBeans IDE para C/C++/Fortran</a>. </li> |
| <li>Faça download da fonte do Qt em <a href="ftp://ftp.qt-project.org/qt/source/">ftp://ftp.qt-project.org/qt/source/</a></li> |
| <li>Consulte a documentação do Qt <a href="http://qt-project.org/doc/qt-4.8/install-X11.html">Instalando Qt para Plataformas X11</a> para obter instruções de compilação.</li> |
| <li>Depois de compilar com sucesso os binários de Qt, edite sua variável de ambiente PATH para adicionar o caminho aos binários de Qt.</li> |
| <li>Em uma janela de terminal, digite <tt>qmake -v</tt> e <tt>gcc --version</tt> para verificar se os comandos estão no seu caminho.</li> |
| <li>Quando os compiladores GNU e as ferramentas Qt estiverem disponíveis na linha de comando, inicie o NetBeans IDE. </li> |
| <li>Verifique as propriedades dos Conjuntos de Ferramentas para conferir se os caminhos para os compiladores e comando qmake estão corretos.</li> |
| <li>Prosseguir para <a href="#creating">Criando uma Aplicação Qt Simples</a> neste artigo.</li> |
| </ol> |
| |
| <H2><a name="creating"></a>Criando uma Aplicação Qt Simples</H2> |
| |
| <P>Neste tutorial, você criará uma aplicação Qt simples "Hello World", similar à amostra Hello Qt World, que pode ser encontrado em Amostras->C/C++->Hello Qt World.</P> |
| <p>Estas instruções foram escritas para plataformas Windows. Usuários de plataformas Mac, Linux e Solaris podem executar as mesmas etapas usando um conjunto de ferramentas GNU em que o caminho para <tt>qmake</tt> seja especificado corretamente. |
| <ol> |
| <li>Primeiro, crie um novo projeto. Selecione Aplicação Qt C/C++ na caixa de diálogo Novo Projeto e clique em Próximo.<br> <img alt="Nova caixa de diálogo do projeto" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-create-new-project.png"> |
| |
| </li> |
| |
| <li>Na caixa de diálogo, altere o nome e a localização do projeto se for necessário. |
| <p>Marque Criar Arquivo Principal e selecione o conjunto de ferramentas MinGW_qt. Em seguida, clique em Finalizar</p> |
| <img alt="Caixa de diálogo do projeto Nova Qt" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-create-main-file.png"> |
| <p>A aparência do novo projeto deve ser semelhante a esta:</p> |
| <img alt="Projeto Qt e arquivo main.cpp" class="b-all margin-around" src="../../../images_www/articles/73/cnd/qt/qt-app-maincpp.png"> |
| </li> |
| <li>Clique com o botão direito do mouse no nó do projeto e selecione Propriedades para abrir a caixa de diálogo Propriedades do Projeto. Clique na categoria Qt. Usuários avançados podem ajustar muitos elementos nas propriedades de projeto do Qt, mas, para este tutorial, deixe tudo como está.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-project-properties.png" alt="Caixa de diálogo propriedades do projeto Qt" class="b-all margin-around"> |
| </li> |
| <li>Clique na categoria Executar e defina a propriedade Tipo de Console para o Terminal Externo e clique em OK.</li> |
| <li>Em seguida, você pode criar um form. Clique com o botão direito do mouse em Arquivos de Recurso e selecione Novo->Form Qt.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-app-resource-files.png" alt="Adicionando arquivos de recurso para o projeto Qt" class="b-all margin-around"> |
| </li> |
| <li>Na caixa de diálogo Form Qt, digite <b>HelloForm</b> em Nome do form e selecione Caixa de diálogo sem Botões em Tipo de Form. Marque Criar Classe de Encapsulador C++ e clique em Finalizar.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-new-form.png" alt="form novo Qt" class="b-all margin-around"> |
| <p>São criados três arquivos (<tt>HelloForm.ui</tt>, <tt>HelloForm.cpp</tt>, <tt>HelloForm.h</tt>) e o IDE abre automaticamente o Qt Designer para que você edite o novo form (<tt>HelloForm.ui</tt>).</p> |
| <img SRC="../../../images_www/articles/73/cnd/qt/qt-designer.png" alt="Qt Designer abre automaticamente" class="b-all margin-around"> |
| </li> |
| <li>Use seus conhecimentos sobre GUI para criar um form semelhante ao exibido abaixo. Adicione ao novo form dois widgets do QLineEdit e altere o nome do primeiro widget para <tt>nameEdit</tt> e o do segundo widget para <tt>helloEdit</tt>.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-designer-form.png" alt="Designer Qt com o form criado" class="b-all margin-around"> |
| </li> |
| <li>Ao finalizar a criação do form, salve-o e feche o Qt Designer. O projeto tem a aparência mostrada na figura. <br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form.png" alt="Arquivo do código-fonte do form Hello" class="b-all margin-around"> <br> |
| <P>Todos os arquivos HelloForm recém-criados são colocados na mesma pasta lógica Arquivos de Recurso. Se você preferir ter CPP arquivos nos arquivos de origem e arquivos H nos Arquivos do Cabeçalho -, arraste e solte-os para a pasta de lógica desejada.</P> |
| <P>Você deverá ver um pequeno ponto de interrogação na guia Projetos para indicar a presença de diretivas <tt>#include</tt> interrompidas. O <tt>setupUi</tt> sublinhado em verde é uma consequência da diretiva <tt>#include ui_HelloForm.h</tt> interrompida, o que ocorre no arquivo <tt>HelloForm.h</tt>. O arquivo de inclusão <tt>ui_HelloForm.h</tt> ainda não existe realmente e será gerado com a primeira compilação do projeto. É assim que funciona o sistema de construção do Qt. </P> |
| |
| |
| </li> |
| <li>Clique no botão Compilar Projeto na barra de ferramentas e o erro deverá desaparecer quando o arquivo <tt>ui_HelloForm.h</tt> for gerado.</li> |
| <li>Abra <tt>main.cpp</tt> e insira duas linhas de código responsáveis pela criação e exibição do HelloForm, como mostrado nas linhas 17 e 18 da figura abaixo. Não esqueça de incluir <tt>HelloForm.h</tt>, como mostrado na linha 9.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-edit.png" alt="Editando o form Hello arquivos de origem" class="b-all margin-around"> |
| </li> |
| <li>Clique no botão Executar na barra de ferramentas para executar a aplicação.<br> Primeiro, você verá uma janela de terminal e depois a caixa de diálogo que você criou no Qt Designer.</li> |
| <li>Digite algo no campo de texto e pressione Enter e você deverá ver que nada ocorre. |
| <P>Para permitir que a aplicação responda, você deverá definir um slot e conectá-lo a um sinal <tt>textChanged</tt> acionado pelo campo de texto. Para aprender mais sobre sinais e slots Qt leia <a HREF="http://doc.qt.digia.com/4.6/signalsandslots.html" TARGET="_blank">http://doc.qt.digia.com/4.6/signalsandslots.html</a></P> |
| </li> |
| <li>Vá para <tt>HelloForm.h</tt> e declare esse slot como mostrado nas linhas 18 e 19 na seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-h.png" alt="Editando o arquivo de inclusão do form Hello" class="b-all margin-around"> |
| </li> |
| <li>Em seguida, vá para <tt>HelloForm.cpp</tt> e insira a definição de slot como mostrado nas linhas 17 a 23 da seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-slot.png" alt="Adicionar Slot para formar os arquivos de código-fonte" class="b-all margin-around"> |
| </li> |
| <li>Finalmente, conecte o sinal com o slot inserindo código no construtor HelloForm, como mostrado nas linhas 12 e 13 da seguinte figura:<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-hello-form-cpp.png" alt="Adicionar Slot ao construtor do form Hello" class="b-all margin-around"> |
| </li> |
| <li>Agora, execute a aplicação e, quando a caixa de diálogo for exibida, clique no campo de entrada superior, digite seu nome e o campo inferior irá refletir Hello para você, como mostrado abaixo.<br> <img SRC="../../../images_www/articles/73/cnd/qt/qt-app-running.png" alt="Qt Hello World APP em execução" class="b-all margin-around"> |
| </li> |
| </ol> |
| |
| <H2><a name="conclusion"></a>Conclusão</H2> |
| <p>Este artigo mostrou como configurar seu ambiente para você usar o NetBeans IDE com bibliotecas e ferramenta Qt.</p> |
| <P>Crie e desenvolva aplicações Qt com o NetBeans e envie seu feedback para a <a HREF="mailto:users@cnd.netbeans.org">lista de endereços CND </a> e para o <a href="https://forums.netbeans.org/cnd-users.html">fórum do Usuário do NetBeans C/C++</a>.</P> |
| <P>Encontrou um erro ou deseja sugerir uma melhoria? Arquive-os em <a HREF="https://netbeans.org/bugzilla/enter_bug.cgi?component=cnd">https://netbeans.org/bugzilla/enter_bug.cgi?component=cnd</a> (registro netbeans.org requerido)</P> |
| |
| <h2>Consulte Também</h2> |
| <p>Consulte a <a href="https://netbeans.org/kb/trails/cnd.html">Trilha do Aprendizado C/C++</a> para obter mais artigos sobre o desenvolvimento com C/C++/Fortran no NetBeans IDE.</p> |
| |
| <div class="feedback-box"><a href="mailto:users@cnd.netbeans.org?subject=Feedback:%20Working%20with%20Qt%20Applications%20-%20NetBeans%20IDE%207.4%20Tutorial">Enviar Feedback neste Tutorial</a></div> |
| <br style="clear: both;"> |
| </BODY> |
| </HTML> |