Ficheiros
Aceder e organizar ficheiros
Aceder e organizar ficheiros
Nesta página você pode saber como contribuir para Ficheiros. Se você estiver interessado em informações gerais sobre este aplicativo, visite a página Apps for GNOME.
O texto original dos aplicativos geralmente é escrito em inglês americano. A tradução para outros idiomas pode ser adicionada pelos tradutores separadamente. A tradução geralmente abrange a interface do usuário do aplicativo, bem como os metadados mostrados em locais como Programas ou apps.gnome.org. As abreviaturas comuns usadas neste contexto são l10n (localização, em inglês) e i18n (internacionalização, em inglês).
Este aplicativo é traduzido através do sistema de tradução do GNOME chamado Damned Lies.
Ao relatar um problema ou sugerir um recurso, pode ser útil basear o relatório na versão mais recente do aplicativo. Para tanto, você pode verificar os métodos de instalação abaixo.
Se você encontrou um problema ou deseja propor uma alteração, tente certificar-se de que experimentou a versão mais recente de Ficheiros. Você pode verificar a versão atual na seção “Sobre” dos aplicativos.
A última versão lançada no Flathub é a versão ?.
Este aplicativo permite instalar uma versão de seu status de desenvolvimento atual. Tais instalações eram tradicionalmente geradas todas as noites, dando-lhes o nome de “nightly builds”. Hoje em dia, eles costumam ser regenerados sempre que a versão principal de desenvolvimento muda.
Aviso: As compilações nightly de aplicativos devem ser usadas apenas para testes e não para tarefas reais. Você pode identificar compilações noturnas do aplicativo em seu sistema por meio das listras no ícone do aplicativo e das listras na barra de cabeçalho do aplicativo. Eles geralmente usam uma configuração diferente de outras instalações deste aplicativo. No entanto, não há garantia de que a instalação destas aplicações funcionará conforme pretendido. Nunca trabalhe em dados com versões noturnas de aplicativos sem ter backups disponíveis.
A versão nightly também pode ser instalada via Console se o repositório nightly já estiver configurado.
$ flatpak install gnome-nightly org.gnome.Nautilus.Devel
$ flatpak run org.gnome.Nautilus.Devel
A detecção de problemas e regressões antes que cheguem a uma versão estável é muito valioso para um projeto. Você pode ajudar com isso testando uma versão a ser lançada.
Isso é especialmente útil durante o período de congelamento de recursos, que é dedicado a encontrar e corrigir bugs.
Você pode fazer isso experimentando a versão nightly do aplicativo.
Como um aplicativo principal, ele também vem pré-instalado no GNOME OS Nightly, que você pode instalar como uma máquina virtual.
Para muitos aplicativos, o rastreador de problemas é um local central para coordenação do desenvolvimento de aplicativos. Ele não é usado apenas para rastrear todos os problemas existentes, mas também para planejar novos recursos e outras tarefas diversas.
Relatar problemas encontrados ao usar o aplicativo pode ser de grande valor para os mantenedores do aplicativo. No entanto, o processamento de relatórios de problemas também pode levar um tempo considerável. Você pode realizar parte do trabalho tentando as seguintes etapas:
Pesquise o rastreador de problemas para descobrir se o problema já foi relatado.
Verifique se o problema também existe na versão mais recente do aplicativo.
Se aplicável, tente descobrir em quais circunstâncias exatas o problema ocorre.
Relate todas as informações potencialmente relevantes, como a versão do aplicativo que expõe o comportamento.
Rastrear a causa exata de um problema pode ser uma tarefa muito importante. Especialmente para problemas marcados com rótulos como “Needs Diagnosis” or “Needs Information”. Se você conseguir reproduzir, ou seja, acionar você mesmo o problema relatado, poderá tentar se aprofundar. Isso pode ir desde descobrir em quais condições exatas o problema aparece, até executar o aplicativo com saída de depuração habilitada, até adicionar depure saídas para o código que restringem o problema.
A maioria dos aplicativos também lida com solicitações de recursos por meio do rastreador de problemas. Observe que implementar recursos e mantê-los como parte da base de código no futuro pode exigir uma quantidade significativa de trabalho adicional. Portanto, você deve considerar se um novo recurso pode ser relevante o suficiente para fazer parte deste aplicativo.
Ao sugerir um novo recurso, é útil focar na questão de qual problema prático o recurso deve resolver. Não sobre como o aplicativo deve resolver o problema ou como seria exatamente uma implementação. De preferência, você também pode dar um exemplo prático de onde precisou do recurso.
O rastreador de problemas também pode ajudá-lo a encontrar tarefas em aberto que você pode resolver. Antes de implementar um novo recurso, geralmente é uma boa ideia verificar com os mantenedores se as solicitações de mesclagem para esse recurso serão aceitas.
Este aplicativo também possui tarefas rotuladas com a tag “Newcomer”. Essas tarefas geralmente exigem menos conhecimento prévio ou são menos complexas.
Se você deseja corrigir um erro de digitação, alterar a interface do usuário ou trabalhar no código do aplicativo, as informações a seguir podem ajudá-lo a começar. O primeiro passo será construir o aplicativo em seu computador, permitindo que você brinque com suas alterações. Depois, você pode verificar a documentação fornecida sobre como realizar as respectivas tarefas. A seção subsequente mostrará como enviar suas alterações.
Se você estiver planejando uma alteração ou adição um pouco maior ao aplicativo, geralmente é uma boa ideia consultar os mantenedores do aplicativo para saber se essa alteração seria aceita. Para isso, você deve primeiro se convencer de que pode realizar a tarefa em questão executando as primeiras etapas de implementação e, em seguida, verificar com os mantenedores por meio do rastreador de problemas. Essa também é uma boa forma de verificar se o projeto possui um mantenedor ativo que possa aceitar sua contribuição. Apesar dos nossos melhores esforços, nem todos os projetos são sempre mantidos continuamente.
Observe que, embora muitos membros da comunidade fiquem felizes em ajudá-lo quando você estiver empacado, os mantenedores muitas vezes podem não ter os recursos para orientá-lo em uma contribuição.
Se você estiver sobrecarregado ao trabalhar em um aplicativo GNOME existente, você também pode primeiro considerar criar seu próprio aplicativo para fins de aprendizado.
Ao fazer alterações em um aplicativo, você geralmente desejará compilar e testar o aplicativo com suas alterações no seu computador. Para a maioria dos aplicativos, esse processo pode ser bastante simplificado usando o aplicativo Builder.
Após iniciar o Builder, você pode optar por clonar um projeto. Isso fará o download do aplicativo para o seu computador.
Você deve inserir o local do repositório. A URL correta pode ser copiada abaixo.
Dependendo da sua conexão com a Internet e do tamanho do projeto, a clonagem do projeto pode demorar um pouco. Depois que o Builder concluir esta etapa, a janela do projeto deverá abrir. Talvez seja necessário confirmar a instalação de algumas dependências necessárias. Para testar se você consegue construir e iniciar o aplicativo com êxito, agora você pode pressionar o botão “Executar projeto”.
Se tudo der certo, o aplicativo deverá ser compilado. Após a conclusão da compilação, o aplicativo criado deverá iniciar automaticamente.
Este aplicativo foi desenvolvido com a linguagem de programação C.
Para começar a desenvolver aplicativos do GNOME com C, recomendamos este tutorial para iniciantes que também aborda a linguagem C. Você pode encontrar outros recursos importantes abaixo.
Depois de fazer alterações em um projeto, você poderá enviá-las para revisão. Nosso objetivo é criar o que é chamado de merge request (ou solicitação de mesclagem) ou pull request (ou solicitações pull). Isso significa sugerir uma mudança no código e nos dados do projeto.
Começamos com alguns preparativos em GitLab do GNOME, onde o projeto está hospedado. Esse processo pode parecer bastante complicado se você estiver passando por ele pela primeira vez, mas você se acostumará muito mais com o tempo.
A primeira etapa é criar uma nova conta GitLab do GNOME caso você ainda não possua uma. Você só precisa usar o formulário web do link para isso.
A seguir, queremos que o git no seu computador também possa usar sua conta GitLab do GNOME. Para isso, você precisa de uma chave SSH. Se você ainda não tem uma chave SSH, você pode gerar uma nova usando o Console. Como alternativa, você pode gerar uma usando o aplicativo Senhas e chaves.
Agora você precisa adicionar sua chave SSH pública à configuração “SSH Keys” em GitLab do GNOME. As chaves SSH públicas são armazenadas na pasta .ssh em seu diretório inicial (“home”) como arquivos com a terminação .pub. Você pode imprimir todas as suas chaves SSH públicas através do comando cat ~/.ssh/*.pub. Você também pode visualizar as chaves SSH públicas usando o aplicativo Senhas e chaves.
Para sugerir alterações em um projeto, primeiro você precisa criar sua própria cópia do projeto em GitLab do GNOME. A criação desta cópia também é conhecida como forking (bifurcação, como também é conhecido). Você precisará de sua própria cópia – ou fazer fork – do projeto para carregar suas alterações nesta cópia.
Primeiro, você pode fazer um fork de Ficheiros por meio da página GitLab do GNOME. Você só precisa faer isso uma vez para cada projeto no qual você trabalha.
Agora, precisamos informar ao git do seu projeto local sobre sua cópia pessoal em GitLab do GNOME por meio desta URL. Para isso precisamos voltar à linha de comando. Primeiro, você deve mudar (cd) para o diretório do projeto em que está trabalhando. Depois você pode usar o comando
$ git remote add my-copy <ssh-fork-url>
onde <ssh-fork-url> deve ser substituído pela URL SSH que você consultou na etapa anterior.
Chegamos agora às tarefas mais regulares ao trabalhar com git.
Primeiro, queremos mudar para o que chamamos de branch (ou ramo, ou ramificação) diferente. Branches são variantes do código original onde você pode, por exemplo, desenvolver um recurso, até que ela esteja pronta para entrar no código realmente utilizado. Para fazer isso você pode executar
$ git checkout -b my-changes
onde my-changes é uma breve descrição do que você está fazendo, sem espaços.
A seguir, queremos salvar as alterações feitas com o git. Isso geralmente é chamado de criação de um commit. Você pode fazer isso com o comando
$ git commit -am "Commit Message"
As mensagens de commit devem descrever suas alterações. Você pode aprender mais sobre escolher uma mensagem de commit adequada.
Agora, temos que colocar no GitLab as suas alterações salvas. Felizmente, já fizemos toda a configuração usando git remote add na seção anterior. Tudo o que resta a fazer agora é executar
$ git push my-copy
Finalmente estamos na última etapa. Se você verificar a saída no Console após nosso comando git push anterior, provavelmente já verá um link de site mostrando como criar uma pull ou merge request. Você pode abri-lo pressionando a tecla Ctrl enquanto clica nele. Só falta seguir o site para finalizar o envio das alterações.