Importante

Translation is a community effort you can join. This page is currently translated at 96.15%.

4. Começando a trabalhar com QtCreator e QGIS

QtCriador é um IDE dos criadores da biblioteca Qt. Com o QtCriador você pode construir qualquer projeto C++, mas é realmente otimizado para pessoas que trabalham em aplicativos baseados em Qt (incluindo aplicativos móveis).

4.1. Instalando QtCreator

O Qt Criador está disponível em todas as principais plataformas e pode ser baixado em https://www.qt.io/download (Siga a rota de código aberto). O procedimento de instalação depende da sua plataforma.

Se você estiver executando uma plataforma do tipo Unix, você pode usar a linha de comando, por exemplo, no Debian:

sudo apt install qtcreator qtcreator-doc

Depois de instalar você deve encontrá-lo em seu menu.

4.2. Preparando seu projeto

Assumimos que você já tem um clone local do QGIS contendo o código fonte, e instalou todas as dependências de construção necessárias etc. Existem instruções detalhadas para git acesso ` e :fonte:`requisitos de dependência.

Em nosso sistema, verificamos o código em $CASA/dev/cpp/QGIS e o resto do artigo foi escrito assumindo isso. Você deve atualizar esses caminhos conforme apropriado para seu sistema local.

Depois de iniciar o QtCriador faça :seleção de menus:Arquivo –> Abrir arquivo ou projeto

Depois use o diálogo de seleção de arquivo resultante para procurar e abrir este arquivo:

$HOME/dev/cpp/QGIS/CMakeLists.txt
../../_images/selectCMakeLists.png

O QtCriador analisará o projeto e você será solicitado a fornecer um local de compilação e opções na caixa de diálogo Configurar projeto.

Como queremos que o QGIS tenha recursos de depuração, habilitaremos apenas a entrada de depuração e a preencheremos com nosso local de compilação:

  1. Marque |caixa de seleção| Selecione todos os kits habilitando a entrada Área de Trabalho

  2. Desmarque todas, exceto a |caixa de seleção| Depurar subitem

  3. Preencha o caminho com o diretório de compilação. Para nosso propósito, criamos um diretório de compilação específico para o Criador do Qt:

    $HOME/dev/cpp/QGIS/build-master-qtcreator
    

    Provavelmente é uma boa ideia criar diretórios de compilação separados para diferentes ramificações se você puder pagar pelo espaço em disco.

    ../../_images/configureProject.png

Isso é o básico. Pressione o botão Configurar projeto e o QtCriador começará a escanear a árvore de fontes para suporte de autocompletar e fazer algumas outras coisas de limpeza em segundo plano.

../../_images/configurationDone.png

Queremos ajustar algumas coisas antes de começarmos a construir.

4.3. Configurando seu ambiente de compilação

Clique no ícone Projetos à esquerda da janela do QtCriador.

../../_images/leftPanel.png

Selecione a aba de configurações Construir (normalmente ativa por padrão).

../../_images/buildSettings.png

A caixa de diálogo mostra a configuração de compilação do Depurar e permite que você edite as configurações na seção CFazer. Embora a configuração padrão deva ser suficiente para uma primeira passagem, dependendo de suas necessidades, talvez você queira habilitar mais recursos, como:

  • COM_3D = ativo para renderização em 3D

  • COM_FERRAMENTAS_PERSONALIZADAS = ativado para adicionar ferramentas personalizadas QGIS para design de interface

Pressione Aplicar Alterações de Configuração.

Por padrão, o Qt Criador usa todos os núcleos de CPU disponíveis para acelerar a compilação com paralelização máxima. Para evitar que seu computador congele, você deve especificar um número menor de núcleos. Na seção Etapas de construção:

  1. Pressione o menu: seleção de menu:Adicionar etapa de compilação –> e selecione Etapa do processo personalizado

  2. Preencha o novo formulário da seguinte forma:

    • Comando: fazer

    • Argumentos: -j4 para usar 4 núcleos (a configuração depende do seu dispositivo)

    • Diretório de trabalho: %{buildDir}

../../_images/customProcess.png

Nota

Além disso, se você quiser reduzir seus tempos de compilação, você pode fazer isso com ninja, uma alternativa ao fazer com opções de compilação semelhantes. Você precisaria defini-lo como o CFazer generator:

  1. Abra: seleção de menu:Ferramentas –>Opções–> Construir e executar –> Kits

  2. Selecione a entrada do kit Área de Trabalho (predefinição), exibindo suas propriedades

  3. Pressione Mudar… ao lado de CFazer gerador

Agora você está pronto para construir. Pressione o |construir| Construir na parte inferior esquerda da caixa de diálogo (ou Ctrl+B) para iniciar a compilação do projeto! O Qt Criador começará a compilar e isso pode levar algum tempo na primeira vez, dependendo do seu dispositivo.

No final da compilação, você pode executar o QGIS pressionando o botão |executarInstalar| :sup:Botão Executar.

A compilação do QGIS também gera binários no diretório de construção. Portanto, você pode executar o QGIS a partir da linha de comando usando:

cd $HOME/dev/cpp/QGIS/build-master-qtcreator
./output/bin/qgis

Às vezes você pode querer instalar o QGIS como um executável, fora do diretório de construção.

  1. Defina o CFAZER_INSTALAR_PREFIXO para algum lugar ao qual você tenha acesso de gravação (nós usamos: arquivo:${PÁGINA INICIAL}/apps). Isso evitaria sobrescrever uma instalação QGIS existente (pelo seu gerenciador de pacotes, por exemplo).

    ../../_images/customInstallPrefix.png
  2. Pressione Aplicar alterações de configuração para atualizar as configurações

  3. Pressione o botão |construir|

  4. Quando a compilação estiver completa, você encontrará o executável :arquivo:`qgis` na pasta :arquivo:`${PÁGINA INICIAL}/apps/caixa`.

4.4. Executando e depurando

Agora você está pronto para executar e depurar o QGIS. Para definir um ponto de interrupção, basta abrir um arquivo de origem e clicar na coluna da esquerda.

../../_images/breakPoint.jpeg

Agora inicie o QGIS no depurador clicando em |executar depuração| Iniciar depuração no canto inferior esquerdo da janela.