Instalação no Linux (.deb)

No Ubuntu 22.04 / Debian, a forma recomendada de instalar o DroneField é o pacote nativo .deb. O runtime autocontido do .NET 10 já vem incluído, então a máquina não precisa de nenhum .NET pré-instalado. Para outras distribuições, use o AppImage descrito na página Instalação.

Distribuição compatível

O sistema de destino do .deb é o Ubuntu 22.04 LTS.

Ubuntu 24.04

O runtime nativo do OpenCV incluído no pacote foi compilado com base na pilha de sistema do Ubuntu 22.04. No Ubuntu 24.04 ele não carrega em tempo de execução (versões principais incompatíveis de libtesseract, ffmpeg, libtiff e OpenEXR). No 24.04, use por enquanto o AppImage — uma compilação dedicada para 24.04 virá depois.

Passo 1 — Baixar o pacote

Entre em my.dronefield.app, abra Downloads no menu à esquerda e, no cartão Versão estável mais recente, baixe o .deb para Linux (cerca de 100–130 MB). O arquivo tem um nome como dronefield_26.2.18_amd64.deb.

Passo 2 — Instalação

Na pasta onde você baixou o arquivo:

sudo apt install ./dronefield_26.2.18_amd64.deb

Dica

Use apt install ./file.deb em vez de dpkg -i ./file.deb — o apt resolve automaticamente as dependências de execução (libx11-6, libvulkan1 etc.). Com dpkg -i, você teria que instalar depois as dependências ausentes manualmente com sudo apt install -f.

Passo 3 (opcional) — Verificar o download

As versões assinadas vêm com uma assinatura .deb.asc separada ao lado do .deb. Basta o gnupg padrão para verificá-la. Importe uma única vez a chave de publicação do editor:

wget https://dronefield.app/keys/dronefield-release.asc
gpg --import dronefield-release.asc

Em seguida, verifique o pacote baixado com ela:

gpg --verify dronefield_26.2.18_amd64.deb.asc dronefield_26.2.18_amd64.deb

A linha Good signature from "DroneSpot Kft <support@dronefield.app>" significa que o pacote é autêntico. Na primeira execução também aparece WARNING: This key is not certified with a trusted signature — isso é esperado, pois a chave é autoassinada pelo editor. O que importa é que a impressão digital (fingerprint) corresponda à publicada em dronefield.app/keys. Se aparecer BAD signature ou Can't check signature, pare e entre em contato com o suporte.

Passo 4 — Após a instalação

• Surge uma entrada DroneField no menu de aplicativos, na categoria Educação / Ciência (Education / Science).
• Também pode ser iniciado pelo terminal com dronefield (de qualquer diretório de trabalho).
• Os arquivos do programa ficam em /usr/lib/dronefield/ (somente leitura; apenas o root pode modificá-los).
• O ícone é instalado em todos os tamanhos padrão (16–256 px).

Passo 5 — Primeira inicialização

Na primeira inicialização aparece uma tela de login:

1. Informe o e-mail e a senha da sua conta do portal.
2. Clique em Entrar.
3. O DroneField registra seu dispositivo automaticamente na sua conta (consulte Gerenciamento de dispositivos).
4. Leia e aceite o Contrato de Licença de Usuário Final (EULA). É uma etapa única; se o EULA for atualizado mais tarde, a aceitação será solicitada novamente.

Agora você pode criar seu primeiro projeto — consulte Primeiro projeto em 10 minutos.

Seus projetos ficam por padrão em ~/DroneField/. Para alterar o local, consulte Instalação → Pasta de dados e projetos.

Desinstalação

sudo apt remove dronefield     # mantém a configuração em ~/.config/
sudo apt purge dronefield      # remove também os dados do debconf

Seus projetos em ~/DroneField/ nunca são tocados por remove ou purge.

Solução de problemas

Se o aplicativo não iniciar com o erro «shared object not found», falta uma biblioteca de execução. Instale as dependências ausentes com:

sudo apt install -f

Se o erro persistir, entre em contato com o suporte informando o nome exato do .so ausente que aparece na mensagem de erro.