Guia

Conecte seu Cloud Provider

Com a sincronização, suas notas em Markdown e seus PDFs ficam na sua conta do Cloud Provider e em uma pasta deste computador, sempre em sintonia. Quando duas versões entram em conflito, as duas são mantidas.

O modo local não precisa de conta alguma. Se você quer apenas seus arquivos neste computador, escolha Só pasta local e pode pular o resto desta página.

Os cinco passos em 16 segundos. Desenhos simplificados, não gravações de tela. (legendas em inglês)

Escolha um modo

Cada computador escolhe o próprio modo em Configurações > Esta máquina e o vault, então um computador pode sincronizar enquanto outro continua local.

Tudo na nuvem

Notas e PDFs ficam na sua conta do Cloud Provider. O KeepGlide lê e grava tudo lá e guarda neste computador um cache de leitura e, para PDFs, as edições ainda não enviadas. Este modo precisa da conexão com o Cloud Provider.

Sincronizar numa pasta local

Os arquivos ficam em uma pasta deste computador e na sua conta do Cloud Provider, e as mudanças são levadas de um lado para o outro. Mudanças feitas sem conexão ficam neste computador e são enviadas quando a conexão voltar.

Só pasta local

Os arquivos ficam neste computador. Sem conta, sem rede e sem configuração do Cloud Provider.

A configuração inicial oferece as mesmas três opções com os nomes Só pasta local, Cloud Provider e Pasta local e Cloud Provider.

Antes de começar

O KeepGlide roda no seu computador e não tem servidor próprio. Suas notas falam apenas com a sua conta do Cloud Provider, por isso o KeepGlide pede que você crie uma conexão própria, uma única vez, no console de desenvolvedor do Cloud Provider.

Crie ali um cliente do tipo App para computador (Desktop app) e baixe o arquivo JSON dele. Os nomes e as posições no console podem mudar; procure estes rótulos, que podem aparecer em inglês conforme o idioma da sua conta.

  1. Crie um projeto, por exemplo com o nome KeepGlide, e confirme que ele está selecionado.
  2. Ative a API de arquivos desse projeto com Ativar. Isso liga a API; sozinha, ela não dá acesso aos seus arquivos.
  3. Configure a tela de consentimento: um nome para o app, um e-mail de suporte e o público Externo para uma conta pessoal.
  4. Em Acesso a dados, adicione a permissão de arquivos do Cloud Provider que o KeepGlide solicita, e salve. O KeepGlide não pede acesso ao e-mail.
  5. Para uso pessoal contínuo, selecione Publicar app e confirme Em produção. Veja Solução de problemas para entender o motivo.
  6. Em Clientes, selecione Criar cliente, escolha App para computador e baixe o arquivo JSON quando ele for criado. Mantenha-o privado. Clientes de aplicativo da Web são recusados.

Conecte em cinco passos

As ilustrações mostram a versão das Configurações. A configuração inicial faz as mesmas perguntas, com os próprios botões.

  1. Importar o JSON do cliente

    Em Configurações, na seção do Cloud Provider, selecione Importar JSON do cliente e escolha o arquivo do App para computador que você baixou. Na configuração inicial, o botão se chama Importar JSON. Importar ainda não conecta a sua conta.

    Desenho simplificado, não é uma captura de tela.

  2. Conectar o Cloud Provider

    Selecione Conectar o Cloud Provider. A autorização abre no navegador padrão, e o KeepGlide espera aqui: Conclua a autorização no navegador e volte a esta janela.

    Se aparecer um aviso, confira o nome e as permissões do seu próprio projeto antes de continuar.

    Desenho simplificado, não é uma captura de tela.

  3. Permitir o acesso no navegador

    Escolha a conta cujos arquivos do Cloud Provider guardam o seu vault. Se o navegador mostrar que o app não foi verificado, continue somente se o projeto for o que você criou; publicar o seu próprio projeto não remove esse aviso.

    Revise a permissão de acesso aos arquivos do Cloud Provider e permita. Depois, o navegador volta para o KeepGlide.

    Desenho simplificado, não é uma captura de tela.

  4. Testar a conexão

    De volta ao KeepGlide, selecione Testar conexão. Quando o teste passar, você verá Conexão testada. O Cloud Provider está pronto.

    Se a permissão não tiver sido concedida, o KeepGlide avisa e oferece Reconectar e permitir o Cloud Provider.

    Desenho simplificado, não é uma captura de tela.

  5. Escolher a pasta no Cloud Provider

    Selecione Escolher pasta no Cloud Provider e escolha a pasta do vault no seletor. Na configuração inicial, este botão fica indisponível até o teste passar.

    Desenho simplificado, não é uma captura de tela.

