Se um atalho do Mac sempre lê o mesmo arquivo, um caminho digitado em uma ação pode falhar quando esse arquivo for movido ou tiver um nome diferente em outro Mac. Em vez disso, passe o arquivo para o atalho durante a execução: aceite um arquivo do menu Compartilhar de outro app e conecte essa entrada à ação que precisa dele. Este guia mostra como configurar esse fluxo de trabalho e quando uma solicitação é ou não a alternativa correta.

Escolha como o atalho deve receber o arquivo

Use a entrada do atalho quando puder selecionar o arquivo no Finder ou em outro app toda vez que executar o atalho. No Atalhos, ative a execução do atalho a partir de outro app e, em seguida, defina o tipo de entrada aceito como Arquivos. A Apple define Arquivos de forma ampla, incluindo documentos, imagens, PDFs, arquivos ZIP e muito mais. O app receptor passa o item compartilhado para a primeira ação do atalho. Understanding input types in Shortcuts on Mac

Por exemplo, um atalho que processa um documento pode começar com o arquivo recebido e continuar em uma ação que extrai texto, o renomeia ou o manipula de outra forma. O segredo é usar o item recebido como entrada da ação seguinte, em vez de inserir um local fixo em uma ação como Obter Arquivo. A Apple descreve as conexões de ação como o fluxo que transporta a saída de uma ação para a ação seguinte. Action connections in Shortcuts on Mac

Escolha Pedir Entrada somente quando o usuário precisar digitar um valor no momento da execução. A Apple a documenta para palavras, datas e números; não se trata de um seletor de arquivos. Para escolher um arquivo interativamente, use a entrada de arquivo do atalho a partir de outro app ou procure por uma ação de seleção de arquivo disponível no fluxo de trabalho específico do seu atalho. Não coloque um caminho de arquivo em uma solicitação de texto esperando que o Atalhos transforme esse texto em um arquivo selecionado automaticamente. Use the Ask for Input action in a shortcut on Mac

Configure a entrada de arquivo no Atalhos

  1. Abra o Atalhos no seu Mac, crie ou abra o atalho e clique no botão Detalhes no editor. Ative Usar como Ação Rápida ou a opção disponível para executar o atalho a partir de outro app. As opções exatas de inicialização podem variar de acordo com a versão do macOS e as configurações do atalho.

  2. No controle de entrada do atalho, clique no tipo aceito no momento, muitas vezes exibido como Qualquer. Selecione Arquivos e desative os tipos dos quais o fluxo de trabalho não precisa. A Apple observa que os limites de entrada controlam quando o atalho aparece nas opções de compartilhamento de um app; um atalho limitado a contatos, por exemplo, não aparecerá ao compartilhar a partir do Mapas. Limit the input for a shortcut when run from another app on Mac

  3. Certifique-se de que a primeira ação que processa o documento use a entrada do atalho. Na ação, clique no campo de entrada e selecione a entrada do atalho recebida ou a Variável Mágica, caso ela já não esteja conectada. Em seguida, mantenha as ações restantes na sequência desse arquivo. Se não tiver certeza se duas ações podem se conectar, clique com a tecla Control pressionada em uma ação e escolha Mostrar Informações para inspecionar seus tipos de entrada e saída aceitos. Action connections in Shortcuts on Mac

  4. No Finder, selecione um arquivo de teste, abra o menu contextual ou o menu Compartilhar e execute o atalho. Quando oferecido, selecione o atalho como uma Ação Rápida. Repita com um arquivo em uma pasta diferente para confirmar que o fluxo de trabalho depende do item selecionado e não de um local específico. Essa é uma verificação prática para o seu próprio atalho, não uma garantia de que todas as ações aceitem todos os formatos de arquivo.

Decida o que acontece quando não há arquivo

Um atalho iniciado a partir do Dock ou de outro local que não forneça nenhum item pode não receber nenhuma entrada inicial. As configurações de entrada da Apple permitem escolher o que acontece nesse caso: parar com uma resposta opcional, pedir um tipo de entrada compatível, obter a área de transferência ou continuar com uma entrada vazia. Para um atalho que processa arquivos, parar com uma mensagem clara é útil se o fluxo de trabalho precisar obrigatoriamente de um arquivo para continuar; prosseguir pode passar um valor vazio para as ações seguintes. Limit the input for a shortcut when run from another app on Mac

Se o atalho deve funcionar tanto a partir do Finder quanto quando iniciado isoladamente, configure o comportamento para quando não houver entrada de forma consciente e teste ambas as formas de inicialização. O uso da área de transferência como alternativa só faz sentido se os usuários forem copiar primeiro o arquivo ou conteúdo desejado. Não presuma que selecionar um arquivo no Finder o disponibiliza para um atalho iniciado separadamente; o atalho deve ser executado por meio de uma via que transmita essa seleção.

Quando um caminho fixo ainda faz sentido

Um caminho fixo pode ser razoável para um atalho que sempre lê um recurso estável em um único Mac, como um modelo local conhecido, e que não deve ser selecionado a cada execução. Para arquivos que as pessoas escolhem a cada execução, a entrada do atalho mantém a seleção fora da configuração da ação, de modo que renomear ou mover um arquivo escolhido não exige a edição de um caminho armazenado. No entanto, isso não torna acessível um arquivo que esteja indisponível: o arquivo ainda precisa existir e poder ser lido, e as ações subsequentes devem oferecer suporte ao seu tipo.

A regra prática é simples: se o usuário escolhe o arquivo, receba-o como entrada do atalho; se o usuário insere texto, use Pedir Entrada; se o atalho usa sempre um único recurso conhecido, um caminho fixo pode ser adequado. Defina o tipo aceito e o comportamento para quando não houver entrada para corresponder à forma como o atalho será de fato iniciado e, em seguida, passe o arquivo recebido pelas ações que o processam.

Fontes