Contributing to AppCleaner

Ajude-nos a adicionar novos programas ao AppCleaner

O AppCleaner permite adicionar novos programas e sobrescrever aqueles que já vêm integrados. O processo de limpeza é controlado por um arquivo de configuração.

Acessando o arquivo de configuração

Você pode visualizar o arquivo de configuração embutido chamando o Cleaner.Win.exe com o parâmetro de linha de comando -x. Isso produzirá um arquivo chamado Tasks.conf no diretório de trabalho atual.

• Para sobrescrever as definições embutidas: modifique o Tasks.conf e coloque-o na mesma pasta que o Cleaner.Win.exe
• Para adicionar às definições embutidas: crie um arquivo chamado Tasks.add.conf na mesma pasta que o Cleaner.Win.exe

Hierarquia de configuração

O AppCleaner se baseia em três conceitos organizados hierarquicamente (de cima para baixo):

1. Áreas de tarefas (Task Areas): Representadas pelas abas como "Apps", "Browsers" e "Registry"
2. Grupos de tarefas (Task Groups): Dentro de uma área de tarefas, há vários grupos, como o grupo "Multimedia" dentro da área "Apps"
3. Tarefas (Tasks): Os blocos de construção de baixo nível que contêm as definições para um único programa, por exemplo, "Paint.NET"

O formato de arquivo .conf

O formato de arquivo .conf contém texto em UTF-8 semelhante a JSON. Aqui está um exemplo:

Apps: {
    Applications: {
        .NET Reflector: {
            DetectPattern: "%LocalAppData%Red Gate.NET Reflector 6Reflector.cfg"
            Default: false
            FilePattern: [
                "%LocalAppData%Red Gate.NET Reflector 6Cache***"
                "%LocalAppData%Red Gate.NET Reflector 6Reflector.cfg"
            ]
        }
    }
}

Tipos básicos

• Object: Vários pares chave‑valor entre chaves. As chaves são strings que podem omitir as aspas. Se a chave contiver dois pontos, as aspas devem estar presentes. Os pares chave‑valor individuais são separados por espaço em branco
• Array: Vários valores entre colchetes. Os valores individuais são separados por espaço em branco
• Boolean: true e false
• String: Vários caracteres entre aspas duplas. Se o caractere de aspa aparecer dentro de uma string, ele deve ser codificado como duas aspas em sequência

Chaves de definição de tarefa

No exemplo acima, "Apps" é a área de tarefas, "Applications" é o grupo de tarefas e ".NET Reflector" é o nome da tarefa. As seguintes chaves podem ser usadas para definir uma tarefa:

DetectPattern

Avaliada na inicialização para determinar se essa tarefa é exibida na GUI. Esse teste deve retornar um resultado se, e somente se, o programa estiver instalado no computador. O valor contém um padrão de arquivo que identifica arquivos que, quando presentes, indicam que o programa está instalado. O padrão pode ser um glob e pode conter IDs de pastas conhecidas, como %LocalAppData%. Pode ser definido no nível do grupo de tarefas para evitar repetição.

Detect

Semelhante ao DetectPattern, mas identifica uma chave ou valor de registro que deve existir quando o programa está instalado. A chave e o valor do registro são separados pelo símbolo pipe (|). Também pode aparecer no nível do grupo de tarefas.

DetectOS

Mostra a tarefa somente se o sistema operacional tiver a versão especificada. É um valor string que inclui a versão opcionalmente prefixada por um operador booleano como >. Se nenhum operador for informado, o padrão é >=. Por exemplo, "6.0" indica Windows Vista ou superior, enquanto "<6.0" indica Windows XP ou anterior.

FilePattern

Pode ser um array de strings ou uma única string. Determina quais arquivos devem ser excluídos. Pode conter os mesmos padrões que DetectPattern.

IgnoreFiles

Padrão glob que representa os arquivos a serem ignorados. Isso é útil quando você quer deletar todos os arquivos de uma pasta, mas manter apenas alguns arquivos. Pode ser um único valor ou um array.

RegKey

Pode ser um array ou um único valor. Determina as chaves e valores de registro que devem ser excluídos. Não oferece suporte a padrões. A chave e o valor do registro são separados pelo símbolo pipe.

Default

true ou false (o padrão é false se não for informado). Determina se a tarefa vem marcada por padrão.

Regex

Permite substituir ou remover conteúdo de arquivos. O valor é um objeto que contém 3 pares chave‑valor: File, Pattern, Replacement.

SQLite

Permite executar queries em bancos de dados SQLite. O valor é um objeto com 2 pares chave‑valor: db e sql.

Se você criou uma definição para um aplicativo público e quiser compartilhá-la, envie-a para nós em support@updatestar.com e nós iremos considerá-la para inclusão na próxima versão do AppCleaner. Obrigado!