Sincronização com o GitHub
Conecte o GitHub com um código de dispositivo ou um token, publique um projeto como repositório novo ou existente, envie e receba entre máquinas, e saiba como o seu token é protegido.
A sincronização com o GitHub é um backup opcional fora da máquina e uma transferência de trabalho entre computadores, construída sobre o repositório Git real que cada projeto já é. Os commits locais funcionam sem GitHub. Quando você conecta, ainda não há uma conta do Oleafly no caminho: apenas o seu GitHub.
Conectando a sua conta
Seção intitulada “Conectando a sua conta”Configurações, Integrações, GitHub, e então um dos caminhos:
- Conectar o GitHub (recomendado): um fluxo de código de dispositivo. O Oleafly mostra um código curto, o seu navegador abre
github.com/login/device(com um botão Copiar para o código), você aprova, e o aplicativo detecta em segundos. A conexão pede apenas os escoposrepoeread:user. - Token de acesso pessoal: expanda “Avançado: usar um token de acesso pessoal” e cole um PAT se você preferir criar as suas próprias credenciais.
Depois de conectado, o seu avatar e o seu nome de usuário aparecem nas Configurações e no menu do GitHub da barra de ferramentas superior. Desconectar esquece o token.
Como o seu token é protegido
Seção intitulada “Como o seu token é protegido”O token é guardado em um arquivo local criptografado com AES-256-GCM e restrito ao seu dono, e nunca é entregue à camada de interface do aplicativo; a interface só fica sabendo que você está “conectado como @você”. Quando o Git precisa se autenticar, o token é injetado por um auxiliar de credenciais em memória, então ele nunca aparece em uma linha de comando, no .git/config ou no histórico do seu shell. Versões mais antigas que embutiam tokens nas URLs dos remotos são limpas automaticamente na inicialização.
Publicando um projeto
Seção intitulada “Publicando um projeto”No painel de Controle de versão, clique em Publicar no GitHub:
- Criar novo repositório: escolha um nome (pré-preenchido a partir do projeto), deixe Privado (recomendado) marcado ou não, e Criar e enviar. O Oleafly cria o repositório, faz o commit dos arquivos do projeto, conecta o
origine envia. - Vincular a um existente: escolha em uma lista com busca dos seus repositórios (os privados mostram um cadeado) e Vincular e enviar.
Depois de publicar, o menu do GitHub na barra de ferramentas oferece Abrir no GitHub e Copiar o link do repositório.
Arquivos que parecem segredos ficam locais
Seção intitulada “Arquivos que parecem segredos ficam locais”A publicação nunca faz commit de arquivos que normalmente guardam chaves ou senhas, como .env, *.pem, chaves privadas SSH ou credentials.json. Eles ficam na pasta do projeto, sem preparo, e a caixa de diálogo os nomeia. Para publicar um deles mesmo assim, prepare-o e faça o commit você mesmo no Controle de versão. Modelos como .env.example, chaves públicas e arquivos .key do Keynote são publicados como de costume.
Um envio sobe o histórico inteiro. Se um arquivo com um desses nomes já foi commitado, o Oleafly o lista e espera por Cancelar ou Publicar mesmo assim antes de criar qualquer coisa no GitHub.
Sincronização do dia a dia
Seção intitulada “Sincronização do dia a dia”Os botões Enviar e Receber do painel de Controle de versão fazem o que dizem, contra o origin na sua branch atual. Buscar e Sincronizar estão no menu Mais ações do controle de versão, e Commit e envio e Commit e sincronização estão no menu ao lado de Fazer commit. O indicador à frente/atrás (↑ ↓) ao lado da etiqueta da branch avisa quando há algo para enviar ou receber.
Dois computadores
Seção intitulada “Dois computadores”- Na máquina A: publique o projeto, trabalhe, Envie.
- Na máquina B: conecte a mesma conta do GitHub, escolha Importar um projeto → GitHub e selecione o repositório. Veja o guia de importação. A partir daí, Receba, trabalhe, Envie.
- De volta à A: Receba antes de começar. O indicador lembra você.
A cor da capa, a escolha do documento principal e o histórico viajam juntos, porque vivem na própria pasta do projeto.
Mudando de ideia
Seção intitulada “Mudando de ideia”Depois que um remoto é definido, o menu Mais ações do controle de versão ganha dois itens a mais:
- Trocar de repositório reabre a caixa de diálogo de publicação para apontar o
originpara outro lugar. - Desvincular remove o remoto; o projeto local e o histórico dele ficam intocados.
Conflitos e branches
Seção intitulada “Conflitos e branches”Se um recebimento esbarra em um conflito de mesclagem, o Controle de versão lista os arquivos em conflito. Escolha Usar a atual ou Usar a recebida para cada um, ou edite o arquivo e escolha Marcar como resolvido, depois Concluir a mesclagem. Abortar a mesclagem devolve os arquivos ao estado anterior. Enviar e Receber funcionam na branch em que você está, e o menu de branches no topo do painel troca ou cria branches. Veja Git e controle de versão.
Limites, ditos com clareza
Seção intitulada “Limites, ditos com clareza”O Oleafly autentica remotos HTTPS. A publicação configura um corretamente para você.
Se algo falhar
Seção intitulada “Se algo falhar”- “No remote ‘origin’”: publique primeiro; Enviar e Receber precisam de um remoto.
- Envio rejeitado porque o remoto tem commits: receba primeiro e depois envie.
- “No GitHub token set”: conecte em Configurações, Integrações, GitHub.
Mais no FAQ.