Porquê enviar código fonte por link em vez de e-mail?
Um ficheiro pequeno pode caber num e-mail. O código fonte, as imagens e os pacotes de uma aplicação não cabem. O Gmail não aceita anexos com mais de 25 MB e o Outlook não aceita anexos com mais de cerca de 20 MB. O serviço de e-mail também pode rejeitar um arquivo por motivos de segurança se contiver ficheiros executáveis, como .exe ou .js.
Dividir o código por várias mensagens deixa o destinatário com um projeto incompleto. Uma unidade partilhada exige uma conta e acesso contínuo. Um link permite ao destinatário descarregar uma cópia do código durante um período limitado. Não é um espaço para programação colaborativa.
A cópia que o destinatário abre deve conter os ficheiros que selecionou.
| Método | O que acontece | Adequação ao código fonte |
|---|---|---|
| Anexo no Gmail ou Outlook | Não é possível enviar anexos com mais de 20–25 MB | Não adequado |
| Divisão por vários e-mails | A falta de ficheiros impede o projeto de funcionar | Não adequado |
| Unidade partilhada | Exige uma conta e acesso contínuo | Usar com cuidado |
| Alojamento de repositórios | Guarda versões anteriores e revisões de código | Não substitui a entrega |
| Link do SendGB | O código não é compilado nem enviado como anexo | Adequado para a entrega |
O exemplo acima está dentro do limite gratuito: o ZIP da aplicação, as fotos dos produtos, as notas de instalação e um ficheiro de configuração de exemplo vazio. Este exemplo não inclui a pasta de dependências.
Enviar um repositório ou arrastar uma pasta
Um repositório guarda o código e as suas versões anteriores. O Git faz essa gestão. Não disponibilizamos alojamento de repositórios. Não adicionamos novas versões, não guardamos revisões de código nem escrevemos notas de lançamento.
Crie uma cópia. Se não quiser incluir o histórico, crie o arquivo antes de o enviar. No Git, o comando é git archive. Se quiser o histórico num único ficheiro, use git bundle. Não executamos estes comandos. Não clonamos repositórios.
Também pode partilhar uma pasta de código fonte, arrastando-a tal como está. Os nomes das pastas são preservados quando se descarrega a transferência completa. Os ficheiros não são recomprimidos. Clicar num ficheiro individual não recria a pasta. As pastas vazias não são carregadas.
| Como pasta | Num ZIP criado por si | |
|---|---|---|
| Mais indicado para | Poucos ficheiros de código fonte | Muitos ficheiros ou uma entrega num único ficheiro |
| Histórico | Incluído se adicionar .git | Incluído se o adicionar ao arquivo |
| Número de ficheiros | 500, ou 2.500 com o SendGB Extra | Normalmente um ficheiro |
| Instalação | O destinatário faz a instalação | Não abrimos o ZIP |
| O que fazemos | Não compilamos código | Não juntamos arquivos |
O pacote que disponibilizamos para descarregar não é um repositório Git. O destinatário não o pode abrir como repositório. Se precisar de um repositório, prepare o arquivo com a sua própria ferramenta.
O que deve incluir?
O código fonte, por si só, não chega. Também é preciso indicar as versões dos pacotes a instalar. As chaves secretas não devem ser incluídas.
| Ficheiro | Função | Sem ele |
|---|---|---|
| Ficheiros de código fonte | A aplicação em si | Não há nada para instalar |
| Ficheiro de bloqueio | Indica as versões dos pacotes | O destinatário pode instalar uma versão diferente |
| Notas de instalação | Comandos e versões | A instalação passa a ser feita por tentativa e erro |
| Configuração de exemplo | Nomes dos campos com valores vazios | As chaves secretas podem ser enviadas por engano |
| Imagem do produto | Necessária se estiver guardada fora do código fonte | A página abre em branco |
Um ficheiro de bloqueio, como package-lock.json ou composer.lock, indica as versões a instalar. Tem de o incluir. Não instalamos pacotes.
Uma pasta de dependências contém os pacotes prontos a utilizar que o projeto descarregou. node_modules e vendor são exemplos. Na maioria dos projetos, contêm milhares de ficheiros pequenos. O limite gratuito é de 500 ficheiros. Não chega. Remova a pasta. O destinatário instala os pacotes com o comando indicado nas suas notas.
Se o ficheiro .env e as chaves privadas estiverem na pasta, serão enviados ao destinatário. Não os removemos. Inclua um .env.example vazio. Não coloque os valores no link. Envie a palavra-passe separadamente do link. A palavra-passe do ZIP é independente. Também não verificamos as licenças. Não inclua um pacote que não possa ser distribuído legalmente.
Consulte o guia para enviar pastas para saber como a estrutura de pastas é preservada ao descarregar. Consulte o guia para enviar ficheiros ZIP para enviar um repositório em ZIP sem o abrir. Uma cópia de segurança da base de dados não faz parte do código. Envie-a separadamente com a ajuda do guia para enviar cópias de segurança de bases de dados.
5 GB e 500 ficheiros chegam?
O texto do código fonte ocupa muitas vezes pouco espaço. As imagens, as pastas de dependências e anos de histórico aumentam o tamanho e o número de ficheiros. As transferências gratuitas estão limitadas a 5 GB e 500 ficheiros. Se um dos limites for ultrapassado, o ficheiro não pode ser enviado.
Criar outro ZIP do código não reduz muito o tamanho se as imagens incluídas já estiverem comprimidas. O texto simples pode ocupar menos espaço com compressão. A compressão fica a seu cargo. Não abrimos nem recomprimimos o ZIP.
| O que vai enviar | Na prática | Que opção basta |
|---|---|---|
| Código fonte e um ficheiro de bloqueio | Poucos ficheiros, menos de 5 GB | Gratuito; até 90 dias para transferências até 250 MB, 7 dias acima desse tamanho |
| Projeto com imagens | Pode ocupar vários GB | Gratuito se estiver dentro dos limites; caso contrário, SendGB Extra |
| Pasta de dependências, como ficheiros individuais | Milhares de ficheiros pequenos | Atinge o limite de 500 ou 2.500 ficheiros; comprima-a num ZIP ou exclua-a |
Anos de histórico de .git | Muitos ficheiros ou um arquivo grande | SendGB Extra, 500 GB por transferência |
| Um único arquivo com mais de 500 GB | Raro | SendGB Exceed, até 1 TB |
O SendGB Extra está disponível a partir de €29,90 por ano. Inclui 1 TB de armazenamento. O SendGB Extra guarda os ficheiros até 1 ano. O limite por transferência é de 500 GB e 2.500 ficheiros. É adequado para equipas que entregam arquivos grandes com frequência.
O SendGB Exceed não exige uma subscrição. Uma transferência de 1 TB custa €9,99. O código pode ser usado uma vez e é válido durante 1 ano. O link fica disponível durante 7 dias. O limite é de 2.500 ficheiros. Basta para enviar ocasionalmente um único arquivo com mais de 500 GB. Não podemos enviar mais de 1 TB numa única transferência.
Se indicar o seu endereço de e-mail, recebe uma única notificação quando o destinatário começa a descarregar. No envio por e-mail, recebe uma única notificação por destinatário. No envio por link, recebe uma única notificação por transferência. Se a mesma pessoa voltar a descarregar, não é enviado outro e-mail. A notificação não confirma que todo o código tenha sido descarregado, instalado ou colocado em produção.
Como enviar
- 1
Adicione o arquivo
Adicione o ZIP que preparou ou a pasta de código à área de carregamento. Exclua a pasta de dependências e o ficheiro de chaves secretas. O limite gratuito é de 5 GB e 500 ficheiros no total. Se ultrapassar um dos limites, precisa do SendGB Extra ou do SendGB Exceed.
- 2
Envie o link
Envie o link para o endereço de e-mail do destinatário ou copie-o para uma mensagem. Adicione uma palavra-passe se o projeto não for de código aberto. Envie a palavra-passe separadamente do link. Se indicar o seu endereço de e-mail, recebe uma única notificação quando o destinatário começa a descarregar.
- 3
O destinatário descarrega os ficheiros
O destinatário descarrega os ficheiros através do link sem criar uma conta. Não compilamos o código na página. O destinatário abre o ZIP no seu computador e instala os pacotes. As transferências gratuitas até 250 MB ficam disponíveis até 90 dias. As transferências gratuitas com mais de 250 MB ficam disponíveis durante 7 dias. O SendGB Extra guarda os ficheiros até 1 ano.
O que acontece ao seu ficheiro?
- Não alteramos os seus ficheiros. Os arquivos não são abertos, o código não é compilado e os testes não são executados.
- Os ZIP, as pastas e os ficheiros de bloqueio são descarregados tal como estão.
- Os nomes das pastas são preservados quando se descarrega a transferência completa. Os ficheiros não são recomprimidos.
- Se indicar o seu endereço de e-mail, recebe uma única notificação quando alguém começa a descarregar.
O que não fazemos
- Não alojamos repositórios. Não guardamos o histórico, os ramos nem as revisões de código.
- Não instalamos pacotes. Não removemos chaves secretas nem ficheiros .env.
- As transferências gratuitas estão limitadas a 500 ficheiros. O SendGB Extra e o SendGB Exceed permitem até 2.500.
- Uma notificação de que alguém começou a descarregar não significa que o código tenha sido instalado ou colocado em produção.
Perguntas frequentes
O que é um arquivo de código fonte?
É uma cópia de um projeto que outra pessoa pode abrir no seu computador. Um repositório guarda o código e as suas versões anteriores. O Git faz essa gestão. Não alojamos repositórios. Envie o ficheiro ou a pasta. O destinatário descarrega os ficheiros.
O SendGB substitui o GitHub?
Não. Não há histórico de versões, revisão de código nem programação colaborativa. O link permite ao destinatário descarregar uma cópia do código. Não alojamos um repositório ativo.
Posso enviar as pastas node_modules ou vendor?
Sim, se as incluir e estiverem dentro dos limites. Estas pastas contêm pacotes prontos a utilizar. Na maioria dos projetos, contêm milhares de ficheiros pequenos. As transferências gratuitas estão limitadas a 500 ficheiros, e o SendGB Extra e o SendGB Exceed estão limitados a 2.500 ficheiros. Uma pasta que ultrapasse o limite não pode ser incluída na transferência. Remova a pasta de dependências. O ficheiro de bloqueio indica as versões a instalar. Não executamos o comando de instalação.
Posso enviar também o histórico de versões?
Se incluir a pasta .git, o histórico dessa cópia também é enviado. Esta pasta pode conter muitos ficheiros. Se não quiser enviar o histórico, crie o arquivo antes de o enviar. No Git, o comando é git archive. Para enviar o histórico num único ficheiro, use git bundle. Não executamos estes comandos. Não clonamos repositórios.
O ficheiro .env será removido?
Não. Não alteramos chaves secretas, palavras-passe nem ficheiros .env. Se os incluir na pasta, serão enviados ao destinatário. Inclua antes um .env.example vazio. Não coloque os valores reais no link. Envie a palavra-passe separadamente do link. Também não verificamos as licenças.
O destinatário pode ver o código na página?
A página não tem um editor de código. O código não é compilado. Os ZIP não são abertos. É possível abrir uma nota curta em .txt, .md ou .json. O destinatário abre o código no seu computador. Não é preciso criar uma conta para descarregar. O navegador pode apresentar um aviso ao descarregar ficheiros .js ou .exe. Não desativamos esse aviso. Não analisamos o ficheiro.
É obrigatório usar um ZIP?
Não. Também pode enviar uma pasta. Os nomes das pastas são preservados quando se descarrega a transferência completa. Os ficheiros não são recomprimidos. Clicar num ficheiro individual não recria a pasta. Se tiver muitos ficheiros pequenos, um único ZIP é mais seguro. Não juntamos arquivos divididos. Se o ZIP tiver uma palavra-passe própria, continua a ser responsável por essa palavra-passe.
Porque é que o Gmail não aceita o arquivo?
O Gmail não aceita anexos com mais de 25 MB e o Outlook não aceita anexos com mais de cerca de 20 MB. O código fonte, as imagens e os pacotes ultrapassam estes limites. O serviço de e-mail também pode rejeitar um arquivo por conter um ficheiro executável. Um link não é um anexo. Não é necessário instalar um complemento.
Recebo uma notificação quando o destinatário começa a descarregar?
Sim, se indicar o seu endereço de e-mail. No envio por e-mail, recebe uma única notificação por destinatário. No envio por link, recebe uma única notificação por transferência. A notificação indica que o destinatário começou a descarregar. Não confirma que o ficheiro foi descarregado na totalidade. Não significa que o código tenha sido instalado.
De que limite de transferência preciso?
Um arquivo com menos de 5 GB e 500 ficheiros pode ser enviado gratuitamente. As transferências gratuitas até 250 MB ficam disponíveis até 90 dias. As transferências gratuitas com mais de 250 MB ficam disponíveis durante 7 dias. Para enviar volumes maiores, precisa do SendGB Extra: 500 GB por transferência, 2.500 ficheiros, 1 TB de armazenamento, a partir de €29,90 por ano. O SendGB Extra guarda os ficheiros até 1 ano. Para um único arquivo com mais de 500 GB, basta o SendGB Exceed: sem subscrição, 2.500 ficheiros e €9,99 por uma transferência de 1 TB. O código pode ser usado uma vez e é válido durante 1 ano. O link fica disponível durante 7 dias. Mais de 1 TB não cabe numa única transferência.
Envie um link para descarregar, não um anexo com código fonte
O código fonte e um ficheiro de bloqueio cabem muitas vezes em 5 GB. As pastas de dependências e anos de histórico podem ultrapassar o limite de ficheiros. O SendGB Extra permite enviar arquivos maiores, até 500 GB, e o SendGB Exceed permite enviar até 1 TB numa única transferência.
Começar a enviar