Pular para o conteúdo principal

Instalação pela Web e Deep Links

Você não precisa recriar comandos manualmente para usá-los no seu desktop. Quando você encontra um comando na galeria web da Rephlo, na sua conta ou na sua organização, pode enviá-lo diretamente para o app desktop com um único clique. Isso funciona por meio de um deep link — um link especial app.rephlo:// que as páginas web repassam para o app instalado.

Esta página explica como funcionam os links de instalação, o que a prévia de instalação mostra e como a Rephlo lida com a instalação de vários comandos de uma vez.

Como funciona uma instalação pela web​

Quando você clica em Install em uma página web, o navegador abre um link app.rephlo://. Seu sistema operacional reconhece que esse link pertence à Rephlo e o repassa para o app desktop. A Rephlo então busca os detalhes do comando, mostra uma prévia e adiciona os comandos que você confirmar.

Pré-requisitos​

Para que uma instalação pela web funcione:

  • O app desktop da Rephlo precisa estar instalado no seu computador.
  • O manipulador do link app.rephlo:// precisa estar registrado no seu sistema operacional. A Rephlo faz esse registro automaticamente na primeira execução (no Windows, ela adiciona uma entrada por usuário que não requer privilégios de administrador).
  • Você precisa estar conectado para qualquer comando privado à sua conta ou organização — comandos públicos da galeria não exigem login.

A Rephlo entende vários tipos de links de instalação, dependendo de onde o comando vem:

Tipo de linkDe onde vem
Gallery installUm único comando público, aberto pelo seu slug ou ID na galeria.
Web installUm ou mais comandos públicos referenciados por ID.
My (private) installComandos privados da sua própria conta.
Org installComandos compartilhados dentro da sua organização (workspace), restritos a essa organização.

Um link de instalação gallery instala um único comando (um slug ou ID). Os links de instalação web, private e org suportam instalações em lote — o link pode carregar uma lista de IDs separada por vírgulas, e a Rephlo remove duplicatas automaticamente.

A prévia de instalação​

Antes que qualquer coisa seja adicionada ao seu app, a Rephlo mostra uma prévia de instalação para que você mantenha o controle. A prévia lista cada comando presente no link com:

  • Seu nome, grupo, autor e idioma.
  • Uma caixa de seleção para incluir ou excluir o comando desta instalação.
  • Um indicador claro caso um comando já esteja instalado — esses vêm desmarcados por padrão para que você não crie duplicatas por acidente.

Na prévia você pode:

  • Selecionar todos ou desmarcar todos os comandos ainda não instalados.
  • Opcionalmente escolher uma substituição de grupo (group override) para que os comandos recebidos entrem em um grupo escolhido por você, em vez de seu grupo original.
  • Confirmar com o botão Install, que mostra quantos comandos estão selecionados. O botão permanece desabilitado até que pelo menos um comando esteja selecionado.

O prompt de deep link "Open in Rephlo" confirmando a instalação de um comando a partir da web A caixa de diálogo de prévia de instalação: uma lista de verificação dos comandos recebidos (nome, grupo, autor, idioma), selos "already installed", controles Select All / Deselect All, um menu opcional de substituição de grupo e um botão Install rotulado com a contagem selecionada.

Instalando vários comandos de uma vez (instalação em lote)​

Quando um link contém vários comandos, a Rephlo instala todos os que você mantiver marcados em uma única etapa. Como parte disso, ela:

  • Detecta conflitos sinalizando comandos que você já possui, para que você possa ignorá-los.
  • Resolve ou cria grupos — se um comando recebido pertence a um grupo que você já tem (correspondido pelo nome), ele entra nesse grupo; caso contrário, a Rephlo cria o grupo para você. Uma substituição de grupo, se definida, tem prioridade.
  • Limpa a instrução de comandos no estilo combinação (combination) e adiciona a orientação padrão da Rephlo de "gerar apenas texto pronto para uso", para que os comandos instalados se comportem de forma consistente.

Os comandos instalados chegam marcados como New, para que sejam fáceis de identificar na sua biblioteca, prontos para editar ou executar.

Se algo der errado​

  • App não instalado — o link não consegue abrir a Rephlo. Instale primeiro o app desktop em rephlo.app/download e clique no link novamente.
  • Não conectado — comandos privados e de organização exigem login. Faça login e tente novamente. Veja Login e Autenticação.
  • Link inválido ou expirado — se os IDs dos comandos não forem encontrados, nada é instalado e você pode tentar novamente com segurança a partir da página web.

Páginas relacionadas​