O que o KeepGlide pode acessar

O KeepGlide pede apenas acesso aos arquivos do Cloud Provider. Ele nunca pede acesso à sua caixa de e-mail. Sua senha do Cloud Provider nunca passa pelo KeepGlide: você entra na própria página do Cloud Provider.

Acesso total (padrão)

O KeepGlide pode ver todos os seus arquivos do Cloud Provider, então o seletor de pastas consegue listar as pastas que você já tem.

Acesso restrito (opcional)

O KeepGlide vê somente os arquivos que ele cria ou abre. A troca: o seletor de pastas deixa de listar pastas que o app não usou. Ao mudar o nível de acesso nas Configurações, o app pede que você permita o acesso de novo.

A autorização salva fica neste computador. Desconectar a remove.

Trabalhar offline

O comportamento do KeepGlide sem conexão depende do modo escolhido.

Tudo na nuvem

Leituras e gravações vão direto para o Cloud Provider, então este modo precisa da conexão. Este computador mantém um cache de leitura, e as edições de PDF que ainda não foram enviadas aguardam em um cache pendente até o envio ser confirmado.

Sincronizar numa pasta local

Funciona offline. As mudanças esperam numa fila neste computador e são enviadas quando a conexão voltar.

Só pasta local

Não precisa de rede, porque nenhuma conta está envolvida.

Desconectar

Em Configurações, na seção do Cloud Provider, selecione Desconectar. O KeepGlide pede confirmação: Remover o acesso ao Cloud Provider deste app nesta máquina? Quando terminar, ele mostra Desconectado.

Desconectar remove a autorização salva somente nesta máquina. Seus arquivos no Cloud Provider não são apagados. Para revogar o acesso do KeepGlide em todos os lugares, use a página de permissões da sua conta do Cloud Provider.

Desenho simplificado, não é uma captura de tela.

Solução de problemas

A conexão deixa de funcionar após 7 dias

Contas no modo de teste (Testing) recebem tokens que expiram em sete dias. Para uso pessoal contínuo, publique seu app no console de desenvolvedor (Publicar app, depois Em produção) e selecione Reconectar e permitir o Cloud Provider para obter uma nova autorização. Publicar evita a expiração do modo de teste, mas não garante tokens permanentes e não verifica o app, então o aviso ainda pode aparecer.

O KeepGlide diz que a permissão não foi concedida

Voltar ao KeepGlide sem a permissão de acesso ao Cloud Provider deixa a conexão incompleta. Selecione Reconectar e permitir o Cloud Provider, permita o acesso no navegador e depois execute Testar conexão de novo.

O KeepGlide recusa meu arquivo de cliente

O KeepGlide aceita somente clientes do tipo App para computador; um cliente de aplicativo da Web é recusado. Crie um cliente do tipo App para computador no console de desenvolvedor, baixe o JSON quando ele for criado e importe esse arquivo. Se o arquivo baixado não tiver segredo, crie um novo cliente App para computador e baixe esse.

O teste de conexão falha

Verifique se a API de arquivos está ativada no projeto que contém o seu cliente e se este computador está online. Depois, execute Testar conexão de novo.